google-api-client 0.42.0 → 0.43.0

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

@@ -357,8 +357,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Initiates revoking content that has already been shared with the user's
-        # family. Empty response indicates success.
+        # Initiates revoking content that has already been shared with the user's family.
+        # Empty response indicates success.
         # @param [String] doc_id
         #   The docid to unshare.
         # @param [String] source
@@ -490,8 +490,8 @@ module Google
         #   The requested pixel height for any images. If height is provided width must
         #   also be provided.
         # @param [String] locale
-        #   The locale information for the data. ISO-639-1 language and ISO-3166-1
-        #   country code. Ex: 'en_US'.
+        #   The locale information for the data. ISO-639-1 language and ISO-3166-1 country
+        #   code. Ex: 'en_US'.
         # @param [Fixnum] scale
         #   The requested scale for the image.
         # @param [String] source
@@ -541,16 +541,16 @@ module Google
         # @param [String] layer_id
         #   The ID for the layer to get the annotation data.
         # @param [Array<String>, String] annotation_data_id
-        #   The list of Annotation Data Ids to retrieve. Pagination is ignored if this
-        #   is set.
+        #   The list of Annotation Data Ids to retrieve. Pagination is ignored if this is
+        #   set.
         # @param [String] content_version
         #   The content version for the requested volume.
         # @param [Fixnum] h
         #   The requested pixel height for any images. If height is provided width must
         #   also be provided.
         # @param [String] locale
-        #   The locale information for the data. ISO-639-1 language and ISO-3166-1
-        #   country code. Ex: 'en_US'.
+        #   The locale information for the data. ISO-639-1 language and ISO-3166-1 country
+        #   code. Ex: 'en_US'.
         # @param [Fixnum] max_results
         #   Maximum number of results to return
         # @param [String] page_token
@@ -560,11 +560,11 @@ module Google
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [String] updated_max
-        #   RFC 3339 timestamp to restrict to items updated prior to this timestamp
-        #   (exclusive).
+        #   RFC 3339 timestamp to restrict to items updated prior to this timestamp (
+        #   exclusive).
         # @param [String] updated_min
-        #   RFC 3339 timestamp to restrict to items updated since this timestamp
-        #   (inclusive).
+        #   RFC 3339 timestamp to restrict to items updated since this timestamp (
+        #   inclusive).
         # @param [Fixnum] w
         #   The requested pixel width for any images. If width is provided height must
         #   also be provided.
@@ -615,8 +615,8 @@ module Google
         # @param [String] annotation_id
         #   The ID of the volume annotation to retrieve.
         # @param [String] locale
-        #   The locale information for the data. ISO-639-1 language and ISO-3166-1
-        #   country code. Ex: 'en_US'.
+        #   The locale information for the data. ISO-639-1 language and ISO-3166-1 country
+        #   code. Ex: 'en_US'.
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [String] fields
@@ -662,15 +662,15 @@ module Google
         # @param [String] end_position
         #   The end position to end retrieving data from.
         # @param [String] locale
-        #   The locale information for the data. ISO-639-1 language and ISO-3166-1
-        #   country code. Ex: 'en_US'.
+        #   The locale information for the data. ISO-639-1 language and ISO-3166-1 country
+        #   code. Ex: 'en_US'.
         # @param [Fixnum] max_results
         #   Maximum number of results to return
         # @param [String] page_token
         #   The value of the nextToken from the previous page.
         # @param [Boolean] show_deleted
-        #   Set to true to return deleted annotations. updatedMin must be in the
-        #   request to use this. Defaults to false.
+        #   Set to true to return deleted annotations. updatedMin must be in the request
+        #   to use this. Defaults to false.
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [String] start_offset
@@ -678,11 +678,11 @@ module Google
         # @param [String] start_position
         #   The start position to start retrieving data from.
         # @param [String] updated_max
-        #   RFC 3339 timestamp to restrict to items updated prior to this timestamp
-        #   (exclusive).
+        #   RFC 3339 timestamp to restrict to items updated prior to this timestamp (
+        #   exclusive).
         # @param [String] updated_min
-        #   RFC 3339 timestamp to restrict to items updated since this timestamp
-        #   (inclusive).
+        #   RFC 3339 timestamp to restrict to items updated since this timestamp (
+        #   inclusive).
         # @param [String] volume_annotations_version
         #   The version of the volume annotations that you are requesting.
         # @param [String] fields
@@ -799,8 +799,7 @@ module Google
         # @param [String] cpksver
         #   The device/version ID from which to request the restrictions.
         # @param [String] license_types
-        #   The type of access license to request. If not specified, the default is
-        #   BOTH.
+        #   The type of access license to request. If not specified, the default is BOTH.
         # @param [String] locale
         #   ISO-639-1, ISO-3166-1 codes for message localization, i.e. en_US.
         # @param [String] nonce
@@ -841,8 +840,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Request downloaded content access for specified volumes on the My eBooks
-        # shelf.
+        # Request downloaded content access for specified volumes on the My eBooks shelf.
         # @param [String] cpksver
         #   The device/version ID from which to release the restriction.
         # @param [Array<String>, String] features
@@ -894,8 +892,8 @@ module Google
         end
         
         # Sets the settings for the user. If a sub-object is specified, it will
-        # overwrite the existing sub-object stored in the server. Unspecified
-        # sub-objects will retain the existing value.
+        # overwrite the existing sub-object stored in the server. Unspecified sub-
+        # objects will retain the existing value.
         # @param [Google::Apis::BooksV1::UserSettings] user_settings_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1013,16 +1011,16 @@ module Google
         # @param [String] page_token
         #   The value of the nextToken from the previous page.
         # @param [Boolean] show_deleted
-        #   Set to true to return deleted annotations. updatedMin must be in the
-        #   request to use this. Defaults to false.
+        #   Set to true to return deleted annotations. updatedMin must be in the request
+        #   to use this. Defaults to false.
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [String] updated_max
-        #   RFC 3339 timestamp to restrict to items updated prior to this timestamp
-        #   (exclusive).
+        #   RFC 3339 timestamp to restrict to items updated prior to this timestamp (
+        #   exclusive).
         # @param [String] updated_min
-        #   RFC 3339 timestamp to restrict to items updated since this timestamp
-        #   (inclusive).
+        #   RFC 3339 timestamp to restrict to items updated since this timestamp (
+        #   inclusive).
         # @param [String] volume_id
         #   The volume to restrict annotations to.
         # @param [String] fields
@@ -1274,8 +1272,8 @@ module Google
         # @param [String] volume_id
         #   ID of volume to move.
         # @param [Fixnum] volume_position
-        #   Position on shelf to move the item (0 puts the item before the current
-        #   first item, 1 puts it between the first and the second and so on.)
+        #   Position on shelf to move the item (0 puts the item before the current first
+        #   item, 1 puts it between the first and the second and so on.)
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1553,8 +1551,8 @@ module Google
         # @param [String] locale
         #   ISO-639-1 language and ISO-3166-1 country code. Default is en-US if unset.
         # @param [String] max_allowed_maturity_rating
-        #   The maximum allowed maturity rating of returned volumes. Books with a
-        #   higher maturity rating are filtered out.
+        #   The maximum allowed maturity rating of returned volumes. Books with a higher
+        #   maturity rating are filtered out.
         # @param [Fixnum] page_size
         #   Number of maximum results per page to be included in the response.
         # @param [String] page_token
@@ -1595,8 +1593,8 @@ module Google
         #   ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for
         #   generating recommendations.
         # @param [String] max_allowed_maturity_rating
-        #   The maximum allowed maturity rating of returned recommendations. Books with
-        #   a higher maturity rating are filtered out.
+        #   The maximum allowed maturity rating of returned recommendations. Books with a
+        #   higher maturity rating are filtered out.
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [String] fields
@@ -1849,7 +1847,7 @@ module Google
         # @param [String] projection
         #   Restrict information returned to a set of selected fields.
         # @param [String] source
-        #   string  to identify the originator of this request.
+        #   string to identify the originator of this request.
         # @param [Boolean] user_library_consistent_read
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1894,8 +1892,8 @@ module Google
         # @param [String] library_restrict
         #   Restrict search to this user's library.
         # @param [String] max_allowed_maturity_rating
-        #   The maximum allowed maturity rating of returned recommendations. Books with
-        #   a higher maturity rating are filtered out.
+        #   The maximum allowed maturity rating of returned recommendations. Books with a
+        #   higher maturity rating are filtered out.
         # @param [Fixnum] max_results
         #   Maximum number of results to return.
         # @param [String] order_by
@@ -1963,8 +1961,8 @@ module Google
         #   ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for
         #   generating recommendations.
         # @param [String] max_allowed_maturity_rating
-        #   The maximum allowed maturity rating of returned recommendations. Books with
-        #   a higher maturity rating are filtered out.
+        #   The maximum allowed maturity rating of returned recommendations. Books with a
+        #   higher maturity rating are filtered out.
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [String] fields
@@ -2009,8 +2007,8 @@ module Google
         # @param [Fixnum] max_results
         #   Maximum number of results to return.
         # @param [Array<String>, String] processing_state
-        #   The processing state of the user uploaded volumes to be returned.
-        #   Applicable only if the UPLOADED is specified in the acquireMethod.
+        #   The processing state of the user uploaded volumes to be returned. Applicable
+        #   only if the UPLOADED is specified in the acquireMethod.
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [Fixnum] start_index
@@ -2053,8 +2051,8 @@ module Google
         #   ISO-639-1 language and ISO-3166-1 country code. Ex: 'en_US'. Used for
         #   generating recommendations.
         # @param [String] max_allowed_maturity_rating
-        #   The maximum allowed maturity rating of returned recommendations. Books with
-        #   a higher maturity rating are filtered out.
+        #   The maximum allowed maturity rating of returned recommendations. Books with a
+        #   higher maturity rating are filtered out.
         # @param [String] source
         #   String to identify the originator of this request.
         # @param [String] fields

data/generated/google/apis/books_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://code.google.com/apis/books/docs/v1/getting_started.html
     module BooksV1
       VERSION = 'V1'
-      REVISION = '20200617'
+      REVISION = '20200717'
 
       # Manage your books
       AUTH_BOOKS = 'https://www.googleapis.com/auth/books'

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

@@ -135,6 +135,92 @@ module Google
         end
       end
       
+      # An attachment in Hangouts Chat.
+      class Attachment
+        include Google::Apis::Core::Hashable
+      
+        # A reference to the data of an attachment.
+        # Corresponds to the JSON property `attachmentDataRef`
+        # @return [Google::Apis::ChatV1::AttachmentDataRef]
+        attr_accessor :attachment_data_ref
+      
+        # The original file name for the content, not the full path.
+        # Corresponds to the JSON property `contentName`
+        # @return [String]
+        attr_accessor :content_name
+      
+        # The content type (MIME type) of the file.
+        # Corresponds to the JSON property `contentType`
+        # @return [String]
+        attr_accessor :content_type
+      
+        # Output only. The download URL which should be used to allow a human user to
+        # download the attachment. Bots should not use this URL to download
+        # attachment content.
+        # Corresponds to the JSON property `downloadUri`
+        # @return [String]
+        attr_accessor :download_uri
+      
+        # A reference to the data of a drive attachment.
+        # Corresponds to the JSON property `driveDataRef`
+        # @return [Google::Apis::ChatV1::DriveDataRef]
+        attr_accessor :drive_data_ref
+      
+        # Resource name of the attachment, in the form
+        # "spaces/*/messages/*/attachments/*".
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The source of the attachment.
+        # Corresponds to the JSON property `source`
+        # @return [String]
+        attr_accessor :source
+      
+        # Output only. The thumbnail URL which should be used to preview the
+        # attachment to a human user. Bots should not use this URL to download
+        # attachment content.
+        # Corresponds to the JSON property `thumbnailUri`
+        # @return [String]
+        attr_accessor :thumbnail_uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attachment_data_ref = args[:attachment_data_ref] if args.key?(:attachment_data_ref)
+          @content_name = args[:content_name] if args.key?(:content_name)
+          @content_type = args[:content_type] if args.key?(:content_type)
+          @download_uri = args[:download_uri] if args.key?(:download_uri)
+          @drive_data_ref = args[:drive_data_ref] if args.key?(:drive_data_ref)
+          @name = args[:name] if args.key?(:name)
+          @source = args[:source] if args.key?(:source)
+          @thumbnail_uri = args[:thumbnail_uri] if args.key?(:thumbnail_uri)
+        end
+      end
+      
+      # A reference to the data of an attachment.
+      class AttachmentDataRef
+        include Google::Apis::Core::Hashable
+      
+        # The resource name of the attachment data. This is used with the media API
+        # to download the attachment data.
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+        end
+      end
+      
       # A button. Can be a text button or an image button.
       class Button
         include Google::Apis::Core::Hashable
@@ -340,6 +426,25 @@ module Google
         end
       end
       
+      # A reference to the data of a drive attachment.
+      class DriveDataRef
+        include Google::Apis::Core::Hashable
+      
+        # The id for the drive file, for use with the Drive API.
+        # Corresponds to the JSON property `driveFileId`
+        # @return [String]
+        attr_accessor :drive_file_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @drive_file_id = args[:drive_file_id] if args.key?(:drive_file_id)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated
       # empty messages in your APIs. A typical example is to use it as the request
       # or the response type of an API method. For instance:
@@ -578,6 +683,25 @@ module Google
         end
       end
       
+      # Media resource.
+      class Media
+        include Google::Apis::Core::Hashable
+      
+        # Name of the media resource.
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+        end
+      end
+      
       # Represents a membership relation in Hangouts Chat.
       class Membership
         include Google::Apis::Core::Hashable
@@ -636,6 +760,11 @@ module Google
         # @return [String]
         attr_accessor :argument_text
       
+        # User uploaded attachment.
+        # Corresponds to the JSON property `attachment`
+        # @return [Array<Google::Apis::ChatV1::Attachment>]
+        attr_accessor :attachment
+      
         # Rich, formatted and interactive cards that can be used to display UI
         # elements such as: formatted texts, buttons, clickable images. Cards are
         # normally displayed below the plain-text body of the message.
@@ -697,6 +826,7 @@ module Google
           @action_response = args[:action_response] if args.key?(:action_response)
           @annotations = args[:annotations] if args.key?(:annotations)
           @argument_text = args[:argument_text] if args.key?(:argument_text)
+          @attachment = args[:attachment] if args.key?(:attachment)
           @cards = args[:cards] if args.key?(:cards)
           @create_time = args[:create_time] if args.key?(:create_time)
           @fallback_text = args[:fallback_text] if args.key?(:fallback_text)

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

@@ -40,6 +40,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Attachment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AttachmentDataRef
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Button
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -70,6 +82,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DriveDataRef
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -112,6 +130,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Media
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Membership
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -211,6 +235,29 @@ module Google
         end
       end
       
+      class Attachment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attachment_data_ref, as: 'attachmentDataRef', class: Google::Apis::ChatV1::AttachmentDataRef, decorator: Google::Apis::ChatV1::AttachmentDataRef::Representation
+      
+          property :content_name, as: 'contentName'
+          property :content_type, as: 'contentType'
+          property :download_uri, as: 'downloadUri'
+          property :drive_data_ref, as: 'driveDataRef', class: Google::Apis::ChatV1::DriveDataRef, decorator: Google::Apis::ChatV1::DriveDataRef::Representation
+      
+          property :name, as: 'name'
+          property :source, as: 'source'
+          property :thumbnail_uri, as: 'thumbnailUri'
+        end
+      end
+      
+      class AttachmentDataRef
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :resource_name, as: 'resourceName'
+        end
+      end
+      
       class Button
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -272,6 +319,13 @@ module Google
         end
       end
       
+      class DriveDataRef
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :drive_file_id, as: 'driveFileId'
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -342,6 +396,13 @@ module Google
         end
       end
       
+      class Media
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :resource_name, as: 'resourceName'
+        end
+      end
+      
       class Membership
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -361,6 +422,8 @@ module Google
           collection :annotations, as: 'annotations', class: Google::Apis::ChatV1::Annotation, decorator: Google::Apis::ChatV1::Annotation::Representation
       
           property :argument_text, as: 'argumentText'
+          collection :attachment, as: 'attachment', class: Google::Apis::ChatV1::Attachment, decorator: Google::Apis::ChatV1::Attachment::Representation
+      
           collection :cards, as: 'cards', class: Google::Apis::ChatV1::Card, decorator: Google::Apis::ChatV1::Card::Representation
       
           property :create_time, as: 'createTime'

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

@@ -47,6 +47,45 @@ module Google
           @batch_path = 'batch'
         end
         
+        # Downloads media. Download is supported
+        # on the URI `/v1/media/`+name`?alt=media`.
+        # @param [String] resource_name
+        #   Name of the media that is being downloaded.  See
+        #   ReadRequest.resource_name.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [IO, String] download_dest
+        #   IO stream or filename to receive content download
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ChatV1::Media] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Media]
+        #
+        # @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 download_medium(resource_name, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
+          if download_dest.nil?
+            command = make_simple_command(:get, 'v1/media/{+resourceName}', options)
+          else
+            command = make_download_command(:get, 'v1/media/{+resourceName}', options)
+            command.download_dest = download_dest
+          end
+          command.response_representation = Google::Apis::ChatV1::Media::Representation
+          command.response_class = Google::Apis::ChatV1::Media
+          command.params['resourceName'] = resource_name unless resource_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns a space.
         # @param [String] name
         #   Required. Resource name of the space, in the form "spaces/*".
@@ -334,6 +373,38 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Gets the metadata of a message attachment. The attachment data is fetched
+        # using the media API.
+        # @param [String] name
+        #   Resource name of the attachment, in the form
+        #   "spaces/*/messages/*/attachments/*".
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ChatV1::Attachment] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ChatV1::Attachment]
+        #
+        # @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 get_space_message_attachment(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ChatV1::Attachment::Representation
+          command.response_class = Google::Apis::ChatV1::Attachment
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

data/generated/google/apis/chat_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/hangouts/chat
     module ChatV1
       VERSION = 'V1'
-      REVISION = '20200617'
+      REVISION = '20200722'
     end
   end
 end