Class: Google::Apis::DriveV3::Permission

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
generated/google/apis/drive_v3/classes.rb,
generated/google/apis/drive_v3/representations.rb,
generated/google/apis/drive_v3/representations.rb

Overview

A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.

Defined Under Namespace

Classes: PermissionDetail, TeamDrivePermissionDetail

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Core::JsonObjectSupport

#to_json

Methods included from Core::Hashable

process_value, #to_h

Constructor Details

#initialize(**args) ⇒ Permission

Returns a new instance of Permission



2028
2029
2030
# File 'generated/google/apis/drive_v3/classes.rb', line 2028

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#allow_file_discoveryBoolean Also known as: allow_file_discovery?

Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type domain or anyone. Corresponds to the JSON property allowFileDiscovery

Returns:

  • (Boolean)


1944
1945
1946
# File 'generated/google/apis/drive_v3/classes.rb', line 1944

def allow_file_discovery
  @allow_file_discovery
end

#deletedBoolean Also known as: deleted?

Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions. Corresponds to the JSON property deleted

Returns:

  • (Boolean)


1951
1952
1953
# File 'generated/google/apis/drive_v3/classes.rb', line 1951

def deleted
  @deleted
end

#display_nameString

A displayable name for users, groups or domains. Corresponds to the JSON property displayName

Returns:

  • (String)


1957
1958
1959
# File 'generated/google/apis/drive_v3/classes.rb', line 1957

def display_name
  @display_name
end

#domainString

The domain to which this permission refers. Corresponds to the JSON property domain

Returns:

  • (String)


1962
1963
1964
# File 'generated/google/apis/drive_v3/classes.rb', line 1962

def domain
  @domain
end

#email_addressString

The email address of the user or group to which this permission refers. Corresponds to the JSON property emailAddress

Returns:

  • (String)


1967
1968
1969
# File 'generated/google/apis/drive_v3/classes.rb', line 1967

def email_address
  @email_address
end

#expiration_timeDateTime

The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:

  • They can only be set on user and group permissions
  • The time must be in the future
  • The time cannot be more than a year in the future Corresponds to the JSON property expirationTime

Returns:

  • (DateTime)


1976
1977
1978
# File 'generated/google/apis/drive_v3/classes.rb', line 1976

def expiration_time
  @expiration_time
end

#idString

The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. Corresponds to the JSON property id

Returns:

  • (String)


1982
1983
1984
# File 'generated/google/apis/drive_v3/classes.rb', line 1982

def id
  @id
end

#kindString

Identifies what kind of resource this is. Value: the fixed string "drive# permission". Corresponds to the JSON property kind

Returns:

  • (String)


1988
1989
1990
# File 'generated/google/apis/drive_v3/classes.rb', line 1988

def kind
  @kind
end

#permission_detailsArray<Google::Apis::DriveV3::Permission::PermissionDetail>

Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items. Corresponds to the JSON property permissionDetails



1995
1996
1997
# File 'generated/google/apis/drive_v3/classes.rb', line 1995

def permission_details
  @permission_details
end

A link to the user's profile photo, if available. Corresponds to the JSON property photoLink

Returns:

  • (String)


2000
2001
2002
# File 'generated/google/apis/drive_v3/classes.rb', line 2000

def photo_link
  @photo_link
end

#roleString

The role granted by this permission. While new values may be supported in the future, the following are currently allowed:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader Corresponds to the JSON property role

Returns:

  • (String)


2012
2013
2014
# File 'generated/google/apis/drive_v3/classes.rb', line 2012

def role
  @role
end

#team_drive_permission_detailsArray<Google::Apis::DriveV3::Permission::TeamDrivePermissionDetail>

Deprecated - use permissionDetails instead. Corresponds to the JSON property teamDrivePermissionDetails



2017
2018
2019
# File 'generated/google/apis/drive_v3/classes.rb', line 2017

def team_drive_permission_details
  @team_drive_permission_details
end

#typeString

The type of the grantee. Valid values are:

  • user
  • group
  • domain
  • anyone Corresponds to the JSON property type

Returns:

  • (String)


2026
2027
2028
# File 'generated/google/apis/drive_v3/classes.rb', line 2026

def type
  @type
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
# File 'generated/google/apis/drive_v3/classes.rb', line 2033

def update!(**args)
  @allow_file_discovery = args[:allow_file_discovery] if args.key?(:allow_file_discovery)
  @deleted = args[:deleted] if args.key?(:deleted)
  @display_name = args[:display_name] if args.key?(:display_name)
  @domain = args[:domain] if args.key?(:domain)
  @email_address = args[:email_address] if args.key?(:email_address)
  @expiration_time = args[:expiration_time] if args.key?(:expiration_time)
  @id = args[:id] if args.key?(:id)
  @kind = args[:kind] if args.key?(:kind)
  @permission_details = args[:permission_details] if args.key?(:permission_details)
  @photo_link = args[:photo_link] if args.key?(:photo_link)
  @role = args[:role] if args.key?(:role)
  @team_drive_permission_details = args[:team_drive_permission_details] if args.key?(:team_drive_permission_details)
  @type = args[:type] if args.key?(:type)
end