google-apis-drive_v3 0.36.0 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a8e9ee034a138adf347aef950c58dee504e2c114144e5753f716592e3663739
-  data.tar.gz: b83951624906fe76b14acdf7687a79d99660066a43f8e6adff043bc6fac72bc9
+  metadata.gz: df1fc0ee81f5ad9e7869a7f4447a2f0679c2c785e03772c61e9ce3a6b47860c3
+  data.tar.gz: c876ab99ac5051ddfd41c4c6d823b207d62dfe1ee6fb1f079fe10a0207b4532f
 SHA512:
-  metadata.gz: 70156f0f7d44c8ba21270ed07564921a5c64839af2668c65a2d56f9a1295305a4e11e587ef2e92890f7a85a4c993af7b6812a5e4d1395d1dca1cc59c90ab0003
-  data.tar.gz: 5f3e93df1bfe42374edfd761ef38dc4cb7d0779e3fb13fa92e8e0b24cc6c5d104f8c69d29f1e45bad5dfe2885dbdf74b3d662319d4fef6c79becf34b0198a0e6
+  metadata.gz: daec6c32d18a436d7b2508851742cea7ba576cc3af0d0f440d3990bbd71ad5dd7c98d816fc60ab0f79375c9e558b26f13bec2098af888a7f1ad5d85b1dd189f2
+  data.tar.gz: 02cf20565c76fef5cff265fe6c73de7120d9e77c48108878b3c1fc69998acddf2deda848ad7430f1b8390f9799193fe570271b2037972a9e3f46bf60a9a39a8d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-drive_v3
 
+### v0.38.0 (2023-04-23)
+
+* Regenerated from discovery document revision 20230413
+
+### v0.37.0 (2023-03-12)
+
+* Regenerated from discovery document revision 20230306
+
 ### v0.36.0 (2023-02-26)
 
 * Regenerated from discovery document revision 20230219

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

@@ -633,7 +633,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An image file and cropping parameters from which a background image for this
-        # shared drive is set. This is a write only field; it can only be set on drive.
+        # shared drive is set. This is a write-only field; it can only be set on drive.
         # drives.update requests that don't set themeId. When specified, all fields of
         # the backgroundImageFile must be set.
         # Corresponds to the JSON property `backgroundImageFile`
@@ -650,8 +650,8 @@ module Google
         # @return [Google::Apis::DriveV3::Drive::Capabilities]
         attr_accessor :capabilities
       
-        # The color of this shared drive as an RGB hex string. It can only be set on a
-        # drive.drives.update request that does not set themeId.
+        # The color of this shared drive as an RGB hex string. It can only be set on
+        # drive.drives.update requests that don't set themeId.
         # Corresponds to the JSON property `colorRgb`
         # @return [String]
         attr_accessor :color_rgb
@@ -696,11 +696,11 @@ module Google
         # @return [Google::Apis::DriveV3::Drive::Restrictions]
         attr_accessor :restrictions
       
-        # The ID of the theme from which the background image and color will be set. The
-        # set of possible driveThemes can be retrieved from a drive.about.get response.
-        # When not specified on a drive.drives.create request, a random theme is chosen
-        # from which the background image and color are set. This is a write-only field;
-        # it can only be set on requests that don't set colorRgb or backgroundImageFile.
+        # The ID of the theme from which the background image and color are set. The set
+        # of possible driveThemes can be retrieved from a drive.about.get response. When
+        # not specified on a drive.drives.create request, a random theme is chosen from
+        # which the background image and color are set. This is a write-only field; it
+        # can only be set on requests that don't set colorRgb or backgroundImageFile.
         # Corresponds to the JSON property `themeId`
         # @return [String]
         attr_accessor :theme_id
@@ -726,7 +726,7 @@ module Google
         end
         
         # An image file and cropping parameters from which a background image for this
-        # shared drive is set. This is a write only field; it can only be set on drive.
+        # shared drive is set. This is a write-only field; it can only be set on drive.
         # drives.update requests that don't set themeId. When specified, all fields of
         # the backgroundImageFile must be set.
         class BackgroundImageFile
@@ -1034,18 +1034,18 @@ module Google
       class File
         include Google::Apis::Core::Hashable
       
-        # A collection of arbitrary key-value pairs which are private to the requesting
+        # A collection of arbitrary key-value pairs that are private to the requesting
         # app.
         # Entries with null values are cleared in update and copy requests. These
         # properties can only be retrieved using an authenticated request. An
-        # authenticated request uses an access token obtained with a OAuth 2 client ID.
+        # authenticated request uses an access token obtained with an OAuth 2 client ID.
         # You cannot use an API key to retrieve private properties.
         # Corresponds to the JSON property `appProperties`
         # @return [Hash<String,String>]
         attr_accessor :app_properties
       
         # Capabilities the current user has on this file. Each capability corresponds to
-        # a fine-grained action that a user may take.
+        # a fine-grained action that a user can take.
         # Corresponds to the JSON property `capabilities`
         # @return [Google::Apis::DriveV3::File::Capabilities]
         attr_accessor :capabilities
@@ -1112,10 +1112,10 @@ module Google
         # @return [String]
         attr_accessor :folder_color_rgb
       
-        # The full file extension extracted from the name field. May contain multiple
+        # The full file extension extracted from the name field. Can 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 isn't
+        # This is automatically updated when the name field changes, however it's not
         # cleared if the new name does not contain a valid extension.
         # Corresponds to the JSON property `fullFileExtension`
         # @return [String]
@@ -1136,8 +1136,8 @@ module Google
         attr_accessor :has_thumbnail
         alias_method :has_thumbnail?, :has_thumbnail
       
-        # The ID of the file's head revision. This is currently only available for files
-        # with binary content in Google Drive.
+        # The ID of the file's head revision. This is only available for files with
+        # binary content in Google Drive.
         # Corresponds to the JSON property `headRevisionId`
         # @return [String]
         attr_accessor :head_revision_id
@@ -1157,7 +1157,7 @@ module Google
         # @return [Google::Apis::DriveV3::File::ImageMediaMetadata]
         attr_accessor :image_media_metadata
       
-        # Whether the file was created or opened by the requesting app.
+        # Whether the requesting app created or opened the file.
         # Corresponds to the JSON property `isAppAuthorized`
         # @return [Boolean]
         attr_accessor :is_app_authorized
@@ -1201,26 +1201,26 @@ module Google
         # @return [String]
         attr_accessor :mime_type
       
-        # Whether the file has been modified by this user.
+        # Whether this user has modified the file.
         # Corresponds to the JSON property `modifiedByMe`
         # @return [Boolean]
         attr_accessor :modified_by_me
         alias_method :modified_by_me?, :modified_by_me
       
-        # The last time the file was modified by the user (RFC 3339 date-time).
+        # The last time the user modified the file (RFC 3339 date-time).
         # Corresponds to the JSON property `modifiedByMeTime`
         # @return [DateTime]
         attr_accessor :modified_by_me_time
       
-        # The last time the file was modified by anyone (RFC 3339 date-time).
+        # The last time anyone modified the file (RFC 3339 date-time).
         # Note that setting modifiedTime will also update modifiedByMeTime for the user.
         # Corresponds to the JSON property `modifiedTime`
         # @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, My Drive
+        # root folder, and Application Data folder the name is constant.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1238,13 +1238,13 @@ module Google
         attr_accessor :owned_by_me
         alias_method :owned_by_me?, :owned_by_me
       
-        # The owner of this file. Only certain legacy files may have more than one owner.
-        # This field isn't populated for items in shared drives.
+        # The owner of this file. Only certain legacy files might have more than one
+        # owner. This field isn't populated for items in shared drives.
         # Corresponds to the JSON property `owners`
         # @return [Array<Google::Apis::DriveV3::User>]
         attr_accessor :owners
       
-        # The IDs of the parent folders which contain the file.
+        # The IDs of the parent folders that contain the file.
         # If not specified as part of a create request, the file will be placed directly
         # in the user's My Drive folder. If not specified as part of a copy request, the
         # file will inherit any discoverable parents of the source file. Update requests
@@ -1265,7 +1265,7 @@ module Google
         # @return [Array<Google::Apis::DriveV3::Permission>]
         attr_accessor :permissions
       
-        # A collection of arbitrary key-value pairs which are visible to all apps.
+        # A collection of arbitrary key-value pairs that are visible to all apps.
         # Entries with null values are cleared in update and copy requests.
         # Corresponds to the JSON property `properties`
         # @return [Hash<String,String>]
@@ -1283,14 +1283,14 @@ module Google
         attr_accessor :resource_key
       
         # The SHA1 checksum associated with this file, if available. This field is only
-        # populated for files with content stored in Google Drive; it isn't populated
+        # 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
       
         # The SHA256 checksum associated with this file, if available. This field is
-        # only populated for files with content stored in Google Drive; it isn't
+        # 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]
@@ -1320,13 +1320,13 @@ module Google
         attr_accessor :shortcut_details
       
         # The size of the file's content in bytes. This field is populated for files
-        # with binary content stored in Google Drive and for Docs Editors files; it is
+        # with binary content stored in Google Drive and for Docs Editors files; it's
         # not populated for shortcuts or folders.
         # Corresponds to the JSON property `size`
         # @return [Fixnum]
         attr_accessor :size
       
-        # The list of spaces which contain the file. The currently supported values are '
+        # The list of spaces that contain the file. The currently supported values are '
         # drive', 'appDataFolder' and 'photos'.
         # Corresponds to the JSON property `spaces`
         # @return [Array<String>]
@@ -1357,7 +1357,7 @@ module Google
         attr_accessor :thumbnail_version
       
         # Whether the file has been trashed, either explicitly or from a trashed parent
-        # folder. Only the owner may trash a file. The trashed item is excluded from all
+        # folder. Only the owner can trash a file. The trashed item is excluded from all
         # files.list responses returned for any user who does not own the file. However,
         # all users with access to the file can see the trashed item metadata in an API
         # response. All users with access can copy, download, export, and share the file.
@@ -1383,19 +1383,19 @@ module Google
         # @return [Fixnum]
         attr_accessor :version
       
-        # Additional metadata about video media. This may not be available immediately
+        # Additional metadata about video media. This might not be available immediately
         # upon upload.
         # Corresponds to the JSON property `videoMediaMetadata`
         # @return [Google::Apis::DriveV3::File::VideoMediaMetadata]
         attr_accessor :video_media_metadata
       
-        # Whether the file has been viewed by this user.
+        # Whether this user has viewed the file.
         # Corresponds to the JSON property `viewedByMe`
         # @return [Boolean]
         attr_accessor :viewed_by_me
         alias_method :viewed_by_me?, :viewed_by_me
       
-        # The last time the file was viewed by the user (RFC 3339 date-time).
+        # The last time the user viewed the file (RFC 3339 date-time).
         # Corresponds to the JSON property `viewedByMeTime`
         # @return [DateTime]
         attr_accessor :viewed_by_me_time
@@ -1495,7 +1495,7 @@ module Google
         end
         
         # Capabilities the current user has on this file. Each capability corresponds to
-        # a fine-grained action that a user may take.
+        # a fine-grained action that a user can take.
         class Capabilities
           include Google::Apis::Core::Hashable
         
@@ -1507,14 +1507,14 @@ module Google
           alias_method :can_accept_ownership?, :can_accept_ownership
         
           # Whether the current user can add children to this folder. This is always false
-          # when the item is not a folder.
+          # 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
         
           # 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.
+          # 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]
@@ -1556,7 +1556,7 @@ module Google
         
           # 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 itself if it's not a folder.
           # Corresponds to the JSON property `canCopy`
           # @return [Boolean]
           attr_accessor :can_copy
@@ -1569,7 +1569,7 @@ module Google
           alias_method :can_delete?, :can_delete
         
           # 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 drives.
+          # when the item isn't a folder. Only populated for items in shared drives.
           # Corresponds to the JSON property `canDeleteChildren`
           # @return [Boolean]
           attr_accessor :can_delete_children
@@ -1581,8 +1581,8 @@ module Google
           attr_accessor :can_download
           alias_method :can_download?, :can_download
         
-          # Whether the current user can edit this file. Other factors may limit the type
-          # of changes a user can make to a file. For example, see
+          # Whether the current user can edit this file. Other factors might limit the
+          # type of changes a user can make to a file. For example, see
           # canChangeCopyRequiresWriterPermission or canModifyContent.
           # Corresponds to the JSON property `canEdit`
           # @return [Boolean]
@@ -1590,7 +1590,7 @@ module Google
           alias_method :can_edit?, :can_edit
         
           # Whether the current user can list the children of this folder. This is always
-          # false when the item is not a folder.
+          # false when the item isn't a folder.
           # Corresponds to the JSON property `canListChildren`
           # @return [Boolean]
           attr_accessor :can_list_children
@@ -1615,7 +1615,7 @@ module Google
           alias_method :can_modify_labels?, :can_modify_labels
         
           # 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 populated for
+          # 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]
@@ -1628,10 +1628,10 @@ module Google
           attr_accessor :can_move_children_out_of_team_drive
           alias_method :can_move_children_out_of_team_drive?, :can_move_children_out_of_team_drive
         
-          # 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 to move the
-          # child may still fail depending on the current user's access to the child and
-          # to the destination folder.
+          # Whether the current user can move children of this folder within this shared
+          # drive or My Drive. This is false when the item isn't a folder. Note that a
+          # request to move the child might still fail depending on the current user's
+          # access to the child and to the destination folder.
           # Corresponds to the JSON property `canMoveChildrenWithinDrive`
           # @return [Boolean]
           attr_accessor :can_move_children_within_drive
@@ -1649,9 +1649,9 @@ module Google
           attr_accessor :can_move_item_into_team_drive
           alias_method :can_move_item_into_team_drive?, :can_move_item_into_team_drive
         
-          # 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.
+          # Whether the current user can move this item outside of this shared drive or My
+          # Drive by changing its parent. Note that a request to change the parent of the
+          # item might 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
@@ -1663,9 +1663,10 @@ module Google
           attr_accessor :can_move_item_out_of_team_drive
           alias_method :can_move_item_out_of_team_drive?, :can_move_item_out_of_team_drive
         
-          # 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.
+          # Whether the current user can move this item within this shared drive or My
+          # Drive. Note that a request to change the parent of the item might still fail
+          # depending on the new parent that's being added and the parent that's being
+          # removed.
           # Corresponds to the JSON property `canMoveItemWithinDrive`
           # @return [Boolean]
           attr_accessor :can_move_item_within_drive
@@ -1698,7 +1699,7 @@ module Google
         
           # 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 isn't a folder, can be read.
+          # or this item itself if it's not a folder, can be read.
           # Corresponds to the JSON property `canReadRevisions`
           # @return [Boolean]
           attr_accessor :can_read_revisions
@@ -1711,7 +1712,7 @@ module Google
           alias_method :can_read_team_drive?, :can_read_team_drive
         
           # 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 drive, use
+          # 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]
@@ -1744,7 +1745,7 @@ module Google
           alias_method :can_trash?, :can_trash
         
           # 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 drives.
+          # the item isn't a folder. Only populated for items in shared drives.
           # Corresponds to the JSON property `canTrashChildren`
           # @return [Boolean]
           attr_accessor :can_trash_children
@@ -1809,7 +1810,7 @@ module Google
           include Google::Apis::Core::Hashable
         
           # Text to be indexed for the file to improve fullText queries. This is limited
-          # to 128 KB in length and may contain HTML elements. For more information, see
+          # to 128 KB in length and might contain HTML elements. For more information, see
           # Manage file metadata.
           # Corresponds to the JSON property `indexableText`
           # @return [String]
@@ -1940,7 +1941,7 @@ module Google
           # @return [String]
           attr_accessor :metering_mode
         
-          # The number of clockwise 90 degree rotations applied from the image's original
+          # The number of clockwise 90-degree rotations applied from the image's original
           # orientation.
           # Corresponds to the JSON property `rotation`
           # @return [Fixnum]
@@ -2114,7 +2115,7 @@ module Google
           end
         end
         
-        # Additional metadata about video media. This may not be available immediately
+        # Additional metadata about video media. This might not be available immediately
         # upon upload.
         class VideoMediaMetadata
           include Google::Apis::Core::Hashable

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.36.0"
+      GEM_VERSION = "0.38.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230219"
+      REVISION = "20230413"
     end
   end
 end

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

@@ -757,14 +757,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the metadate for a shared drive.
+        # Updates the metadata for a shared drive.
         # @param [String] drive_id
         #   The ID of the shared drive.
         # @param [Google::Apis::DriveV3::Drive] drive_object
         # @param [Boolean] use_domain_admin_access
-        #   Issue the request as a domain administrator; if set to true, then the
-        #   requester will be granted access if they are an administrator of the domain to
-        #   which the shared drive belongs.
+        #   Issue the request as a domain administrator. If set to true, then the
+        #   requester is granted access if they're an administrator of the domain to which
+        #   the shared drive belongs.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -991,6 +991,8 @@ module Google
         end
         
         # Permanently deletes all of the user's trashed files.
+        # @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.
@@ -1013,8 +1015,9 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def empty_file_trash(enforce_single_parent: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def empty_file_trash(drive_id: nil, enforce_single_parent: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:delete, 'files/trash', options)
+          command.query['driveId'] = drive_id unless drive_id.nil?
           command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -1418,9 +1421,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Subscribes to changes to a file. While you can establish a channel for changes
-        # to a file on a shared drive, a change to a shared drive file won't create a
-        # notification.
+        # Subscribes to changes to a file.
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::Channel] channel_object

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v3
 version: !ruby/object:Gem::Version
-  version: 0.36.0
+  version: 0.38.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-26 00:00:00.000000000 Z
+date: 2023-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,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.36.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.38.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3
 post_install_message: 
 rdoc_options: []