google-api-client 0.41.2 → 0.44.0

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,10 +47,48 @@ 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/*".
-        #   Example: spaces/AAAAMpdlehY
+        #   Required. Resource name of the space, in the form "spaces/*". Example: spaces/
+        #   AAAAMpdlehY
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -80,9 +118,8 @@ module Google
         
         # Lists spaces the caller is a member of.
         # @param [Fixnum] page_size
-        #   Requested page size. The value is capped at 1000.
-        #   Server may return fewer results than requested.
-        #   If unspecified, server will default to 100.
+        #   Requested page size. The value is capped at 1000. Server may return fewer
+        #   results than requested. If unspecified, server will default to 100.
         # @param [String] page_token
         #   A token identifying a page of results the server should return.
         # @param [String] fields
@@ -115,9 +152,8 @@ module Google
         
         # Returns a membership.
         # @param [String] name
-        #   Required. Resource name of the membership to be retrieved, in the form
-        #   "spaces/*/members/*".
-        #   Example: spaces/AAAAMpdlehY/members/105115627578887013105
+        #   Required. Resource name of the membership to be retrieved, in the form "spaces/
+        #   */members/*". Example: spaces/AAAAMpdlehY/members/105115627578887013105
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -148,12 +184,10 @@ module Google
         # Lists human memberships in a space.
         # @param [String] parent
         #   Required. The resource name of the space for which membership list is to be
-        #   fetched, in the form "spaces/*".
-        #   Example: spaces/AAAAMpdlehY
+        #   fetched, in the form "spaces/*". Example: spaces/AAAAMpdlehY
         # @param [Fixnum] page_size
-        #   Requested page size. The value is capped at 1000.
-        #   Server may return fewer results than requested.
-        #   If unspecified, server will default to 100.
+        #   Requested page size. The value is capped at 1000. Server may return fewer
+        #   results than requested. If unspecified, server will default to 100.
         # @param [String] page_token
         #   A token identifying a page of results the server should return.
         # @param [String] fields
@@ -187,18 +221,16 @@ module Google
         
         # Creates a message.
         # @param [String] parent
-        #   Required. Space resource name, in the form "spaces/*".
-        #   Example: spaces/AAAAMpdlehY
+        #   Required. Space resource name, in the form "spaces/*". Example: spaces/
+        #   AAAAMpdlehY
         # @param [Google::Apis::ChatV1::Message] message_object
         # @param [String] thread_key
-        #   Opaque thread identifier string that can be specified to group messages
-        #   into a single thread. If this is the first message with a given thread
-        #   identifier, a new thread is created. Subsequent messages with the same
-        #   thread identifier will be posted into the same thread. This relieves bots
-        #   and webhooks from having to store the Hangouts Chat thread ID of a thread (
-        #   created earlier by them) to post
-        #   further updates to it.
-        #   Has no effect if thread field,
+        #   Opaque thread identifier string that can be specified to group messages into a
+        #   single thread. If this is the first message with a given thread identifier, a
+        #   new thread is created. Subsequent messages with the same thread identifier
+        #   will be posted into the same thread. This relieves bots and webhooks from
+        #   having to store the Hangouts Chat thread ID of a thread (created earlier by
+        #   them) to post further updates to it. Has no effect if thread field,
         #   corresponding to an existing thread, is set in message.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -232,9 +264,8 @@ module Google
         
         # Deletes a message.
         # @param [String] name
-        #   Required. Resource name of the message to be deleted, in the form
-        #   "spaces/*/messages/*"
-        #   Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+        #   Required. Resource name of the message to be deleted, in the form "spaces/*/
+        #   messages/*" Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -264,9 +295,8 @@ module Google
         
         # Returns a message.
         # @param [String] name
-        #   Required. Resource name of the message to be retrieved, in the form
-        #   "spaces/*/messages/*".
-        #   Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+        #   Required. Resource name of the message to be retrieved, in the form "spaces/*/
+        #   messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -296,15 +326,12 @@ module Google
         
         # Updates a message.
         # @param [String] name
-        #   Resource name, in the form "spaces/*/messages/*".
-        #   Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+        #   Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/
+        #   messages/UMxbHmzDlr4.UMxbHmzDlr4
         # @param [Google::Apis::ChatV1::Message] message_object
         # @param [String] update_mask
-        #   Required. The field paths to be updated, comma separated if there are
-        #   multiple.
-        #   Currently supported field paths:
-        #   * text
-        #   * cards
+        #   Required. The field paths to be updated, comma separated if there are multiple.
+        #   Currently supported field paths: * text * cards
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -334,6 +361,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/chromeuxreport_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/web/tools/chrome-user-experience-report/api/reference
     module ChromeuxreportV1
       VERSION = 'V1'
-      REVISION = '20200528'
+      REVISION = '20200803'
     end
   end
 end

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

@@ -22,25 +22,23 @@ module Google
   module Apis
     module ChromeuxreportV1
       
-      # A bin is a discrete portion of data spanning from start to end, or if no
-      # end is given, then from start to +inf.
-      # A bin's start and end values are given in the value type of the metric it
-      # represents. For example, "first contentful paint" is measured in
-      # milliseconds and exposed as ints, therefore its metric bins will use int32s
-      # for its start and end types. However, "cumulative layout shift" is measured
-      # in unitless decimals and is exposed as a decimal encoded as a string,
-      # therefore its metric bins will use strings for its value type.
+      # A bin is a discrete portion of data spanning from start to end, or if no end
+      # is given, then from start to +inf. A bin's start and end values are given in
+      # the value type of the metric it represents. For example, "first contentful
+      # paint" is measured in milliseconds and exposed as ints, therefore its metric
+      # bins will use int32s for its start and end types. However, "cumulative layout
+      # shift" is measured in unitless decimals and is exposed as a decimal encoded as
+      # a string, therefore its metric bins will use strings for its value type.
       class Bin
         include Google::Apis::Core::Hashable
       
-        # The proportion of users that experienced this bin's value for the given
-        # metric.
+        # The proportion of users that experienced this bin's value for the given metric.
         # Corresponds to the JSON property `density`
         # @return [Float]
         attr_accessor :density
       
-        # End is the end of the data bin. If end is not populated, then the bin has
-        # no end and is valid from start to +inf.
+        # End is the end of the data bin. If end is not populated, then the bin has no
+        # end and is valid from start to +inf.
         # Corresponds to the JSON property `end`
         # @return [Object]
         attr_accessor :end
@@ -66,24 +64,31 @@ module Google
       class Key
         include Google::Apis::Core::Hashable
       
-        # The form factor is the device class that all users used to access the
-        # site for this record.
-        # If the form factor is unspecified, then aggregated data over all form
-        # factors will be returned.
+        # The effective connection type is the general connection class that all users
+        # experienced for this record. This field uses the values ["offline", "slow-2G",
+        # "2G", "3G", "4G"] as specified in: https://wicg.github.io/netinfo/#effective-
+        # connection-types If the effective connection type is unspecified, then
+        # aggregated data over all effective connection types will be returned.
+        # Corresponds to the JSON property `effectiveConnectionType`
+        # @return [String]
+        attr_accessor :effective_connection_type
+      
+        # The form factor is the device class that all users used to access the site for
+        # this record. If the form factor is unspecified, then aggregated data over all
+        # form factors will be returned.
         # Corresponds to the JSON property `formFactor`
         # @return [String]
         attr_accessor :form_factor
       
-        # Origin specifies the origin that this record is for.
-        # Note: When specifying an origin, data for loads under this origin over
-        # all pages are aggregated into origin level user experience data.
+        # Origin specifies the origin that this record is for. Note: When specifying an
+        # origin, data for loads under this origin over all pages are aggregated into
+        # origin level user experience data.
         # Corresponds to the JSON property `origin`
         # @return [String]
         attr_accessor :origin
       
-        # Url specifies a specific url that this record is for.
-        # Note: When specifying a "url" only data for that specific url will be
-        # aggregated.
+        # Url specifies a specific url that this record is for. Note: When specifying a "
+        # url" only data for that specific url will be aggregated.
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -94,6 +99,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @effective_connection_type = args[:effective_connection_type] if args.key?(:effective_connection_type)
           @form_factor = args[:form_factor] if args.key?(:form_factor)
           @origin = args[:origin] if args.key?(:origin)
           @url = args[:url] if args.key?(:url)
@@ -101,8 +107,8 @@ module Google
       end
       
       # A `metric` is a set of user experience data for a single web performance
-      # metric, like "first contentful paint". It contains a summary histogram of
-      # real world Chrome usage as a series of `bins`.
+      # metric, like "first contentful paint". It contains a summary histogram of real
+      # world Chrome usage as a series of `bins`.
       class Metric
         include Google::Apis::Core::Hashable
       
@@ -113,8 +119,8 @@ module Google
         attr_accessor :histogram
       
         # Percentiles contains synthetic values of a metric at a given statistical
-        # percentile. These are used for estimating a metric's value as experienced
-        # by a percentage of users out of the total number of users.
+        # percentile. These are used for estimating a metric's value as experienced by a
+        # percentage of users out of the total number of users.
         # Corresponds to the JSON property `percentiles`
         # @return [Google::Apis::ChromeuxreportV1::Percentiles]
         attr_accessor :percentiles
@@ -131,8 +137,8 @@ module Google
       end
       
       # Percentiles contains synthetic values of a metric at a given statistical
-      # percentile. These are used for estimating a metric's value as experienced
-      # by a percentage of users out of the total number of users.
+      # percentile. These are used for estimating a metric's value as experienced by a
+      # percentage of users out of the total number of users.
       class Percentiles
         include Google::Apis::Core::Hashable
       
@@ -151,39 +157,44 @@ module Google
         end
       end
       
-      # Request payload sent by a physical web client.
-      # This request includes all necessary context to load a particular
-      # user experience record.
+      # Request payload sent by a physical web client. This request includes all
+      # necessary context to load a particular user experience record.
       class QueryRequest
         include Google::Apis::Core::Hashable
       
-        # The form factor is a query dimension that specifies the device class that
-        # the record's data should belong to.
-        # Note: If no form factor is specified, then a special record with
-        # aggregated data over all form factors will be returned.
+        # The effective connection type is a query dimension that specifies the
+        # effective network class that the record's data should belong to. This field
+        # uses the values ["offline", "slow-2G", "2G", "3G", "4G"] as specified in:
+        # https://wicg.github.io/netinfo/#effective-connection-types Note: If no
+        # effective connection type is specified, then a special record with aggregated
+        # data over all effective connection types will be returned.
+        # Corresponds to the JSON property `effectiveConnectionType`
+        # @return [String]
+        attr_accessor :effective_connection_type
+      
+        # The form factor is a query dimension that specifies the device class that the
+        # record's data should belong to. Note: If no form factor is specified, then a
+        # special record with aggregated data over all form factors will be returned.
         # Corresponds to the JSON property `formFactor`
         # @return [String]
         attr_accessor :form_factor
       
-        # The metrics that should be included in the response.
-        # If none are specified then any metrics found will be returned.
-        # Allowed values: ["first_contentful_paint",
-        # "first_input_delay", "largest_contentful_paint",
-        # "cumulative_layout_shift"]
+        # The metrics that should be included in the response. If none are specified
+        # then any metrics found will be returned. Allowed values: ["
+        # first_contentful_paint", "first_input_delay", "largest_contentful_paint", "
+        # cumulative_layout_shift"]
         # Corresponds to the JSON property `metrics`
         # @return [Array<String>]
         attr_accessor :metrics
       
-        # The url pattern "origin" refers to a url pattern that is the origin of
-        # a website.
-        # Examples: "https://example.com", "https://cloud.google.com"
+        # The url pattern "origin" refers to a url pattern that is the origin of a
+        # website. Examples: "https://example.com", "https://cloud.google.com"
         # Corresponds to the JSON property `origin`
         # @return [String]
         attr_accessor :origin
       
         # The url pattern "url" refers to a url pattern that is any arbitrary url.
-        # Examples: "https://example.com/",
-        # "https://cloud.google.com/why-google-cloud/"
+        # Examples: "https://example.com/", "https://cloud.google.com/why-google-cloud/"
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -194,6 +205,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @effective_connection_type = args[:effective_connection_type] if args.key?(:effective_connection_type)
           @form_factor = args[:form_factor] if args.key?(:form_factor)
           @metrics = args[:metrics] if args.key?(:metrics)
           @origin = args[:origin] if args.key?(:origin)
@@ -201,11 +213,11 @@ module Google
         end
       end
       
-      # Response payload sent back to a physical web client.
-      # This response contains the record found based on the identiers present in a
-      # `QueryRequest`.  The returned response will have a record, and sometimes
-      # details on normalization actions taken on the request that were necessary to
-      # make the request successful.
+      # Response payload sent back to a physical web client. This response contains
+      # the record found based on the identiers present in a `QueryRequest`. The
+      # returned response will have a record, and sometimes details on normalization
+      # actions taken on the request that were necessary to make the request
+      # successful.
       class QueryResponse
         include Google::Apis::Core::Hashable
       
@@ -244,11 +256,10 @@ module Google
         # @return [Google::Apis::ChromeuxreportV1::Key]
         attr_accessor :key
       
-        # Metrics is the map of user experience data available for the record defined
-        # in the key field. Metrics are keyed on the metric name.
-        # Allowed key values: ["first_contentful_paint",
-        # "first_input_delay", "largest_contentful_paint",
-        # "cumulative_layout_shift"]
+        # Metrics is the map of user experience data available for the record defined in
+        # the key field. Metrics are keyed on the metric name. Allowed key values: ["
+        # first_contentful_paint", "first_input_delay", "largest_contentful_paint", "
+        # cumulative_layout_shift"]
         # Corresponds to the JSON property `metrics`
         # @return [Hash<String,Google::Apis::ChromeuxreportV1::Metric>]
         attr_accessor :metrics
@@ -271,8 +282,8 @@ module Google
       class UrlNormalization
         include Google::Apis::Core::Hashable
       
-        # The URL after any normalization actions. This is a valid user experience
-        # URL that could reasonably be looked up.
+        # The URL after any normalization actions. This is a valid user experience URL
+        # that could reasonably be looked up.
         # Corresponds to the JSON property `normalizedUrl`
         # @return [String]
         attr_accessor :normalized_url