google-api-client 0.42.1 → 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/chat_v1.rb

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

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

@@ -683,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

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

@@ -130,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
       
@@ -390,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

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/*".

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