google-api-client 0.42.0 → 0.42.1

data/generated/google/apis/drive_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/drive/
     module DriveV2
       VERSION = 'V2'
-      REVISION = '20200618'
+      REVISION = '20200706'
 
       # See, edit, create, and delete all of your Google Drive files
       AUTH_DRIVE = 'https://www.googleapis.com/auth/drive'

data/generated/google/apis/drive_v2/classes.rb

@@ -1340,6 +1340,53 @@ module Google
         end
       end
       
+      # A restriction for accessing the content of the file.
+      class ContentRestriction
+        include Google::Apis::Core::Hashable
+      
+        # Whether the content of the file is read-only.
+        # Corresponds to the JSON property `readOnly`
+        # @return [Boolean]
+        attr_accessor :read_only
+        alias_method :read_only?, :read_only
+      
+        # Reason for why the content of the file is restricted. This is only mutable on
+        # requests that also set readOnly=true.
+        # Corresponds to the JSON property `reason`
+        # @return [String]
+        attr_accessor :reason
+      
+        # Information about a Drive user.
+        # Corresponds to the JSON property `restrictingUser`
+        # @return [Google::Apis::DriveV2::User]
+        attr_accessor :restricting_user
+      
+        # The time at which the content restriction was set (formatted RFC 3339
+        # timestamp). Only populated if readOnly is true.
+        # Corresponds to the JSON property `restrictionDate`
+        # @return [DateTime]
+        attr_accessor :restriction_date
+      
+        # The type of the content restriction. Currently the only possible value is
+        # globalContentRestriction.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @read_only = args[:read_only] if args.key?(:read_only)
+          @reason = args[:reason] if args.key?(:reason)
+          @restricting_user = args[:restricting_user] if args.key?(:restricting_user)
+          @restriction_date = args[:restriction_date] if args.key?(:restriction_date)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # Representation of a shared drive.
       class Drive
         include Google::Apis::Core::Hashable
@@ -1743,6 +1790,12 @@ module Google
         # @return [Google::Apis::DriveV2::File::Capabilities]
         attr_accessor :capabilities
       
+        # Restrictions for accessing the content of the file. Only populated if such a
+        # restriction exists.
+        # Corresponds to the JSON property `contentRestrictions`
+        # @return [Array<Google::Apis::DriveV2::ContentRestriction>]
+        attr_accessor :content_restrictions
+      
         # Whether the options to copy, print, or download this file, should be disabled
         # for readers and commenters.
         # Corresponds to the JSON property `copyRequiresWriterPermission`
@@ -2140,6 +2193,7 @@ module Google
           @can_comment = args[:can_comment] if args.key?(:can_comment)
           @can_read_revisions = args[:can_read_revisions] if args.key?(:can_read_revisions)
           @capabilities = args[:capabilities] if args.key?(:capabilities)
+          @content_restrictions = args[:content_restrictions] if args.key?(:content_restrictions)
           @copy_requires_writer_permission = args[:copy_requires_writer_permission] if args.key?(:copy_requires_writer_permission)
           @copyable = args[:copyable] if args.key?(:copyable)
           @created_date = args[:created_date] if args.key?(:created_date)
@@ -2300,6 +2354,12 @@ module Google
           attr_accessor :can_modify_content
           alias_method :can_modify_content?, :can_modify_content
         
+          # Whether the current user can modify restrictions on content of this file.
+          # Corresponds to the JSON property `canModifyContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_modify_content_restriction
+          alias_method :can_modify_content_restriction?, :can_modify_content_restriction
+        
           # 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
           # items in shared drives.
@@ -2454,6 +2514,7 @@ module Google
             @can_edit = args[:can_edit] if args.key?(:can_edit)
             @can_list_children = args[:can_list_children] if args.key?(:can_list_children)
             @can_modify_content = args[:can_modify_content] if args.key?(:can_modify_content)
+            @can_modify_content_restriction = args[:can_modify_content_restriction] if args.key?(:can_modify_content_restriction)
             @can_move_children_out_of_drive = args[:can_move_children_out_of_drive] if args.key?(:can_move_children_out_of_drive)
             @can_move_children_out_of_team_drive = args[:can_move_children_out_of_team_drive] if args.key?(:can_move_children_out_of_team_drive)
             @can_move_children_within_drive = args[:can_move_children_within_drive] if args.key?(:can_move_children_within_drive)
@@ -2698,8 +2759,11 @@ module Google
           attr_accessor :starred
           alias_method :starred?, :starred
         
-          # Whether this file has been trashed. This label applies to all users accessing
-          # the file; however, only owners are allowed to see and untrash files.
+          # 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
+          # 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.
           # Corresponds to the JSON property `trashed`
           # @return [Boolean]
           attr_accessor :trashed

data/generated/google/apis/drive_v2/representations.rb

@@ -160,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ContentRestriction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Drive
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -693,6 +699,19 @@ module Google
         end
       end
       
+      class ContentRestriction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :read_only, as: 'readOnly'
+          property :reason, as: 'reason'
+          property :restricting_user, as: 'restrictingUser', class: Google::Apis::DriveV2::User, decorator: Google::Apis::DriveV2::User::Representation
+      
+          property :restriction_date, as: 'restrictionDate', type: DateTime
+      
+          property :type, as: 'type'
+        end
+      end
+      
       class Drive
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -777,6 +796,8 @@ module Google
           property :can_read_revisions, as: 'canReadRevisions'
           property :capabilities, as: 'capabilities', class: Google::Apis::DriveV2::File::Capabilities, decorator: Google::Apis::DriveV2::File::Capabilities::Representation
       
+          collection :content_restrictions, as: 'contentRestrictions', class: Google::Apis::DriveV2::ContentRestriction, decorator: Google::Apis::DriveV2::ContentRestriction::Representation
+      
           property :copy_requires_writer_permission, as: 'copyRequiresWriterPermission'
           property :copyable, as: 'copyable'
           property :created_date, as: 'createdDate', type: DateTime
@@ -880,6 +901,7 @@ module Google
             property :can_edit, as: 'canEdit'
             property :can_list_children, as: 'canListChildren'
             property :can_modify_content, as: 'canModifyContent'
+            property :can_modify_content_restriction, as: 'canModifyContentRestriction'
             property :can_move_children_out_of_drive, as: 'canMoveChildrenOutOfDrive'
             property :can_move_children_out_of_team_drive, as: 'canMoveChildrenOutOfTeamDrive'
             property :can_move_children_within_drive, as: 'canMoveChildrenWithinDrive'

data/generated/google/apis/drive_v2/service.rb

@@ -1131,7 +1131,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a copy of the specified file.
+        # Creates a copy of the specified file. Folders cannot be copied.
         # @param [String] file_id
         #   The ID of the file to copy.
         # @param [Google::Apis::DriveV2::File] file_object
@@ -1489,9 +1489,12 @@ module Google
         
         # Lists the user's files.
         # @param [String] corpora
-        #   Bodies of items (files/documents) to which the query applies. Supported bodies
-        #   are 'default', 'domain', 'drive' and 'allDrives'. Prefer 'default' or 'drive'
-        #   to 'allDrives' for efficiency.
+        #   Groupings of files to which the query applies. Supported groupings are: 'user'
+        #   (files created by, opened by, or shared directly with the user), 'drive' (
+        #   files in the specified shared drive as indicated by the 'driveId'), 'domain' (
+        #   files shared to the user's domain), and 'allDrives' (A combination of 'user'
+        #   and 'drive' for all drives where the user is a member). When able, use 'user'
+        #   or 'drive', instead of 'allDrives', for efficiency.
         # @param [String] corpus
         #   The body of items (files/documents) to which the query applies. Deprecated:
         #   use 'corpora' instead.
@@ -1594,14 +1597,16 @@ module Google
         #   created as head revision, and previous unpinned revisions are preserved for a
         #   short period of time. Pinned revisions are stored indefinitely, using
         #   additional storage quota, up to a maximum of 200 revisions. For details on how
-        #   revisions are retained, see the Drive Help Center.
+        #   revisions are retained, see the Drive Help Center. Note that this field is
+        #   ignored if there is no payload in the request.
         # @param [Boolean] ocr
         #   Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
         # @param [String] ocr_language
         #   If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
         # @param [Boolean] pinned
         #   Whether to pin the new revision. A file can have a maximum of 200 pinned
-        #   revisions.
+        #   revisions. Note that this field is ignored if there is no payload in the
+        #   request.
         # @param [String] remove_parents
         #   Comma-separated list of parent IDs to remove.
         # @param [Boolean] set_modified_date
@@ -1709,7 +1714,11 @@ module Google
         end
         
         # Moves a file to the trash. The currently authenticated user must own the file
-        # or be at least a fileOrganizer on the parent for shared drive files.
+        # or be at least a fileOrganizer on the parent for shared drive files. Only the
+        # owner may 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.
         # @param [String] file_id
         #   The ID of the file to trash.
         # @param [Boolean] supports_all_drives
@@ -1748,7 +1757,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Restores a file from the trash.
+        # Restores a file from the trash. The currently authenticated user must own the
+        # file or be at least a fileOrganizer on the parent for shared drive files. Only
+        # the owner may untrash a file.
         # @param [String] file_id
         #   The ID of the file to untrash.
         # @param [Boolean] supports_all_drives
@@ -1811,14 +1822,16 @@ module Google
         #   created as head revision, and previous unpinned revisions are preserved for a
         #   short period of time. Pinned revisions are stored indefinitely, using
         #   additional storage quota, up to a maximum of 200 revisions. For details on how
-        #   revisions are retained, see the Drive Help Center.
+        #   revisions are retained, see the Drive Help Center. Note that this field is
+        #   ignored if there is no payload in the request.
         # @param [Boolean] ocr
         #   Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
         # @param [String] ocr_language
         #   If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
         # @param [Boolean] pinned
         #   Whether to pin the new revision. A file can have a maximum of 200 pinned
-        #   revisions.
+        #   revisions. Note that this field is ignored if there is no payload in the
+        #   request.
         # @param [String] remove_parents
         #   Comma-separated list of parent IDs to remove.
         # @param [Boolean] set_modified_date

data/generated/google/apis/drive_v3.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/drive/
     module DriveV3
       VERSION = 'V3'
-      REVISION = '20200618'
+      REVISION = '20200706'
 
       # See, edit, create, and delete all of your Google Drive files
       AUTH_DRIVE = 'https://www.googleapis.com/auth/drive'

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

@@ -577,6 +577,53 @@ module Google
         end
       end
       
+      # A restriction for accessing the content of the file.
+      class ContentRestriction
+        include Google::Apis::Core::Hashable
+      
+        # Whether the content of the file is read-only.
+        # Corresponds to the JSON property `readOnly`
+        # @return [Boolean]
+        attr_accessor :read_only
+        alias_method :read_only?, :read_only
+      
+        # Reason for why the content of the file is restricted. This is only mutable on
+        # requests that also set readOnly=true.
+        # Corresponds to the JSON property `reason`
+        # @return [String]
+        attr_accessor :reason
+      
+        # Information about a Drive user.
+        # Corresponds to the JSON property `restrictingUser`
+        # @return [Google::Apis::DriveV3::User]
+        attr_accessor :restricting_user
+      
+        # The time at which the content restriction was set (formatted RFC 3339
+        # timestamp). Only populated if readOnly is true.
+        # Corresponds to the JSON property `restrictionTime`
+        # @return [DateTime]
+        attr_accessor :restriction_time
+      
+        # The type of the content restriction. Currently the only possible value is
+        # globalContentRestriction.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @read_only = args[:read_only] if args.key?(:read_only)
+          @reason = args[:reason] if args.key?(:reason)
+          @restricting_user = args[:restricting_user] if args.key?(:restricting_user)
+          @restriction_time = args[:restriction_time] if args.key?(:restriction_time)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # Representation of a shared drive.
       class Drive
         include Google::Apis::Core::Hashable
@@ -972,6 +1019,12 @@ module Google
         # @return [Google::Apis::DriveV3::File::ContentHints]
         attr_accessor :content_hints
       
+        # Restrictions for accessing the content of the file. Only populated if such a
+        # restriction exists.
+        # Corresponds to the JSON property `contentRestrictions`
+        # @return [Array<Google::Apis::DriveV3::ContentRestriction>]
+        attr_accessor :content_restrictions
+      
         # Whether the options to copy, print, or download this file, should be disabled
         # for readers and commenters.
         # Corresponds to the JSON property `copyRequiresWriterPermission`
@@ -1234,8 +1287,10 @@ 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, and other users cannot see files in
-        # the owner's trash.
+        # folder. Only the owner may 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.
         # Corresponds to the JSON property `trashed`
         # @return [Boolean]
         attr_accessor :trashed
@@ -1308,6 +1363,7 @@ module Google
           @app_properties = args[:app_properties] if args.key?(:app_properties)
           @capabilities = args[:capabilities] if args.key?(:capabilities)
           @content_hints = args[:content_hints] if args.key?(:content_hints)
+          @content_restrictions = args[:content_restrictions] if args.key?(:content_restrictions)
           @copy_requires_writer_permission = args[:copy_requires_writer_permission] if args.key?(:copy_requires_writer_permission)
           @created_time = args[:created_time] if args.key?(:created_time)
           @description = args[:description] if args.key?(:description)
@@ -1457,6 +1513,12 @@ module Google
           attr_accessor :can_modify_content
           alias_method :can_modify_content?, :can_modify_content
         
+          # Whether the current user can modify restrictions on content of this file.
+          # Corresponds to the JSON property `canModifyContentRestriction`
+          # @return [Boolean]
+          attr_accessor :can_modify_content_restriction
+          alias_method :can_modify_content_restriction?, :can_modify_content_restriction
+        
           # 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
           # items in shared drives.
@@ -1611,6 +1673,7 @@ module Google
             @can_edit = args[:can_edit] if args.key?(:can_edit)
             @can_list_children = args[:can_list_children] if args.key?(:can_list_children)
             @can_modify_content = args[:can_modify_content] if args.key?(:can_modify_content)
+            @can_modify_content_restriction = args[:can_modify_content_restriction] if args.key?(:can_modify_content_restriction)
             @can_move_children_out_of_drive = args[:can_move_children_out_of_drive] if args.key?(:can_move_children_out_of_drive)
             @can_move_children_out_of_team_drive = args[:can_move_children_out_of_team_drive] if args.key?(:can_move_children_out_of_team_drive)
             @can_move_children_within_drive = args[:can_move_children_within_drive] if args.key?(:can_move_children_within_drive)

data/generated/google/apis/drive_v3/representations.rb

@@ -82,6 +82,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ContentRestriction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Drive
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -410,6 +416,19 @@ module Google
         end
       end
       
+      class ContentRestriction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :read_only, as: 'readOnly'
+          property :reason, as: 'reason'
+          property :restricting_user, as: 'restrictingUser', class: Google::Apis::DriveV3::User, decorator: Google::Apis::DriveV3::User::Representation
+      
+          property :restriction_time, as: 'restrictionTime', type: DateTime
+      
+          property :type, as: 'type'
+        end
+      end
+      
       class Drive
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -493,6 +512,8 @@ module Google
       
           property :content_hints, as: 'contentHints', class: Google::Apis::DriveV3::File::ContentHints, decorator: Google::Apis::DriveV3::File::ContentHints::Representation
       
+          collection :content_restrictions, as: 'contentRestrictions', class: Google::Apis::DriveV3::ContentRestriction, decorator: Google::Apis::DriveV3::ContentRestriction::Representation
+      
           property :copy_requires_writer_permission, as: 'copyRequiresWriterPermission'
           property :created_time, as: 'createdTime', type: DateTime
       
@@ -578,6 +599,7 @@ module Google
             property :can_edit, as: 'canEdit'
             property :can_list_children, as: 'canListChildren'
             property :can_modify_content, as: 'canModifyContent'
+            property :can_modify_content_restriction, as: 'canModifyContentRestriction'
             property :can_move_children_out_of_drive, as: 'canMoveChildrenOutOfDrive'
             property :can_move_children_out_of_team_drive, as: 'canMoveChildrenOutOfTeamDrive'
             property :can_move_children_within_drive, as: 'canMoveChildrenWithinDrive'

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

@@ -771,7 +771,7 @@ module Google
         end
         
         # Creates a copy of a file and applies any requested updates with patch
-        # semantics.
+        # semantics. Folders cannot be copied.
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::File] file_object
@@ -1104,9 +1104,12 @@ module Google
         
         # Lists or searches files.
         # @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.
+        #   Groupings of files to which the query applies. Supported groupings are: 'user'
+        #   (files created by, opened by, or shared directly with the user), 'drive' (
+        #   files in the specified shared drive as indicated by the 'driveId'), 'domain' (
+        #   files shared to the user's domain), and 'allDrives' (A combination of 'user'
+        #   and 'drive' for all drives where the user is a member). When able, use 'user'
+        #   or 'drive', instead of 'allDrives', for efficiency.
         # @param [String] corpus
         #   The source of files to list. Deprecated: use 'corpora' instead.
         # @param [String] drive_id
@@ -1183,7 +1186,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a file's metadata and/or content with patch semantics.
+        # Updates a file's metadata and/or content. This method supports patch semantics.
         # @param [String] file_id
         #   The ID of the file.
         # @param [Google::Apis::DriveV3::File] file_object