RubyGems - google-apis-drive_v3 - Versions diffs - 0.68.0 → 0.70.0 - Mend

google-apis-drive_v3 0.68.0 → 0.70.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +8 -0
data/lib/google/apis/drive_v3/classes.rb +63 -56
data/lib/google/apis/drive_v3/gem_version.rb +2 -2
data/lib/google/apis/drive_v3/service.rb +139 -93
metadata +2 -2

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 257acc6a67090afd4c31072bb22bf244fc63c0831c1efd1fcab78feade2dbb3d
-  data.tar.gz: 54a10dd6bc476513735f90a44f13ec4f8f1a761260e529337816fab94444149b
+  metadata.gz: 3662ceee87ae582728046012f01b468700eec7bb11045470145ec6fa887ae262
+  data.tar.gz: d31b9b75bc0ab3d1f1f33d977dcba039646b602400264d273ebe6517e3c5823a
 SHA512:
-  metadata.gz: b2289facb16657f062b2fdcdbf465e86fe5c3b895e5b46f2960cf5aa1bc21391d43414cf99edc1ab62f419928d718004c21061266906857cbbba1922c669cf02
-  data.tar.gz: b7d548a0f8c2bb28d4b64a36d810b8a3123a3747705a83fd5b3284aa8fbeaf73f58791c8f4119e017b307a46a771ee39983994e69abfcb8d9f03858d5374159a
+  metadata.gz: 25f2735fcbe4803f57b6683d835d646dabccf0a7238488b40afc7749101b74e7a34049a7d34cc1c269e21d3a1d142aa70127dac9f8d8f8055a2ca4ea3f0dfe50
+  data.tar.gz: f8a0c830f0411fb767036b94477893d5bfc2afc536bdeae9ed72bb9cd9112450d9f88cb9b4cf729591bb134f0f5454a0451aa637caab0c3cf25e2b5b37b40958

data/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,13 @@
 # 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
 ### v0.68.0 (2025-07-27)
 * Regenerated from discovery document revision 20250723

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

@@ -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 CHANGED Viewed

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DriveV3
       # Version of the google-apis-drive_v3 gem
-      GEM_VERSION = "0.68.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 = "20250723"
+      REVISION = "20250829"
     end
   end
 end

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

@@ -703,7 +703,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Creates a shared drive.
+        # Creates a shared drive. For more information, see [Manage shared drives](https:
+        # //developers.google.com/workspace/drive/api/guides/manage-shareddrives).
         # @param [String] request_id
         #   Required. An ID, such as a random UUID, which uniquely identifies this user's
         #   request for idempotent creation of a shared drive. A repeated request by the
@@ -741,7 +742,9 @@ module Google
         end
         # Permanently deletes a shared drive for which the user is an `organizer`. The
-        # shared drive cannot contain any untrashed items.
+        # shared drive cannot contain any untrashed items. For more information, see [
+        # Manage shared drives](https://developers.google.com/workspace/drive/api/guides/
+        # manage-shareddrives).
         # @param [String] drive_id
         #   The ID of the shared drive.
         # @param [Boolean] allow_item_deletion
@@ -778,7 +781,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Gets a shared drive's metadata by ID.
+        # Gets a shared drive's metadata by ID. For more information, see [Manage shared
+        # drives](https://developers.google.com/workspace/drive/api/guides/manage-
+        # shareddrives).
         # @param [String] drive_id
         #   The ID of the shared drive.
         # @param [Boolean] use_domain_admin_access
@@ -813,7 +818,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Hides a shared drive from the default view.
+        # Hides a shared drive from the default view. For more information, see [Manage
+        # shared drives](https://developers.google.com/workspace/drive/api/guides/manage-
+        # shareddrives).
         # @param [String] drive_id
         #   The ID of the shared drive.
         # @param [String] fields
@@ -886,7 +893,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Restores a shared drive to the default view.
+        # Restores a shared drive to the default view. For more information, see [Manage
+        # shared drives](https://developers.google.com/workspace/drive/api/guides/manage-
+        # shareddrives).
         # @param [String] drive_id
         #   The ID of the shared drive.
         # @param [String] fields
@@ -916,7 +925,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Updates the metadata for a shared drive.
+        # Updates the metadata for a shared drive. For more information, see [Manage
+        # shared drives](https://developers.google.com/workspace/drive/api/guides/manage-
+        # shareddrives).
         # @param [String] drive_id
         #   The ID of the shared drive.
         # @param [Google::Apis::DriveV3::Drive] drive_object
@@ -955,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
@@ -972,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.
@@ -1021,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
@@ -1051,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.
@@ -1113,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
@@ -1153,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 `
@@ -1197,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
@@ -1230,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
@@ -1269,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
@@ -1307,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
@@ -1325,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
@@ -1369,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
@@ -1391,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
@@ -1407,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
@@ -1468,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
@@ -1505,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
@@ -1539,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
@@ -1562,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.
@@ -1627,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
@@ -1641,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
@@ -1730,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.
@@ -2186,7 +2226,8 @@ module Google
         # Permanently deletes a file version. You can only delete revisions for files
         # with binary content in Google Drive, like images or videos. Revisions for
         # other files, like Google Docs or Sheets, and the last remaining file version
-        # can't be deleted.
+        # can't be deleted. For more information, see [Manage file revisions](https://
+        # developers.google.com/drive/api/guides/manage-revisions).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] revision_id
@@ -2217,7 +2258,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Gets a revision's metadata or content by ID.
+        # Gets a revision's metadata or content by ID. For more information, see [Manage
+        # file revisions](https://developers.google.com/workspace/drive/api/guides/
+        # manage-revisions).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] revision_id
@@ -2263,7 +2306,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Lists a file's revisions.
+        # Lists a file's revisions. For more information, see [Manage file revisions](
+        # https://developers.google.com/workspace/drive/api/guides/manage-revisions).
         # @param [String] file_id
         #   The ID of the file.
         # @param [Fixnum] page_size
@@ -2300,7 +2344,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Updates a revision with patch semantics.
+        # Updates a revision with patch semantics. For more information, see [Manage
+        # file revisions](https://developers.google.com/workspace/drive/api/guides/
+        # manage-revisions).
         # @param [String] file_id
         #   The ID of the file.
         # @param [String] revision_id

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v3
 version: !ruby/object:Gem::Version
-  version: 0.68.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.68.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: