@@ -3142,12 +3142,14 @@ def update!(**args)
31423142 end
31433143
31443144 # A permission for a file. A permission grants a user, group, domain, or the
3145- # world access to a file or a folder hierarchy. By default, permissions requests
3146- # only return a subset of fields. Permission kind, ID, type, and role are always
3147- # returned. To retrieve specific fields, see https://developers.google.com/
3148- # workspace/drive/api/guides/fields-parameter. Some resource methods (such as `
3149- # permissions.update`) require a `permissionId`. Use the `permissions.list`
3150- # method to retrieve the ID for a file, folder, or shared drive.
3145+ # world access to a file or a folder hierarchy. For more information, see [Share
3146+ # files, folders, and drives](https://developers.google.com/workspace/drive/api/
3147+ # guides/manage-sharing). By default, permission requests only return a subset
3148+ # of fields. Permission `kind`, `ID`, `type`, and `role` are always returned. To
3149+ # retrieve specific fields, see [Return specific fields](https://developers.
3150+ # google.com/workspace/drive/api/guides/fields-parameter). Some resource methods
3151+ # (such as `permissions.update`) require a `permissionId`. Use the `permissions.
3152+ # list` method to retrieve the ID for a file, folder, or shared drive.
31513153 class Permission
31523154 include Google ::Apis ::Core ::Hashable
31533155
@@ -3159,17 +3161,17 @@ class Permission
31593161 alias_method :allow_file_discovery? , :allow_file_discovery
31603162
31613163 # Output only. Whether the account associated with this permission has been
3162- # deleted. This field only pertains to user and group permissions .
3164+ # deleted. This field only pertains to permissions of type ` user` or ` group` .
31633165 # Corresponds to the JSON property `deleted`
31643166 # @return [Boolean]
31653167 attr_accessor :deleted
31663168 alias_method :deleted? , :deleted
31673169
31683170 # Output only. The "pretty" name of the value of the permission. The following
31693171 # is a list of examples for each type of permission: * `user` - User's full name,
3170- # as defined for their Google account , such as "Joe Smith ." * `group` - Name of
3172+ # as defined for their Google Account , such as "Dana A ." * `group` - Name of
31713173 # the Google Group, such as "The Company Administrators." * `domain` - String
3172- # domain name, such as "thecompany .com." * `anyone` - No `displayName` is
3174+ # domain name, such as "cymbalgroup .com." * `anyone` - No `displayName` is
31733175 # present.
31743176 # Corresponds to the JSON property `displayName`
31753177 # @return [String]
@@ -3194,14 +3196,15 @@ class Permission
31943196 attr_accessor :expiration_time
31953197
31963198 # Output only. The ID of this permission. This is a unique identifier for the
3197- # grantee, and is published in User resources as `permissionId`. IDs should be
3199+ # grantee, and is published in the [User resource](https://developers.google.com/
3200+ # workspace/drive/api/reference/rest/v3/User) as `permissionId`. IDs should be
31983201 # treated as opaque values.
31993202 # Corresponds to the JSON property `id`
32003203 # @return [String]
32013204 attr_accessor :id
32023205
3203- # When true, only organizers, owners, and users with permissions added directly
3204- # on the item can access it.
3206+ # When ` true` , only organizers, owners, and users with permissions added
3207+ # directly on the item can access it.
32053208 # Corresponds to the JSON property `inheritedPermissionsDisabled`
32063209 # @return [Boolean]
32073210 attr_accessor :inherited_permissions_disabled
@@ -3214,14 +3217,15 @@ class Permission
32143217 attr_accessor :kind
32153218
32163219 # Whether the account associated with this permission is a pending owner. Only
3217- # populated for `user` type permissions for files that are not in a shared drive.
3220+ # populated for permissions of type `user` for files that aren't in a shared
3221+ # drive.
32183222 # Corresponds to the JSON property `pendingOwner`
32193223 # @return [Boolean]
32203224 attr_accessor :pending_owner
32213225 alias_method :pending_owner? , :pending_owner
32223226
32233227 # Output only. Details of whether the permissions on this item are inherited or
3224- # directly on this item.
3228+ # are directly on this item.
32253229 # Corresponds to the JSON property `permissionDetails`
32263230 # @return [Array<Google::Apis::DriveV3::Permission::PermissionDetail>]
32273231 attr_accessor :permission_details
@@ -3231,9 +3235,10 @@ class Permission
32313235 # @return [String]
32323236 attr_accessor :photo_link
32333237
3234- # The role granted by this permission. While new values may be supported in the
3235- # future, the following are currently allowed: * `owner` * `organizer` * `
3236- # fileOrganizer` * `writer` * `commenter` * `reader`
3238+ # The role granted by this permission. Supported values include: * `owner` * `
3239+ # organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` For more
3240+ # information, see [Roles and permissions](https://developers.google.com/
3241+ # workspace/drive/api/guides/ref-roles).
32373242 # Corresponds to the JSON property `role`
32383243 # @return [String]
32393244 attr_accessor :role
@@ -3243,21 +3248,22 @@ class Permission
32433248 # @return [Array<Google::Apis::DriveV3::Permission::TeamDrivePermissionDetail>]
32443249 attr_accessor :team_drive_permission_details
32453250
3246- # The type of the grantee. Valid values are : * `user` * `group` * `domain ` * `
3247- # anyone` When creating a permission, if `type` is `user` or `group`, you must
3248- # provide an `emailAddress` for the user or group. When `type` is `domain`, you
3249- # must provide a `domain`. There isn't extra information required for an `anyone`
3250- # type .
3251+ # The type of the grantee. Supported values include : * `user` * `group` * `
3252+ # domain` * ` anyone` When creating a permission, if `type` is `user` or `group`,
3253+ # you must provide an `emailAddress` for the user or group. If `type` is `domain`
3254+ # , you must provide a `domain`. If `type` is `anyone`, no extra information is
3255+ # required .
32513256 # Corresponds to the JSON property `type`
32523257 # @return [String]
32533258 attr_accessor :type
32543259
32553260 # Indicates the view for this permission. Only populated for permissions that
3256- # belong to a view. published and metadata are the only supported values. -
3257- # published: The permission's role is published_reader. - metadata: The item is
3258- # only visible to the metadata view because the item has limited access and the
3259- # scope has at least read access to the parent. Note: The metadata view is
3260- # currently only supported on folders.
3261+ # belong to a view. The only supported values are `published` and `metadata`: * `
3262+ # published`: The permission's role is `publishedReader`. * `metadata`: The item
3263+ # is only visible to the `metadata` view because the item has limited access and
3264+ # the scope has at least read access to the parent. The `metadata` view is only
3265+ # supported on folders. For more information, see [Views](https://developers.
3266+ # google.com/workspace/drive/api/guides/ref-roles#views).
32613267 # Corresponds to the JSON property `view`
32623268 # @return [String]
32633269 attr_accessor :view
@@ -3303,15 +3309,16 @@ class PermissionDetail
33033309 # @return [String]
33043310 attr_accessor :inherited_from
33053311
3306- # Output only. The permission type for this user. While new values may be added
3307- # in future, the following are currently possible: * ` file` * `member`
3312+ # Output only. The permission type for this user. Supported values include: * `
3313+ # file` * `member`
33083314 # Corresponds to the JSON property `permissionType`
33093315 # @return [String]
33103316 attr_accessor :permission_type
33113317
3312- # Output only. The primary role for this user. While new values may be added in
3313- # the future, the following are currently possible: * `owner` * `organizer` * `
3314- # fileOrganizer` * `writer` * `commenter` * `reader`
3318+ # Output only. The primary role for this user. Supported values include: * `
3319+ # owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader` For
3320+ # more information, see [Roles and permissions](https://developers.google.com/
3321+ # workspace/drive/api/guides/ref-roles).
33153322 # Corresponds to the JSON property `role`
33163323 # @return [String]
33173324 attr_accessor :role
@@ -3388,8 +3395,8 @@ class PermissionList
33883395 # @return [String]
33893396 attr_accessor :next_page_token
33903397
3391- # The list of permissions. If nextPageToken is populated, then this list may be
3392- # incomplete and an additional page of results should be fetched.
3398+ # The list of permissions. If ` nextPageToken` is populated, then this list may
3399+ # be incomplete and an additional page of results should be fetched.
33933400 # Corresponds to the JSON property `permissions`
33943401 # @return [Array<Google::Apis::DriveV3::Permission>]
33953402 attr_accessor :permissions
0 commit comments