google-apis-drive_v3 0.69.0 → 0.70.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f761a941e598963f7408e84fdb613232ca491cc4f887a0531e8be34101f41cd
-  data.tar.gz: a01176fd70b117161701648fe06436d0e84b21b81dab7efeb865b20f68420451
+  metadata.gz: 3662ceee87ae582728046012f01b468700eec7bb11045470145ec6fa887ae262
+  data.tar.gz: d31b9b75bc0ab3d1f1f33d977dcba039646b602400264d273ebe6517e3c5823a
 SHA512:
-  metadata.gz: 9d361dd99259748da7e3a6301a59eeeb1ea54155b07edc6f0bb1497889c85ebb18563b0e5d1fc0f7c79b238281c24fdb45245a880a280a7df02a5b7e136fa408
-  data.tar.gz: dd3758c729d86ccefc4159bc4f759755bca5a5b40163394b4965ba5539b4477319fd3b0f28b80184f52ecf8648df37c588149801da8057e7c9fa209278cc2ccf
+  metadata.gz: 25f2735fcbe4803f57b6683d835d646dabccf0a7238488b40afc7749101b74e7a34049a7d34cc1c269e21d3a1d142aa70127dac9f8d8f8055a2ca4ea3f0dfe50
+  data.tar.gz: f8a0c830f0411fb767036b94477893d5bfc2afc536bdeae9ed72bb9cd9112450d9f88cb9b4cf729591bb134f0f5454a0451aa637caab0c3cf25e2b5b37b40958

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-drive_v3
 
+### v0.70.0 (2025-09-07)
+
+* Regenerated from discovery document revision 20250829
+
 ### v0.69.0 (2025-08-24)
 
 * Regenerated from discovery document revision 20250819

data/lib/google/apis/drive_v3/classes.rb

@@ -1003,8 +1003,8 @@ module Google
         attr_accessor :restricted_for_readers
         alias_method :restricted_for_readers?, :restricted_for_readers
       
-        # Whether download and copy is restricted for writers. If true, download is also
-        # restricted for readers.
+        # Whether download and copy is restricted for writers. If `true`, download is
+        # also restricted for readers.
         # Corresponds to the JSON property `restrictedForWriters`
         # @return [Boolean]
         attr_accessor :restricted_for_writers
@@ -1496,7 +1496,9 @@ module Google
         attr_accessor :app_properties
       
         # Output only. Capabilities the current user has on this file. Each capability
-        # corresponds to a fine-grained action that a user may take.
+        # corresponds to a fine-grained action that a user may take. For more
+        # information, see [Understand file capabilities](https://developers.google.com/
+        # workspace/drive/api/guides/manage-sharing#capabilities).
         # Corresponds to the JSON property `capabilities`
         # @return [Google::Apis::DriveV3::File::Capabilities]
         attr_accessor :capabilities
@@ -1513,7 +1515,7 @@ module Google
         # @return [Array<Google::Apis::DriveV3::ContentRestriction>]
         attr_accessor :content_restrictions
       
-        # Whether the options to copy, print, or download this file, should be disabled
+        # Whether the options to copy, print, or download this file should be disabled
         # for readers and commenters.
         # Corresponds to the JSON property `copyRequiresWriterPermission`
         # @return [Boolean]
@@ -1560,9 +1562,10 @@ module Google
         attr_accessor :file_extension
       
         # The color for a folder or a shortcut to a folder as an RGB hex string. The
-        # supported colors are published in the `folderColorPalette` field of the About
-        # resource. If an unsupported color is specified, the closest color in the
-        # palette is used instead.
+        # supported colors are published in the `folderColorPalette` field of the [`
+        # about`](/workspace/drive/api/reference/rest/v3/about) resource. If an
+        # unsupported color is specified, the closest color in the palette is used
+        # instead.
         # Corresponds to the JSON property `folderColorRgb`
         # @return [String]
         attr_accessor :folder_color_rgb
@@ -1570,8 +1573,8 @@ module Google
         # Output only. The full file extension extracted from the `name` field. May
         # contain multiple concatenated extensions, such as "tar.gz". This is only
         # available for files with binary content in Google Drive. This is automatically
-        # updated when the `name` field changes, however it is not cleared if the new
-        # name does not contain a valid extension.
+        # updated when the `name` field changes, however it's not cleared if the new
+        # name doesn't contain a valid extension.
         # Corresponds to the JSON property `fullFileExtension`
         # @return [String]
         attr_accessor :full_file_extension
@@ -1583,7 +1586,7 @@ module Google
         attr_accessor :has_augmented_permissions
         alias_method :has_augmented_permissions?, :has_augmented_permissions
       
-        # Output only. Whether this file has a thumbnail. This does not indicate whether
+        # Output only. Whether this file has a thumbnail. This doesn't indicate whether
         # the requesting app has access to the thumbnail. To check access, look for the
         # presence of the thumbnailLink field.
         # Corresponds to the JSON property `hasThumbnail`
@@ -1657,7 +1660,8 @@ module Google
         # appropriate value from uploaded content, if no value is provided. The value
         # cannot be changed unless a new revision is uploaded. If a file is created with
         # a Google Doc MIME type, the uploaded content is imported, if possible. The
-        # supported import formats are published in the About resource.
+        # supported import formats are published in the [`about`](/workspace/drive/api/
+        # reference/rest/v3/about) resource.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
@@ -1679,9 +1683,9 @@ module Google
         # @return [DateTime]
         attr_accessor :modified_time
       
-        # The name of the file. This is not necessarily unique within a folder. Note
-        # that for immutable items such as the top level folders of shared drives, My
-        # Drive root folder, and Application Data folder the name is constant.
+        # The name of the file. This isn't necessarily unique within a folder. Note that
+        # for immutable items such as the top-level folders of shared drives, the My
+        # Drive root folder, and the Application Data folder, the name is constant.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1746,14 +1750,14 @@ module Google
         attr_accessor :resource_key
       
         # Output only. The SHA1 checksum associated with this file, if available. This
-        # field is only populated for files with content stored in Google Drive; it is
+        # field is only populated for files with content stored in Google Drive; it's
         # not populated for Docs Editors or shortcut files.
         # Corresponds to the JSON property `sha1Checksum`
         # @return [String]
         attr_accessor :sha1_checksum
       
         # Output only. The SHA256 checksum associated with this file, if available. This
-        # field is only populated for files with content stored in Google Drive; it is
+        # field is only populated for files with content stored in Google Drive; it's
         # not populated for Docs Editors or shortcut files.
         # Corresponds to the JSON property `sha256Checksum`
         # @return [String]
@@ -1784,14 +1788,14 @@ module Google
         # @return [Google::Apis::DriveV3::File::ShortcutDetails]
         attr_accessor :shortcut_details
       
-        # Output only. Size in bytes of blobs and first party editor files. Won't be
-        # populated for files that have no size, like shortcuts and folders.
+        # Output only. Size in bytes of blobs and Google Workspace editor files. Won't
+        # be populated for files that have no size, like shortcuts and folders.
         # Corresponds to the JSON property `size`
         # @return [Fixnum]
         attr_accessor :size
       
         # Output only. The list of spaces which contain the file. The currently
-        # supported values are 'drive', 'appDataFolder' and 'photos'.
+        # supported values are `drive`, `appDataFolder`, and `photos`.
         # Corresponds to the JSON property `spaces`
         # @return [Array<String>]
         attr_accessor :spaces
@@ -1810,9 +1814,9 @@ module Google
         # Output only. A short-lived link to the file's thumbnail, if available.
         # Typically lasts on the order of hours. Not intended for direct usage on web
         # applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.
-        # mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider using a proxy server.
+        # mozilla.org/en-US/docs/Web/HTTP/CORS) policies. Consider using a proxy server.
         # Only populated when the requesting app can access the file's content. If the
-        # file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be
+        # file isn't shared publicly, the URL returned in `files.thumbnailLink` must be
         # fetched using a credentialed request.
         # Corresponds to the JSON property `thumbnailLink`
         # @return [String]
@@ -1964,7 +1968,9 @@ module Google
         end
         
         # Output only. Capabilities the current user has on this file. Each capability
-        # corresponds to a fine-grained action that a user may take.
+        # corresponds to a fine-grained action that a user may take. For more
+        # information, see [Understand file capabilities](https://developers.google.com/
+        # workspace/drive/api/guides/manage-sharing#capabilities).
         class Capabilities
           include Google::Apis::Core::Hashable
         
@@ -1976,15 +1982,15 @@ module Google
           alias_method :can_accept_ownership?, :can_accept_ownership
         
           # Output only. Whether the current user can add children to this folder. This is
-          # always false when the item is not a folder.
+          # always `false` when the item isn't a folder.
           # Corresponds to the JSON property `canAddChildren`
           # @return [Boolean]
           attr_accessor :can_add_children
           alias_method :can_add_children?, :can_add_children
         
           # Output only. Whether the current user can add a folder from another drive (
-          # different shared drive or My Drive) to this folder. This is false when the
-          # item is not a folder. Only populated for items in shared drives.
+          # different shared drive or My Drive) to this folder. This is `false` when the
+          # item isn't a folder. Only populated for items in shared drives.
           # Corresponds to the JSON property `canAddFolderFromAnotherDrive`
           # @return [Boolean]
           attr_accessor :can_add_folder_from_another_drive
@@ -2012,7 +2018,7 @@ module Google
           attr_accessor :can_change_item_download_restriction
           alias_method :can_change_item_download_restriction?, :can_change_item_download_restriction
         
-          # Output only. Whether the current user can change the securityUpdateEnabled
+          # Output only. Whether the current user can change the `securityUpdateEnabled`
           # field on link share metadata.
           # Corresponds to the JSON property `canChangeSecurityUpdateEnabled`
           # @return [Boolean]
@@ -2033,7 +2039,7 @@ module Google
         
           # Output only. Whether the current user can copy this file. For an item in a
           # shared drive, whether the current user can copy non-folder descendants of this
-          # item, or this item itself if it is not a folder.
+          # item, or this item if it's not a folder.
           # Corresponds to the JSON property `canCopy`
           # @return [Boolean]
           attr_accessor :can_copy
@@ -2046,7 +2052,7 @@ module Google
           alias_method :can_delete?, :can_delete
         
           # Output only. Whether the current user can delete children of this folder. This
-          # is false when the item is not a folder. Only populated for items in shared
+          # is `false` when the item isn't a folder. Only populated for items in shared
           # drives.
           # Corresponds to the JSON property `canDeleteChildren`
           # @return [Boolean]
@@ -2080,7 +2086,7 @@ module Google
           alias_method :can_enable_inherited_permissions?, :can_enable_inherited_permissions
         
           # Output only. Whether the current user can list the children of this folder.
-          # This is always false when the item is not a folder.
+          # This is always `false` when the item isn't a folder.
           # Corresponds to the JSON property `canListChildren`
           # @return [Boolean]
           attr_accessor :can_list_children
@@ -2093,7 +2099,7 @@ module Google
           alias_method :can_modify_content?, :can_modify_content
         
           # Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `
-          # canModifyOwnerContentRestriction` or `canRemoveContentRestriction`.
+          # canModifyOwnerContentRestriction`, or `canRemoveContentRestriction`.
           # Corresponds to the JSON property `canModifyContentRestriction`
           # @return [Boolean]
           attr_accessor :can_modify_content_restriction
@@ -2120,7 +2126,7 @@ module Google
           alias_method :can_modify_owner_content_restriction?, :can_modify_owner_content_restriction
         
           # Output only. Whether the current user can move children of this folder outside
-          # of the shared drive. This is false when the item is not a folder. Only
+          # of the shared drive. This is `false` when the item isn't a folder. Only
           # populated for items in shared drives.
           # Corresponds to the JSON property `canMoveChildrenOutOfDrive`
           # @return [Boolean]
@@ -2134,7 +2140,7 @@ module Google
           alias_method :can_move_children_out_of_team_drive?, :can_move_children_out_of_team_drive
         
           # Output only. Whether the current user can move children of this folder within
-          # this drive. This is false when the item is not a folder. Note that a request
+          # this drive. This is `false` when the item isn't a folder. Note that a request
           # to move the child may still fail depending on the current user's access to the
           # child and to the destination folder.
           # Corresponds to the JSON property `canMoveChildrenWithinDrive`
@@ -2156,7 +2162,7 @@ module Google
         
           # Output only. Whether the current user can move this item outside of this drive
           # by changing its parent. Note that a request to change the parent of the item
-          # may still fail depending on the new parent that is being added.
+          # may still fail depending on the new parent that's being added.
           # Corresponds to the JSON property `canMoveItemOutOfDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_out_of_drive
@@ -2170,7 +2176,7 @@ module Google
         
           # Output only. Whether the current user can move this item within this drive.
           # Note that a request to change the parent of the item may still fail depending
-          # on the new parent that is being added and the parent that is being removed.
+          # on the new parent that's being added and the parent that is being removed.
           # Corresponds to the JSON property `canMoveItemWithinDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_within_drive
@@ -2204,7 +2210,7 @@ module Google
         
           # Output only. Whether the current user can read the revisions resource of this
           # file. For a shared drive item, whether revisions of non-folder descendants of
-          # this item, or this item itself if it is not a folder, can be read.
+          # this item, or this item if it's not a folder, can be read.
           # Corresponds to the JSON property `canReadRevisions`
           # @return [Boolean]
           attr_accessor :can_read_revisions
@@ -2217,14 +2223,14 @@ module Google
           alias_method :can_read_team_drive?, :can_read_team_drive
         
           # Output only. Whether the current user can remove children from this folder.
-          # This is always false when the item is not a folder. For a folder in a shared
+          # This is always `false` when the item isn't a folder. For a folder in a shared
           # drive, use `canDeleteChildren` or `canTrashChildren` instead.
           # Corresponds to the JSON property `canRemoveChildren`
           # @return [Boolean]
           attr_accessor :can_remove_children
           alias_method :can_remove_children?, :can_remove_children
         
-          # Output only. Whether there is a content restriction on the file that can be
+          # Output only. Whether there's a content restriction on the file that can be
           # removed by the current user.
           # Corresponds to the JSON property `canRemoveContentRestriction`
           # @return [Boolean]
@@ -2259,7 +2265,7 @@ module Google
           alias_method :can_trash?, :can_trash
         
           # Output only. Whether the current user can trash children of this folder. This
-          # is false when the item is not a folder. Only populated for items in shared
+          # is `false` when the item isn't a folder. Only populated for items in shared
           # drives.
           # Corresponds to the JSON property `canTrashChildren`
           # @return [Boolean]
@@ -2331,7 +2337,7 @@ module Google
           include Google::Apis::Core::Hashable
         
           # Text to be indexed for the file to improve fullText queries. This is limited
-          # to 128KB in length and may contain HTML elements.
+          # to 128 KB in length and may contain HTML elements.
           # Corresponds to the JSON property `indexableText`
           # @return [String]
           attr_accessor :indexable_text
@@ -2357,7 +2363,8 @@ module Google
           class Thumbnail
             include Google::Apis::Core::Hashable
           
-            # The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5).
+            # The thumbnail data encoded with URL-safe Base64 ([RFC 4648 section 5](https://
+            # datatracker.ietf.org/doc/html/rfc4648#section-5)).
             # Corresponds to the JSON property `image`
             # NOTE: Values are automatically base64 encoded/decoded in the client library.
             # @return [String]
@@ -2620,7 +2627,7 @@ module Google
           # @return [String]
           attr_accessor :target_mime_type
         
-          # Output only. The ResourceKey for the target file.
+          # Output only. The `resourceKey` for the target file.
           # Corresponds to the JSON property `targetResourceKey`
           # @return [String]
           attr_accessor :target_resource_key
@@ -2674,7 +2681,7 @@ module Google
       class FileList
         include Google::Apis::Core::Hashable
       
-        # The list of files. If nextPageToken is populated, then this list may be
+        # The list of files. If `nextPageToken` is populated, then this list may be
         # incomplete and an additional page of results should be fetched.
         # Corresponds to the JSON property `files`
         # @return [Array<Google::Apis::DriveV3::File>]
@@ -2682,9 +2689,9 @@ module Google
       
         # Whether the search process was incomplete. If true, then some search results
         # might be missing, since all documents were not searched. This can occur when
-        # searching multiple drives with the 'allDrives' corpora, but all corpora couldn'
+        # searching multiple drives with the `allDrives` corpora, but all corpora couldn'
         # t be searched. When this happens, it's suggested that clients narrow their
-        # query by choosing a different corpus such as 'user' or 'drive'.
+        # query by choosing a different corpus such as `user` or `drive`.
         # Corresponds to the JSON property `incompleteSearch`
         # @return [Boolean]
         attr_accessor :incomplete_search
@@ -2859,7 +2866,7 @@ module Google
         # @return [String]
         attr_accessor :field_id
       
-        # This is always drive#labelFieldModification.
+        # This is always `"drive#labelFieldModification"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2885,8 +2892,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :set_text_values
       
-        # Replaces a `user` field with these new values. The values must be valid email
-        # addresses.
+        # Replaces a `user` field with these new values. The values must be a valid
+        # email addresses.
         # Corresponds to the JSON property `setUserValues`
         # @return [Array<String>]
         attr_accessor :set_user_values
@@ -2918,7 +2925,7 @@ module Google
       class LabelList
         include Google::Apis::Core::Hashable
       
-        # This is always drive#labelList
+        # This is always `"drive#labelList"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2949,9 +2956,9 @@ module Google
         end
       end
       
-      # A modification to a label on a file. A LabelModification can be used to apply
-      # a label to a file, update an existing label on a file, or remove a label from
-      # a file.
+      # A modification to a label on a file. A `LabelModification` can be used to
+      # apply a label to a file, update an existing label on a file, or remove a label
+      # from a file.
       class LabelModification
         include Google::Apis::Core::Hashable
       
@@ -2960,7 +2967,7 @@ module Google
         # @return [Array<Google::Apis::DriveV3::LabelFieldModification>]
         attr_accessor :field_modifications
       
-        # This is always drive#labelModification.
+        # This is always `"drive#labelModification"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3022,7 +3029,7 @@ module Google
       class ModifyLabelsRequest
         include Google::Apis::Core::Hashable
       
-        # This is always drive#modifyLabelsRequest.
+        # This is always `"drive#modifyLabelsRequest"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3043,12 +3050,12 @@ module Google
         end
       end
       
-      # Response to a ModifyLabels request. This contains only those labels which were
-      # added or updated by the request.
+      # Response to a `ModifyLabels` request. This contains only those labels which
+      # were added or updated by the request.
       class ModifyLabelsResponse
         include Google::Apis::Core::Hashable
       
-        # This is always drive#modifyLabelsResponse
+        # This is always `"drive#modifyLabelsResponse"`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind

data/lib/google/apis/drive_v3/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DriveV3
       # Version of the google-apis-drive_v3 gem
-      GEM_VERSION = "0.69.0"
+      GEM_VERSION = "0.70.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250819"
+      REVISION = "20250829"
     end
   end
 end

data/lib/google/apis/drive_v3/service.rb

@@ -966,12 +966,13 @@ module Google
         end
         
         # Creates a copy of a file and applies any requested updates with patch
-        # semantics.
+        # semantics. For more information, see [Create and manage files](https://
+        # developers.google.com/workspace/drive/api/guides/create-file).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::File] file_object
         # @param [Boolean] enforce_single_parent
-        #   Deprecated. Copying files into multiple folders is no longer supported. Use
+        #   Deprecated: Copying files into multiple folders is no longer supported. Use
         #   shortcuts instead.
         # @param [Boolean] ignore_default_visibility
         #   Whether to ignore the domain's default visibility settings for the created
@@ -983,9 +984,9 @@ module Google
         #   the response.
         # @param [String] include_permissions_for_view
         #   Specifies which additional view's permissions to include in the response. Only
-        #   'published' is supported.
+        #   `published` is supported.
         # @param [Boolean] keep_revision_forever
-        #   Whether to set the 'keepForever' field in the new head revision. This is only
+        #   Whether to set the `keepForever` field in the new head revision. This is only
         #   applicable to files with binary content in Google Drive. Only 200 revisions
         #   for the file can be kept forever. If the limit is reached, try deleting pinned
         #   revisions.
@@ -1032,26 +1033,28 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new file. This method supports an */upload* URI and accepts
-        # uploaded media with the following characteristics: - *Maximum file size:* 5,
-        # 120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type,
-        # rather than the literal `*/*` value. The literal `*/*` is only used to
-        # indicate that any valid MIME type can be uploaded. For more information on
-        # uploading files, see [Upload file data](/workspace/drive/api/guides/manage-
-        # uploads). Apps creating shortcuts with `files.create` must specify the MIME
-        # type `application/vnd.google-apps.shortcut`. Apps should specify a file
-        # extension in the `name` property when inserting files with the API. For
-        # example, an operation to insert a JPEG file should specify something like `"
-        # name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-
-        # only `fileExtension` property populated with the extension originally
-        # specified in the `title` property. When a Google Drive user requests to
-        # download a file, or when the file is downloaded through the sync client, Drive
-        # builds a full filename (with extension) based on the title. In cases where the
-        # extension is missing, Drive attempts to determine the extension based on the
-        # file's MIME type.
+        # Creates a file. For more information, see [Create and manage files](/
+        # workspace/drive/api/guides/create-file). This method supports an */upload* URI
+        # and accepts uploaded media with the following characteristics: - *Maximum file
+        # size:* 5,120 GB - *Accepted Media MIME types:* `*/*` (Specify a valid MIME
+        # type, rather than the literal `*/*` value. The literal `*/*` is only used to
+        # indicate that any valid MIME type can be uploaded. For more information, see [
+        # Google Workspace and Google Drive supported MIME types](/workspace/drive/api/
+        # guides/mime-types).) For more information on uploading files, see [Upload file
+        # data](/workspace/drive/api/guides/manage-uploads). Apps creating shortcuts
+        # with the `create` method must specify the MIME type `application/vnd.google-
+        # apps.shortcut`. Apps should specify a file extension in the `name` property
+        # when inserting files with the API. For example, an operation to insert a JPEG
+        # file should specify something like `"name": "cat.jpg"` in the metadata.
+        # Subsequent `GET` requests include the read-only `fileExtension` property
+        # populated with the extension originally specified in the `name` property. When
+        # a Google Drive user requests to download a file, or when the file is
+        # downloaded through the sync client, Drive builds a full filename (with
+        # extension) based on the name. In cases where the extension is missing, Drive
+        # attempts to determine the extension based on the file's MIME type.
         # @param [Google::Apis::DriveV3::File] file_object
         # @param [Boolean] enforce_single_parent
-        #   Deprecated. Creating files in multiple folders is no longer supported.
+        #   Deprecated: Creating files in multiple folders is no longer supported.
         # @param [Boolean] ignore_default_visibility
         #   Whether to ignore the domain's default visibility settings for the created
         #   file. Domain administrators can choose to make all uploaded files visible to
@@ -1062,9 +1065,9 @@ module Google
         #   the response.
         # @param [String] include_permissions_for_view
         #   Specifies which additional view's permissions to include in the response. Only
-        #   'published' is supported.
+        #   `published` is supported.
         # @param [Boolean] keep_revision_forever
-        #   Whether to set the 'keepForever' field in the new head revision. This is only
+        #   Whether to set the `keepForever` field in the new head revision. This is only
         #   applicable to files with binary content in Google Drive. Only 200 revisions
         #   for the file can be kept forever. If the limit is reached, try deleting pinned
         #   revisions.
@@ -1124,14 +1127,15 @@ module Google
         end
         
         # Permanently deletes a file owned by the user without moving it to the trash.
-        # If the file belongs to a shared drive, the user must be an `organizer` on the
-        # parent folder. If the target is a folder, all descendants owned by the user
-        # are also deleted.
+        # For more information, see [Trash or delete files and folders](https://
+        # developers.google.com/workspace/drive/api/guides/delete). If the file belongs
+        # to a shared drive, the user must be an `organizer` on the parent folder. If
+        # the target is a folder, all descendants owned by the user are also deleted.
         # @param [String] file_id
         #   The ID of the file.
         # @param [Boolean] enforce_single_parent
-        #   Deprecated: If an item is not in a shared drive and its last parent is deleted
-        #   but the item itself is not, the item will be placed under its owner's root.
+        #   Deprecated: If an item isn't in a shared drive and its last parent is deleted
+        #   but the item itself isn't, the item will be placed under its owner's root.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1164,16 +1168,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Downloads content of a file. Operations are valid for 24 hours from the time
-        # of creation.
+        # Downloads the content of a file. For more information, see [Download and
+        # export files](https://developers.google.com/workspace/drive/api/guides/manage-
+        # downloads). Operations are valid for 24 hours from the time of creation.
         # @param [String] file_id
         #   Required. The ID of the file to download.
         # @param [String] mime_type
         #   Optional. The MIME type the file should be downloaded as. This field can only
-        #   be set when downloading Google Workspace documents. See [Export MIME types for
-        #   Google Workspace documents](/drive/api/guides/ref-export-formats) for the list
-        #   of supported MIME types. If not set, a Google Workspace document is downloaded
-        #   with a default MIME type. The default MIME type might change in the future.
+        #   be set when downloading Google Workspace documents. For a list of supported
+        #   MIME types, see [Export MIME types for Google Workspace documents](/workspace/
+        #   drive/api/guides/ref-export-formats). If not set, a Google Workspace document
+        #   is downloaded with a default MIME type. The default MIME type might change in
+        #   the future.
         # @param [String] revision_id
         #   Optional. The revision ID of the file to download. This field can only be set
         #   when downloading blob files, Google Docs, and Google Sheets. Returns `
@@ -1208,12 +1214,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Permanently deletes all of the user's trashed files.
+        # Permanently deletes all of the user's trashed files. For more information, see
+        # [Trash or delete files and folders](https://developers.google.com/workspace/
+        # drive/api/guides/delete).
         # @param [String] drive_id
         #   If set, empties the trash of the provided shared drive.
         # @param [Boolean] enforce_single_parent
-        #   Deprecated: If an item is not in a shared drive and its last parent is deleted
-        #   but the item itself is not, the item will be placed under its owner's root.
+        #   Deprecated: If an item isn't in a shared drive and its last parent is deleted
+        #   but the item itself isn't, the item will be placed under its owner's root.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1241,11 +1249,15 @@ module Google
         end
         
         # Exports a Google Workspace document to the requested MIME type and returns
-        # exported byte content. Note that the exported content is limited to 10MB.
+        # exported byte content. For more information, see [Download and export files](
+        # https://developers.google.com/workspace/drive/api/guides/manage-downloads).
+        # Note that the exported content is limited to 10 MB.
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] mime_type
-        #   Required. The MIME type of the format requested for this export.
+        #   Required. The MIME type of the format requested for this export. For a list of
+        #   supported MIME types, see [Export MIME types for Google Workspace documents](/
+        #   workspace/drive/api/guides/ref-export-formats).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1280,15 +1292,21 @@ module Google
         end
         
         # Generates a set of file IDs which can be provided in create or copy requests.
+        # For more information, see [Create and manage files](https://developers.google.
+        # com/workspace/drive/api/guides/create-file).
         # @param [Fixnum] count
         #   The number of IDs to return.
         # @param [String] space
-        #   The space in which the IDs can be used to create new files. Supported values
-        #   are 'drive' and 'appDataFolder'. (Default: 'drive')
+        #   The space in which the IDs can be used to create files. Supported values are `
+        #   drive` and `appDataFolder`. (Default: `drive`.) For more information, see [
+        #   File organization](https://developers.google.com/workspace/drive/api/guides/
+        #   about-files#file-organization).
         # @param [String] type
-        #   The type of items which the IDs can be used for. Supported values are 'files'
-        #   and 'shortcuts'. Note that 'shortcuts' are only supported in the `drive` '
-        #   space'. (Default: 'files')
+        #   The type of items which the IDs can be used for. Supported values are `files`
+        #   and `shortcuts`. Note that `shortcuts` are only supported in the `drive` `
+        #   space`. (Default: `files`.) For more information, see [File organization](
+        #   https://developers.google.com/workspace/drive/api/guides/about-files#file-
+        #   organization).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1318,12 +1336,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a file's metadata or content by ID. If you provide the URL parameter `
-        # alt=media`, then the response includes the file contents in the response body.
-        # Downloading content with `alt=media` only works if the file is stored in Drive.
-        # To download Google Docs, Sheets, and Slides use [`files.export`](/workspace/
-        # drive/api/reference/rest/v3/files/export) instead. For more information, see [
-        # Download & export files](/workspace/drive/api/guides/manage-downloads).
+        # Gets a file's metadata or content by ID. For more information, see [Search
+        # for files and folders](/workspace/drive/api/guides/search-files). If you
+        # provide the URL parameter `alt=media`, then the response includes the file
+        # contents in the response body. Downloading content with `alt=media` only works
+        # if the file is stored in Drive. To download Google Docs, Sheets, and Slides
+        # use [`files.export`](/workspace/drive/api/reference/rest/v3/files/export)
+        # instead. For more information, see [Download and export files](/workspace/
+        # drive/api/guides/manage-downloads).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Boolean] acknowledge_abuse
@@ -1336,7 +1356,7 @@ module Google
         #   the response.
         # @param [String] include_permissions_for_view
         #   Specifies which additional view's permissions to include in the response. Only
-        #   'published' is supported.
+        #   `published` is supported.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1380,19 +1400,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the user's files. This method accepts the `q` parameter, which is a
-        # search query combining one or more search terms. For more information, see the
-        # [Search for files & folders](/workspace/drive/api/guides/search-files) guide. *
-        # Note:* This method returns *all* files by default, including trashed files. If
-        # you don't want trashed files to appear in the list, use the `trashed=false`
-        # query parameter to remove trashed files from the results.
+        # Lists the user's files. For more information, see [Search for files and
+        # folders](/workspace/drive/api/guides/search-files). This method accepts the `q`
+        # parameter, which is a search query combining one or more search terms. This
+        # method returns *all* files by default, including trashed files. If you don't
+        # want trashed files to appear in the list, use the `trashed=false` query
+        # parameter to remove trashed files from the results.
         # @param [String] corpora
-        #   Bodies of items (files/documents) to which the query applies. Supported bodies
-        #   are 'user', 'domain', 'drive', and 'allDrives'. Prefer 'user' or 'drive' to '
-        #   allDrives' for efficiency. By default, corpora is set to 'user'. However, this
-        #   can change depending on the filter set through the 'q' parameter.
+        #   Bodies of items (files or documents) to which the query applies. Supported
+        #   bodies are: * `user` * `domain` * `drive` * `allDrives` Prefer `user` or `
+        #   drive` to `allDrives` for efficiency. By default, corpora is set to `user`.
+        #   However, this can change depending on the filter set through the `q` parameter.
+        #   For more information, see [File organization](https://developers.google.com/
+        #   workspace/drive/api/guides/about-files#file-organization).
         # @param [String] corpus
-        #   Deprecated: The source of files to list. Use 'corpora' instead.
+        #   Deprecated: The source of files to list. Use `corpora` instead.
         # @param [String] drive_id
         #   ID of the shared drive to search.
         # @param [Boolean] include_items_from_all_drives
@@ -1402,7 +1424,7 @@ module Google
         #   the response.
         # @param [String] include_permissions_for_view
         #   Specifies which additional view's permissions to include in the response. Only
-        #   'published' is supported.
+        #   `published` is supported.
         # @param [Boolean] include_team_drive_items
         #   Deprecated: Use `includeItemsFromAllDrives` instead.
         # @param [String] order_by
@@ -1418,20 +1440,22 @@ module Google
         #   sharedWithMeTime`: When the file was shared with the user, if applicable. * `
         #   starred`: Whether the user has starred the file. * `viewedByMeTime`: The last
         #   time the file was viewed by the user. Each key sorts ascending by default, but
-        #   can be reversed with the 'desc' modifier. Example usage: `?orderBy=folder,
+        #   can be reversed with the `desc` modifier. Example usage: `?orderBy=folder,
         #   modifiedTime desc,name`.
         # @param [Fixnum] page_size
         #   The maximum number of files to return per page. Partial or empty result pages
         #   are possible even before the end of the files list has been reached.
         # @param [String] page_token
         #   The token for continuing a previous list request on the next page. This should
-        #   be set to the value of 'nextPageToken' from the previous response.
+        #   be set to the value of `nextPageToken` from the previous response.
         # @param [String] q
-        #   A query for filtering the file results. See the "Search for files & folders"
-        #   guide for supported syntax.
+        #   A query for filtering the file results. For supported syntax, see [Search for
+        #   files and folders](/workspace/drive/api/guides/search-files).
         # @param [String] spaces
         #   A comma-separated list of spaces to query within the corpora. Supported values
-        #   are 'drive' and 'appDataFolder'.
+        #   are `drive` and `appDataFolder`. For more information, see [File organization](
+        #   https://developers.google.com/workspace/drive/api/guides/about-files#file-
+        #   organization).
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1479,14 +1503,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the labels on a file.
+        # Lists the labels on a file. For more information, see [List labels on a file](
+        # https://developers.google.com/workspace/drive/api/guides/list-labels).
         # @param [String] file_id
         #   The ID for the file.
         # @param [Fixnum] max_results
         #   The maximum number of labels to return per page. When not set, defaults to 100.
         # @param [String] page_token
         #   The token for continuing a previous list request on the next page. This should
-        #   be set to the value of 'nextPageToken' from the previous response.
+        #   be set to the value of `nextPageToken` from the previous response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1516,8 +1541,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the set of labels applied to a file. Returns a list of the labels
-        # that were added or modified.
+        # Modifies the set of labels applied to a file. For more information, see [Set a
+        # label field on a file](https://developers.google.com/workspace/drive/api/
+        # guides/set-label). Returns a list of the labels that were added or modified.
         # @param [String] file_id
         #   The ID of the file to which the labels belong.
         # @param [Google::Apis::DriveV3::ModifyLabelsRequest] modify_labels_request_object
@@ -1550,16 +1576,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a file's metadata and/or content. When calling this method, only
+        # Updates a file's metadata, content, or both. When calling this method, only
         # populate fields in the request that you want to modify. When updating fields,
         # some fields might be changed automatically, such as `modifiedDate`. This
         # method supports patch semantics. This method supports an */upload* URI and
         # accepts uploaded media with the following characteristics: - *Maximum file
-        # size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME
+        # size:* 5,120 GB - *Accepted Media MIME types:* `*/*` (Specify a valid MIME
         # type, rather than the literal `*/*` value. The literal `*/*` is only used to
-        # indicate that any valid MIME type can be uploaded. For more information on
-        # uploading files, see [Upload file data](/workspace/drive/api/guides/manage-
-        # uploads).
+        # indicate that any valid MIME type can be uploaded. For more information, see [
+        # Google Workspace and Google Drive supported MIME types](/workspace/drive/api/
+        # guides/mime-types).) For more information on uploading files, see [Upload file
+        # data](/workspace/drive/api/guides/manage-uploads).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::File] file_object
@@ -1573,9 +1600,9 @@ module Google
         #   the response.
         # @param [String] include_permissions_for_view
         #   Specifies which additional view's permissions to include in the response. Only
-        #   'published' is supported.
+        #   `published` is supported.
         # @param [Boolean] keep_revision_forever
-        #   Whether to set the 'keepForever' field in the new head revision. This is only
+        #   Whether to set the `keepForever` field in the new head revision. This is only
         #   applicable to files with binary content in Google Drive. Only 200 revisions
         #   for the file can be kept forever. If the limit is reached, try deleting pinned
         #   revisions.
@@ -1638,7 +1665,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Subscribes to changes to a file.
+        # Subscribes to changes to a file. For more information, see [Notifications for
+        # resource changes](https://developers.google.com/workspace/drive/api/guides/
+        # push).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::Channel] channel_object
@@ -1652,7 +1681,7 @@ module Google
         #   the response.
         # @param [String] include_permissions_for_view
         #   Specifies which additional view's permissions to include in the response. Only
-        #   'published' is supported.
+        #   `published` is supported.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.
         # @param [Boolean] supports_team_drives
@@ -1741,7 +1770,7 @@ module Google
         #   prior parents removed. If set to `false`, parents are not changed.
         # @param [Boolean] send_notification_email
         #   Whether to send a notification email when sharing to users or groups. This
-        #   defaults to true for users and groups, and is not allowed for other requests.
+        #   defaults to `true` for users and groups, and is not allowed for other requests.
         #   It must not be disabled for ownership transfers.
         # @param [Boolean] supports_all_drives
         #   Whether the requesting application supports both My Drives and shared drives.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v3
 version: !ruby/object:Gem::Version
-  version: 0.69.0
+  version: 0.70.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.69.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.70.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3
 rdoc_options: []
 require_paths: