Class: Google::Apis::DriveV2::Permission

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

Overview

A permission for a file.

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



3046
3047
3048
# File 'generated/google/apis/drive_v2/classes.rb', line 3046

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

Instance Attribute Details

#additional_rolesArray<String>

Additional roles for this user. Only commenter is currently allowed, though more may be supported in the future. Corresponds to the JSON property additionalRoles

Returns:

  • (Array<String>)


2930
2931
2932
# File 'generated/google/apis/drive_v2/classes.rb', line 2930

def additional_roles
  @additional_roles
end

#auth_keyString

Deprecated. Corresponds to the JSON property authKey

Returns:

  • (String)


2935
2936
2937
# File 'generated/google/apis/drive_v2/classes.rb', line 2935

def auth_key
  @auth_key
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)


2941
2942
2943
# File 'generated/google/apis/drive_v2/classes.rb', line 2941

def deleted
  @deleted
end

#domainString

The domain name of the entity this permission refers to. This is an output- only field which is present when the permission type is user, group or domain. Corresponds to the JSON property domain

Returns:

  • (String)


2948
2949
2950
# File 'generated/google/apis/drive_v2/classes.rb', line 2948

def domain
  @domain
end

#email_addressString

The email address of the user or group this permission refers to. This is an output-only field which is present when the permission type is user or group. Corresponds to the JSON property emailAddress

Returns:

  • (String)


2954
2955
2956
# File 'generated/google/apis/drive_v2/classes.rb', line 2954

def email_address
  @email_address
end

#etagString

The ETag of the permission. Corresponds to the JSON property etag

Returns:

  • (String)


2959
2960
2961
# File 'generated/google/apis/drive_v2/classes.rb', line 2959

def etag
  @etag
end

#expiration_dateDateTime

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

  • They can only be set on user and group permissions
  • The date must be in the future
  • The date cannot be more than a year in the future
  • The date can only be set on drive.permissions.update or drive.permissions. patch requests Corresponds to the JSON property expirationDate

Returns:

  • (DateTime)


2970
2971
2972
# File 'generated/google/apis/drive_v2/classes.rb', line 2970

def expiration_date
  @expiration_date
end

#idString

The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions. insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored. Corresponds to the JSON property id

Returns:

  • (String)


2978
2979
2980
# File 'generated/google/apis/drive_v2/classes.rb', line 2978

def id
  @id
end

#kindString

This is always drive#permission. Corresponds to the JSON property kind

Returns:

  • (String)


2983
2984
2985
# File 'generated/google/apis/drive_v2/classes.rb', line 2983

def kind
  @kind
end

#nameString

The name for this permission. Corresponds to the JSON property name

Returns:

  • (String)


2988
2989
2990
# File 'generated/google/apis/drive_v2/classes.rb', line 2988

def name
  @name
end

#permission_detailsArray<Google::Apis::DriveV2::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



2995
2996
2997
# File 'generated/google/apis/drive_v2/classes.rb', line 2995

def permission_details
  @permission_details
end

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

Returns:

  • (String)


3000
3001
3002
# File 'generated/google/apis/drive_v2/classes.rb', line 3000

def photo_link
  @photo_link
end

#roleString

The primary role for this user. While new values may be supported in the future, the following are currently allowed:

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

Returns:

  • (String)


3011
3012
3013
# File 'generated/google/apis/drive_v2/classes.rb', line 3011

def role
  @role
end

A link back to this permission. Corresponds to the JSON property selfLink

Returns:

  • (String)


3016
3017
3018
# File 'generated/google/apis/drive_v2/classes.rb', line 3016

def self_link
  @self_link
end

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

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



3021
3022
3023
# File 'generated/google/apis/drive_v2/classes.rb', line 3021

def team_drive_permission_details
  @team_drive_permission_details
end

#typeString

The account type. Allowed values are:

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

Returns:

  • (String)


3030
3031
3032
# File 'generated/google/apis/drive_v2/classes.rb', line 3030

def type
  @type
end

#valueString

The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored. Corresponds to the JSON property value

Returns:

  • (String)


3038
3039
3040
# File 'generated/google/apis/drive_v2/classes.rb', line 3038

def value
  @value
end

Whether the link is required for this permission. Corresponds to the JSON property withLink

Returns:

  • (Boolean)


3043
3044
3045
# File 'generated/google/apis/drive_v2/classes.rb', line 3043

def with_link
  @with_link
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
# File 'generated/google/apis/drive_v2/classes.rb', line 3051

def update!(**args)
  @additional_roles = args[:additional_roles] if args.key?(:additional_roles)
  @auth_key = args[:auth_key] if args.key?(:auth_key)
  @deleted = args[:deleted] if args.key?(:deleted)
  @domain = args[:domain] if args.key?(:domain)
  @email_address = args[:email_address] if args.key?(:email_address)
  @etag = args[:etag] if args.key?(:etag)
  @expiration_date = args[:expiration_date] if args.key?(:expiration_date)
  @id = args[:id] if args.key?(:id)
  @kind = args[:kind] if args.key?(:kind)
  @name = args[:name] if args.key?(:name)
  @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)
  @self_link = args[:self_link] if args.key?(:self_link)
  @team_drive_permission_details = args[:team_drive_permission_details] if args.key?(:team_drive_permission_details)
  @type = args[:type] if args.key?(:type)
  @value = args[:value] if args.key?(:value)
  @with_link = args[:with_link] if args.key?(:with_link)
end