google-api-client 0.45.1 → 0.46.0

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

@@ -1226,11 +1226,11 @@ module Google
         #   The alignment_period specifies a time interval, in seconds, that is used to
         #   divide the data in all the time series into consistent blocks of time. This
         #   will be done before the per-series aligner can be applied to the data.The
-        #   value must be at least 60 seconds, at most 104 weeks. If a per-series aligner
-        #   other than ALIGN_NONE is specified, this field is required or an error is
-        #   returned. If no per-series aligner is specified, or the aligner ALIGN_NONE is
-        #   specified, then this field is ignored.The maximum value of the
-        #   alignment_period is 2 years, or 104 weeks.
+        #   value must be at least 60 seconds. If a per-series aligner other than
+        #   ALIGN_NONE is specified, this field is required or an error is returned. If no
+        #   per-series aligner is specified, or the aligner ALIGN_NONE is specified, then
+        #   this field is ignored.The maximum value of the alignment_period is 104 weeks (
+        #   2 years) for charts, and 90,000 seconds (25 hours) for alerting policies.
         # @param [String] aggregation_cross_series_reducer
         #   The reduction operation to be used to combine time series into a single time
         #   series, where the value of each data point in the resulting series is a

data/generated/google/apis/osconfig_v1.rb

@@ -18,15 +18,15 @@ require 'google/apis/osconfig_v1/representations.rb'
 
 module Google
   module Apis
-    # Cloud OS Config API
+    # OS Config API
     #
     # OS management tools that can be used for patch management, patch compliance,
     # and configuration management on VM instances.
     #
-    # @see https://cloud.google.com/
+    # @see https://cloud.google.com/compute/docs/manage-os
     module OsconfigV1
       VERSION = 'V1'
-      REVISION = '20200903'
+      REVISION = '20200930'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module OsconfigV1
-      # Cloud OS Config API
+      # OS Config API
       #
       # OS management tools that can be used for patch management, patch compliance,
       #  and configuration management on VM instances.
@@ -29,10 +29,10 @@ module Google
       #    require 'google/apis/osconfig_v1'
       #
       #    Osconfig = Google::Apis::OsconfigV1 # Alias the module
-      #    service = Osconfig::SystemsManagementService.new
+      #    service = Osconfig::OSConfigService.new
       #
-      # @see https://cloud.google.com/
-      class SystemsManagementService < Google::Apis::Core::BaseService
+      # @see https://cloud.google.com/compute/docs/manage-os
+      class OSConfigService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
         #  quota, and reports. Required unless you provide an OAuth 2.0 token.

data/generated/google/apis/osconfig_v1beta.rb

@@ -18,15 +18,15 @@ require 'google/apis/osconfig_v1beta/representations.rb'
 
 module Google
   module Apis
-    # Cloud OS Config API
+    # OS Config API
     #
     # OS management tools that can be used for patch management, patch compliance,
     # and configuration management on VM instances.
     #
-    # @see https://cloud.google.com/
+    # @see https://cloud.google.com/compute/docs/manage-os
     module OsconfigV1beta
       VERSION = 'V1beta'
-      REVISION = '20200903'
+      REVISION = '20200930'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module OsconfigV1beta
-      # Cloud OS Config API
+      # OS Config API
       #
       # OS management tools that can be used for patch management, patch compliance,
       #  and configuration management on VM instances.
@@ -29,10 +29,10 @@ module Google
       #    require 'google/apis/osconfig_v1beta'
       #
       #    Osconfig = Google::Apis::OsconfigV1beta # Alias the module
-      #    service = Osconfig::SystemsManagementService.new
+      #    service = Osconfig::OSConfigService.new
       #
-      # @see https://cloud.google.com/
-      class SystemsManagementService < Google::Apis::Core::BaseService
+      # @see https://cloud.google.com/compute/docs/manage-os
+      class OSConfigService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
         #  quota, and reports. Required unless you provide an OAuth 2.0 token.

data/generated/google/apis/pubsublite_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/pubsub/lite/docs
     module PubsubliteV1
       VERSION = 'V1'
-      REVISION = '20200915'
+      REVISION = '20200929'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -100,8 +100,8 @@ module Google
         attr_accessor :minimum_event_time
       
         # The minimum publish timestamp across these messages. Note that publish
-        # timestamps within a partition are non-decreasing. The timestamp will be unset
-        # if there are no messages.
+        # timestamps within a partition are not guaranteed to be non-decreasing. The
+        # timestamp will be unset if there are no messages.
         # Corresponds to the JSON property `minimumPublishTime`
         # @return [String]
         attr_accessor :minimum_publish_time

data/generated/google/apis/recommender_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/recommender/docs/
     module RecommenderV1
       VERSION = 'V1'
-      REVISION = '20200801'
+      REVISION = '20200927'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -84,7 +84,8 @@ module Google
         #   Required. The container resource on which to execute the request. Acceptable
         #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
         #   INSIGHT_TYPE_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   com/about/locations/
+        #   com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https:/
+        #   /cloud.google.com/recommender/docs/insights/insight-types.)
         # @param [String] filter
         #   Optional. Filter expression to restrict the insights returned. Supported
         #   filter fields: state Eg: `state:"DISMISSED" or state:"ACTIVE"
@@ -201,7 +202,8 @@ module Google
         #   Required. The container resource on which to execute the request. Acceptable
         #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
         #   RECOMMENDER_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   com/about/locations/
+        #   com/about/locations/ RECOMMENDER_ID refers to supported recommenders: https://
+        #   cloud.google.com/recommender/docs/recommenders.
         # @param [String] filter
         #   Filter expression to restrict the recommendations returned. Supported filter
         #   fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:

data/generated/google/apis/recommender_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/recommender/docs/
     module RecommenderV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200801'
+      REVISION = '20200927'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -84,7 +84,8 @@ module Google
         #   Required. The container resource on which to execute the request. Acceptable
         #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
         #   INSIGHT_TYPE_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   com/about/locations/
+        #   com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https:/
+        #   /cloud.google.com/recommender/docs/insights/insight-types.
         # @param [String] filter
         #   Optional. Filter expression to restrict the insights returned. Supported
         #   filter fields: state Eg: `state:"DISMISSED" or state:"ACTIVE"
@@ -201,7 +202,8 @@ module Google
         #   Required. The container resource on which to execute the request. Acceptable
         #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
         #   RECOMMENDER_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   com/about/locations/
+        #   com/about/locations/ RECOMMENDER_ID refers to supported recommenders: https://
+        #   cloud.google.com/recommender/docs/recommenders.
         # @param [String] filter
         #   Filter expression to restrict the recommendations returned. Supported filter
         #   fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:

data/generated/google/apis/redis_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/memorystore/docs/redis/
     module RedisV1
       VERSION = 'V1'
-      REVISION = '20200916'
+      REVISION = '20200928'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -416,11 +416,11 @@ module Google
         # A list of Redis instances in the project in the specified location, or across
         # all locations. If the `location_id` in the parent field of the request is "-",
         # all regions available to the project are queried, and the results aggregated.
-        # If in such an aggregated query a location is unavailable, a dummy Redis entry
-        # is included in the response with the `name` field set to a value of the form `
-        # projects/`project_id`/locations/`location_id`/instances/`- and the `status`
-        # field set to ERROR and `status_message` field set to "location not available
-        # for ListInstances".
+        # If in such an aggregated query a location is unavailable, a placeholder Redis
+        # entry is included in the response with the `name` field set to a value of the
+        # form `projects/`project_id`/locations/`location_id`/instances/`- and the `
+        # status` field set to ERROR and `status_message` field set to "location not
+        # available for ListInstances".
         # Corresponds to the JSON property `instances`
         # @return [Array<Google::Apis::RedisV1::Instance>]
         attr_accessor :instances

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

@@ -235,8 +235,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Initiates a failover of the master node to current replica node for a specific
-        # STANDARD tier Cloud Memorystore for Redis instance.
+        # Initiates a failover of the primary node to current replica node for a
+        # specific STANDARD tier Cloud Memorystore for Redis instance.
         # @param [String] name
         #   Required. Redis instance resource name using the form: `projects/`project_id`/
         #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to

data/generated/google/apis/redis_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/memorystore/docs/redis/
     module RedisV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200916'
+      REVISION = '20200928'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -263,6 +263,14 @@ module Google
         # @return [String]
         attr_accessor :alternative_location_id
       
+        # Optional. Indicates whether OSS Redis AUTH is enabled for the instance. If set
+        # to "true" AUTH is enabled on the instance. Default value is "false" meaning
+        # AUTH is disabled.
+        # Corresponds to the JSON property `authEnabled`
+        # @return [Boolean]
+        attr_accessor :auth_enabled
+        alias_method :auth_enabled?, :auth_enabled
+      
         # Optional. The full name of the Google Compute Engine [network](https://cloud.
         # google.com/vpc/docs/vpc) to which the instance is connected. If left
         # unspecified, the `default` network will be used.
@@ -391,6 +399,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @alternative_location_id = args[:alternative_location_id] if args.key?(:alternative_location_id)
+          @auth_enabled = args[:auth_enabled] if args.key?(:auth_enabled)
           @authorized_network = args[:authorized_network] if args.key?(:authorized_network)
           @connect_mode = args[:connect_mode] if args.key?(:connect_mode)
           @create_time = args[:create_time] if args.key?(:create_time)
@@ -412,6 +421,25 @@ module Google
         end
       end
       
+      # Instance AUTH string details.
+      class InstanceAuthString
+        include Google::Apis::Core::Hashable
+      
+        # AUTH string set on the instance.
+        # Corresponds to the JSON property `authString`
+        # @return [String]
+        attr_accessor :auth_string
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @auth_string = args[:auth_string] if args.key?(:auth_string)
+        end
+      end
+      
       # Response for ListInstances.
       class ListInstancesResponse
         include Google::Apis::Core::Hashable
@@ -419,11 +447,11 @@ module Google
         # A list of Redis instances in the project in the specified location, or across
         # all locations. If the `location_id` in the parent field of the request is "-",
         # all regions available to the project are queried, and the results aggregated.
-        # If in such an aggregated query a location is unavailable, a dummy Redis entry
-        # is included in the response with the `name` field set to a value of the form `
-        # projects/`project_id`/locations/`location_id`/instances/`- and the `status`
-        # field set to ERROR and `status_message` field set to "location not available
-        # for ListInstances".
+        # If in such an aggregated query a location is unavailable, a placeholder Redis
+        # entry is included in the response with the `name` field set to a value of the
+        # form `projects/`project_id`/locations/`location_id`/instances/`- and the `
+        # status` field set to ERROR and `status_message` field set to "location not
+        # available for ListInstances".
         # Corresponds to the JSON property `instances`
         # @return [Array<Google::Apis::RedisV1beta1::Instance>]
         attr_accessor :instances

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

@@ -88,6 +88,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class InstanceAuthString
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListInstancesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -218,6 +224,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :alternative_location_id, as: 'alternativeLocationId'
+          property :auth_enabled, as: 'authEnabled'
           property :authorized_network, as: 'authorizedNetwork'
           property :connect_mode, as: 'connectMode'
           property :create_time, as: 'createTime'
@@ -239,6 +246,13 @@ module Google
         end
       end
       
+      class InstanceAuthString
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :auth_string, as: 'authString'
+        end
+      end
+      
       class ListInstancesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -235,8 +235,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Initiates a failover of the master node to current replica node for a specific
-        # STANDARD tier Cloud Memorystore for Redis instance.
+        # Initiates a failover of the primary node to current replica node for a
+        # specific STANDARD tier Cloud Memorystore for Redis instance.
         # @param [String] name
         #   Required. Redis instance resource name using the form: `projects/`project_id`/
         #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
@@ -303,6 +303,40 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the AUTH string for a Redis instance. If AUTH is not enabled for the
+        # instance the response will be empty. This information is not included in the
+        # details returned to GetInstance.
+        # @param [String] name
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
+        #   a GCP region.
+        # @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::RedisV1beta1::InstanceAuthString] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RedisV1beta1::InstanceAuthString]
+        #
+        # @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_project_location_instance_auth_string(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}/authString', options)
+          command.response_representation = Google::Apis::RedisV1beta1::InstanceAuthString::Representation
+          command.response_class = Google::Apis::RedisV1beta1::InstanceAuthString
+          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
+        
         # Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
         # Redis may stop serving during this operation. Instance state will be IMPORTING
         # for entire operation. When complete, the instance will contain only data from

data/generated/google/apis/serviceconsumermanagement_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/service-consumer-management/docs/overview
     module ServiceconsumermanagementV1
       VERSION = 'V1'
-      REVISION = '20200915'
+      REVISION = '20200929'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -251,7 +251,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Add a new tenant project to the tenancy unit. There can be a maximum of 512
+        # Add a new tenant project to the tenancy unit. There can be a maximum of 1024
         # tenant projects in a tenancy unit. If there are previously failed `
         # AddTenantProject` calls, you might need to call `RemoveTenantProject` first to
         # resolve them before you can make another call to `AddTenantProject` with the

data/generated/google/apis/sheets_v4.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/sheets/
     module SheetsV4
       VERSION = 'V4'
-      REVISION = '20200908'
+      REVISION = '20200922'
 
       # See, edit, create, and delete all of your Google Drive files
       AUTH_DRIVE = 'https://www.googleapis.com/auth/drive'

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

@@ -125,9 +125,9 @@ module Google
       end
       
       # Adds a data source. After the data source is added successfully, an associated
-      # DataSource sheet is created and an execution is triggered to refresh the sheet
-      # to read data from the data source. The request requires an additional bigquery.
-      # readonly OAuth scope.
+      # DATA_SOURCE sheet is created and an execution is triggered to refresh the
+      # sheet to read data from the data source. The request requires an additional `
+      # bigquery.readonly` OAuth scope.
       class AddDataSourceRequest
         include Google::Apis::Core::Hashable
       
@@ -150,7 +150,15 @@ module Google
       class AddDataSourceResponse
         include Google::Apis::Core::Hashable
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
@@ -563,7 +571,7 @@ module Google
       class AutoResizeDimensionsRequest
         include Google::Apis::Core::Hashable
       
-        # A range along a single dimension on a DataSource sheet.
+        # A range along a single dimension on a DATA_SOURCE sheet.
         # Corresponds to the JSON property `dataSourceSheetDimensions`
         # @return [Google::Apis::SheetsV4::DataSourceSheetDimensionRange]
         attr_accessor :data_source_sheet_dimensions
@@ -1320,7 +1328,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The criteria for showing/hiding values per column. The map's key is the column
-        # index, and the value is the criteria for that column.
+        # index, and the value is the criteria for that column. This field is deprecated
+        # in favor of filter_specs.
         # Corresponds to the JSON property `criteria`
         # @return [Hash<String,Google::Apis::SheetsV4::FilterCriteria>]
         attr_accessor :criteria
@@ -1840,7 +1849,7 @@ module Google
         end
       end
       
-      # The specification of a BigQuery data source.
+      # The specification of a BigQuery data source that's connected to a sheet.
       class BigQueryDataSourceSpec
         include Google::Apis::Core::Hashable
       
@@ -1855,7 +1864,8 @@ module Google
         # @return [Google::Apis::SheetsV4::BigQueryQuerySpec]
         attr_accessor :query_spec
       
-        # Specifies a BigQuery table definition. Only native tables is allowed.
+        # Specifies a BigQuery table definition. Only [native tables](https://cloud.
+        # google.com/bigquery/docs/tables-intro) is allowed.
         # Corresponds to the JSON property `tableSpec`
         # @return [Google::Apis::SheetsV4::BigQueryTableSpec]
         attr_accessor :table_spec
@@ -1891,7 +1901,8 @@ module Google
         end
       end
       
-      # Specifies a BigQuery table definition. Only native tables is allowed.
+      # Specifies a BigQuery table definition. Only [native tables](https://cloud.
+      # google.com/bigquery/docs/tables-intro) is allowed.
       class BigQueryTableSpec
         include Google::Apis::Core::Hashable
       
@@ -2346,8 +2357,9 @@ module Google
         # @return [Google::Apis::SheetsV4::DataSourceFormula]
         attr_accessor :data_source_formula
       
-        # A data source table, allowing to import a static table of data from the
-        # DataSource into Sheets. This is also known as "Extract" in the Sheets editor.
+        # A data source table, which allows the user to import a static table of data
+        # from the DataSource into Sheets. This is also known as "Extract" in the Sheets
+        # editor.
         # Corresponds to the JSON property `dataSourceTable`
         # @return [Google::Apis::SheetsV4::DataSourceTable]
         attr_accessor :data_source_table
@@ -2631,7 +2643,7 @@ module Google
         # @return [String]
         attr_accessor :aggregate_type
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `columnReference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :column_reference
@@ -3461,7 +3473,15 @@ module Google
         end
       end
       
-      # The data execution status.
+      # The data execution status. A data execution is created to sync a data source
+      # object with the latest data from a DataSource. It is usually scheduled to run
+      # at background, you can check its state to tell if an execution completes There
+      # are several scenarios where a data execution is triggered to run: * Adding a
+      # data source creates an associated data source sheet as well as a data
+      # execution to sync the data from the data source to the sheet. * Updating a
+      # data source creates a data execution to refresh the associated data source
+      # sheet similarly. * You can send refresh request to explicitly refresh one or
+      # multiple data source objects.
       class DataExecutionStatus
         include Google::Apis::Core::Hashable
       
@@ -3592,20 +3612,22 @@ module Google
         # @return [Array<Google::Apis::SheetsV4::DataSourceColumn>]
         attr_accessor :calculated_columns
       
-        # The spreadsheet-scoped unique ID that identifies the data source.
+        # The spreadsheet-scoped unique ID that identifies the data source. Example:
+        # 1080547365.
         # Corresponds to the JSON property `dataSourceId`
         # @return [String]
         attr_accessor :data_source_id
       
         # The ID of the Sheet connected with the data source. The field cannot be
-        # changed once set. When creating a data source, an associated SheetType.
-        # DATA_SOURCE sheet is also created, if the field is not specified, the ID of
-        # the created sheet will be randomly generated.
+        # changed once set. When creating a data source, an associated DATA_SOURCE sheet
+        # is also created, if the field is not specified, the ID of the created sheet
+        # will be randomly generated.
         # Corresponds to the JSON property `sheetId`
         # @return [Fixnum]
         attr_accessor :sheet_id
       
-        # The specification of a data source.
+        # This specifies the details of the data source. For example, for BigQuery, this
+        # specifies information about the BigQuery source.
         # Corresponds to the JSON property `spec`
         # @return [Google::Apis::SheetsV4::DataSourceSpec]
         attr_accessor :spec
@@ -3627,7 +3649,15 @@ module Google
       class DataSourceChartProperties
         include Google::Apis::Core::Hashable
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
@@ -3648,7 +3678,7 @@ module Google
         end
       end
       
-      # A data source column.
+      # A column in a data source.
       class DataSourceColumn
         include Google::Apis::Core::Hashable
       
@@ -3657,7 +3687,7 @@ module Google
         # @return [String]
         attr_accessor :formula
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `reference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :reference
@@ -3673,7 +3703,7 @@ module Google
         end
       end
       
-      # An unique identifier that references to a data source column.
+      # An unique identifier that references a data source column.
       class DataSourceColumnReference
         include Google::Apis::Core::Hashable
       
@@ -3696,7 +3726,15 @@ module Google
       class DataSourceFormula
         include Google::Apis::Core::Hashable
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
@@ -3721,7 +3759,7 @@ module Google
       class DataSourceObjectReference
         include Google::Apis::Core::Hashable
       
-        # References to a DataSourceChart.
+        # References to a data source chart.
         # Corresponds to the JSON property `chartId`
         # @return [Fixnum]
         attr_accessor :chart_id
@@ -3741,7 +3779,7 @@ module Google
         # @return [Google::Apis::SheetsV4::GridCoordinate]
         attr_accessor :data_source_table_anchor_cell
       
-        # References to a SheetType.DATA_SOURCE sheet.
+        # References to a DATA_SOURCE sheet.
         # Corresponds to the JSON property `sheetId`
         # @return [String]
         attr_accessor :sheet_id
@@ -3779,13 +3817,14 @@ module Google
         end
       end
       
-      # A parameter in a data source's query. The parameter allows user to pass in
+      # A parameter in a data source's query. The parameter allows the user to pass in
       # values from the spreadsheet into a query.
       class DataSourceParameter
         include Google::Apis::Core::Hashable
       
         # Named parameter. Must be a legitimate identifier for the DataSource that
-        # supports it. For example, BigQuery identifier
+        # supports it. For example, [BigQuery identifier](https://cloud.google.com/
+        # bigquery/docs/reference/standard-sql/lexical#identifiers).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3824,7 +3863,7 @@ module Google
         end
       end
       
-      # Schedule refreshes in a time interval everyday.
+      # A schedule for data to refresh every day in a given time interval.
       class DataSourceRefreshDailySchedule
         include Google::Apis::Core::Hashable
       
@@ -3845,8 +3884,8 @@ module Google
         end
       end
       
-      # Schedule refreshes in a time interval on specified days in a month and repeats
-      # monthly.
+      # A monthly schedule for data to refresh on specific days in the month in a
+      # given time interval.
       class DataSourceRefreshMonthlySchedule
         include Google::Apis::Core::Hashable
       
@@ -3874,15 +3913,15 @@ module Google
         end
       end
       
-      # The data source refresh schedule. All data sources in the spreadsheet are
-      # scheduled to refresh in a future time interval. The time interval size
-      # defaults to the one defined in the Sheets editor. For example, if a daily
-      # schedule at start time of 8am is scheduled, and the time interval is 4 hours,
-      # the scheduled refresh will happen between 8am and 12pm every day.
+      # Schedule for refreshing the data source. Data sources in the spreadsheet are
+      # refreshed within a time interval. You can specify the start time by clicking
+      # the Scheduled Refresh button in the Sheets editor, but the interval is fixed
+      # at 4 hours. For example, if you specify a start time of 8am , the refresh will
+      # take place between 8am and 12pm every day.
       class DataSourceRefreshSchedule
         include Google::Apis::Core::Hashable
       
-        # Schedule refreshes in a time interval everyday.
+        # A schedule for data to refresh every day in a given time interval.
         # Corresponds to the JSON property `dailySchedule`
         # @return [Google::Apis::SheetsV4::DataSourceRefreshDailySchedule]
         attr_accessor :daily_schedule
@@ -3893,8 +3932,8 @@ module Google
         attr_accessor :enabled
         alias_method :enabled?, :enabled
       
-        # Schedule refreshes in a time interval on specified days in a month and repeats
-        # monthly.
+        # A monthly schedule for data to refresh on specific days in the month in a
+        # given time interval.
         # Corresponds to the JSON property `monthlySchedule`
         # @return [Google::Apis::SheetsV4::DataSourceRefreshMonthlySchedule]
         attr_accessor :monthly_schedule
@@ -3907,13 +3946,13 @@ module Google
         # @return [Google::Apis::SheetsV4::Interval]
         attr_accessor :next_run
       
-        # The scope of the refresh.
+        # The scope of the refresh. Must be ALL_DATA_SOURCES.
         # Corresponds to the JSON property `refreshScope`
         # @return [String]
         attr_accessor :refresh_scope
       
-        # Schedule refreshes in a time interval on specified days in a week and repeats
-        # weekly.
+        # A weekly schedule for data to refresh on specific days in a given time
+        # interval.
         # Corresponds to the JSON property `weeklySchedule`
         # @return [Google::Apis::SheetsV4::DataSourceRefreshWeeklySchedule]
         attr_accessor :weekly_schedule
@@ -3933,8 +3972,8 @@ module Google
         end
       end
       
-      # Schedule refreshes in a time interval on specified days in a week and repeats
-      # weekly.
+      # A weekly schedule for data to refresh on specific days in a given time
+      # interval.
       class DataSourceRefreshWeeklySchedule
         include Google::Apis::Core::Hashable
       
@@ -3961,7 +4000,7 @@ module Google
         end
       end
       
-      # A range along a single dimension on a DataSource sheet.
+      # A range along a single dimension on a DATA_SOURCE sheet.
       class DataSourceSheetDimensionRange
         include Google::Apis::Core::Hashable
       
@@ -3986,7 +4025,7 @@ module Google
         end
       end
       
-      # Additional properties of a SheetType.DATA_SOURCE sheet.
+      # Additional properties of a DATA_SOURCE sheet.
       class DataSourceSheetProperties
         include Google::Apis::Core::Hashable
       
@@ -3995,12 +4034,20 @@ module Google
         # @return [Array<Google::Apis::SheetsV4::DataSourceColumn>]
         attr_accessor :columns
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
       
-        # ID of the DataSource the sheet connected with.
+        # ID of the DataSource the sheet is connected to.
         # Corresponds to the JSON property `dataSourceId`
         # @return [String]
         attr_accessor :data_source_id
@@ -4017,16 +4064,17 @@ module Google
         end
       end
       
-      # The specification of a data source.
+      # This specifies the details of the data source. For example, for BigQuery, this
+      # specifies information about the BigQuery source.
       class DataSourceSpec
         include Google::Apis::Core::Hashable
       
-        # The specification of a BigQuery data source.
+        # The specification of a BigQuery data source that's connected to a sheet.
         # Corresponds to the JSON property `bigQuery`
         # @return [Google::Apis::SheetsV4::BigQueryDataSourceSpec]
         attr_accessor :big_query
       
-        # The parameters of the data source.
+        # The parameters of the data source, used when querying the data source.
         # Corresponds to the JSON property `parameters`
         # @return [Array<Google::Apis::SheetsV4::DataSourceParameter>]
         attr_accessor :parameters
@@ -4042,8 +4090,9 @@ module Google
         end
       end
       
-      # A data source table, allowing to import a static table of data from the
-      # DataSource into Sheets. This is also known as "Extract" in the Sheets editor.
+      # A data source table, which allows the user to import a static table of data
+      # from the DataSource into Sheets. This is also known as "Extract" in the Sheets
+      # editor.
       class DataSourceTable
         include Google::Apis::Core::Hashable
       
@@ -4058,7 +4107,15 @@ module Google
         # @return [Array<Google::Apis::SheetsV4::DataSourceColumnReference>]
         attr_accessor :columns
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
@@ -4539,7 +4596,8 @@ module Google
       class DeleteSheetRequest
         include Google::Apis::Core::Hashable
       
-        # The ID of the sheet to delete.
+        # The ID of the sheet to delete. If the sheet is of SheetType.DATA_SOURCE type,
+        # the associated DataSource is also deleted.
         # Corresponds to the JSON property `sheetId`
         # @return [Fixnum]
         attr_accessor :sheet_id
@@ -4776,7 +4834,7 @@ module Google
       class DimensionProperties
         include Google::Apis::Core::Hashable
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `dataSourceColumnReference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :data_source_column_reference
@@ -4915,7 +4973,10 @@ module Google
         # @return [String]
         attr_accessor :new_sheet_name
       
-        # The sheet to duplicate.
+        # The sheet to duplicate. If the source sheet is of DATA_SOURCE type, its
+        # backing DataSource is also duplicated and associated with the new copy of the
+        # sheet. No data execution is triggered, the grid data of this sheet is also
+        # copied over but only available after the batch request completes.
         # Corresponds to the JSON property `sourceSheetId`
         # @return [Fixnum]
         attr_accessor :source_sheet_id
@@ -5269,7 +5330,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :column_index
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `dataSourceColumnReference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :data_source_column_reference
@@ -5296,7 +5357,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The criteria for showing/hiding values per column. The map's key is the column
-        # index, and the value is the criteria for that column.
+        # index, and the value is the criteria for that column. This field is deprecated
+        # in favor of filter_specs.
         # Corresponds to the JSON property `criteria`
         # @return [Hash<String,Google::Apis::SheetsV4::FilterCriteria>]
         attr_accessor :criteria
@@ -6816,7 +6878,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :column_offset_index
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `dataSourceColumnReference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :data_source_column_reference
@@ -6842,7 +6904,7 @@ module Google
       class PivotGroup
         include Google::Apis::Core::Hashable
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `dataSourceColumnReference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :data_source_column_reference
@@ -7108,12 +7170,20 @@ module Google
         # column offset of the source range that you want to filter, and the value is
         # the criteria for that column. For example, if the source was `C10:E15`, a key
         # of `0` will have the filter for column `C`, whereas the key `1` is for column `
-        # D`.
+        # D`. This field is deprecated in favor of filter_specs.
         # Corresponds to the JSON property `criteria`
         # @return [Hash<String,Google::Apis::SheetsV4::PivotFilterCriteria>]
         attr_accessor :criteria
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
@@ -7194,7 +7264,7 @@ module Google
         # @return [String]
         attr_accessor :calculated_display_type
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `dataSourceColumnReference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :data_source_column_reference
@@ -7358,7 +7428,15 @@ module Google
       class RefreshDataSourceObjectExecutionStatus
         include Google::Apis::Core::Hashable
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
@@ -7380,8 +7458,8 @@ module Google
       end
       
       # Refreshes one or multiple data source objects in the spreadsheet by the
-      # specified references. The request requires an additional bigquery.readonly
-      # OAuth scope. If there're multiple refresh requests referencing the same data
+      # specified references. The request requires an additional `bigquery.readonly`
+      # OAuth scope. If there are multiple refresh requests referencing the same data
       # source objects in one batch, only the last refresh request is processed, and
       # all those requests will have the same response accordingly.
       class RefreshDataSourceRequest
@@ -7519,9 +7597,9 @@ module Google
         attr_accessor :add_conditional_format_rule
       
         # Adds a data source. After the data source is added successfully, an associated
-        # DataSource sheet is created and an execution is triggered to refresh the sheet
-        # to read data from the data source. The request requires an additional bigquery.
-        # readonly OAuth scope.
+        # DATA_SOURCE sheet is created and an execution is triggered to refresh the
+        # sheet to read data from the data source. The request requires an additional `
+        # bigquery.readonly` OAuth scope.
         # Corresponds to the JSON property `addDataSource`
         # @return [Google::Apis::SheetsV4::AddDataSourceRequest]
         attr_accessor :add_data_source
@@ -7736,8 +7814,8 @@ module Google
         attr_accessor :randomize_range
       
         # Refreshes one or multiple data source objects in the spreadsheet by the
-        # specified references. The request requires an additional bigquery.readonly
-        # OAuth scope. If there're multiple refresh requests referencing the same data
+        # specified references. The request requires an additional `bigquery.readonly`
+        # OAuth scope. If there are multiple refresh requests referencing the same data
         # source objects in one batch, only the last refresh request is processed, and
         # all those requests will have the same response accordingly.
         # Corresponds to the JSON property `refreshDataSource`
@@ -7826,9 +7904,9 @@ module Google
         attr_accessor :update_conditional_format_rule
       
         # Updates a data source. After the data source is updated successfully, an
-        # execution is triggered to refresh the associated DataSource sheet to read data
-        # from the updated data source. The request requires an additional bigquery.
-        # readonly OAuth scope.
+        # execution is triggered to refresh the associated DATA_SOURCE sheet to read
+        # data from the updated data source. The request requires an additional `
+        # bigquery.readonly` OAuth scope.
         # Corresponds to the JSON property `updateDataSource`
         # @return [Google::Apis::SheetsV4::UpdateDataSourceRequest]
         attr_accessor :update_data_source
@@ -8141,7 +8219,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The aggregation type for key and baseline chart data in scorecard chart. This
-        # field is optional.
+        # field is not supported for data source charts. Use the ChartData.aggregateType
+        # field of the key_value_data or baseline_value_data instead for data source
+        # charts. This field is optional.
         # Corresponds to the JSON property `aggregateType`
         # @return [String]
         attr_accessor :aggregate_type
@@ -8332,7 +8412,9 @@ module Google
         # example, if this is representing `Sheet1`, and the spreadsheet was requested
         # with ranges `Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will
         # have a startRow/startColumn of `0`, while the second one will have `startRow
-        # 14` (zero-based row 15), and `startColumn 3` (zero-based column D).
+        # 14` (zero-based row 15), and `startColumn 3` (zero-based column D). For a
+        # DATA_SOURCE sheet, you can not request a specific range, the GridData contains
+        # all the values.
         # Corresponds to the JSON property `data`
         # @return [Array<Google::Apis::SheetsV4::GridData>]
         attr_accessor :data
@@ -8399,7 +8481,7 @@ module Google
       class SheetProperties
         include Google::Apis::Core::Hashable
       
-        # Additional properties of a SheetType.DATA_SOURCE sheet.
+        # Additional properties of a DATA_SOURCE sheet.
         # Corresponds to the JSON property `dataSourceSheetProperties`
         # @return [Google::Apis::SheetsV4::DataSourceSheetProperties]
         attr_accessor :data_source_sheet_properties
@@ -8775,7 +8857,7 @@ module Google
         # @return [Google::Apis::SheetsV4::ColorStyle]
         attr_accessor :background_color_style
       
-        # An unique identifier that references to a data source column.
+        # An unique identifier that references a data source column.
         # Corresponds to the JSON property `dataSourceColumnReference`
         # @return [Google::Apis::SheetsV4::DataSourceColumnReference]
         attr_accessor :data_source_column_reference
@@ -10075,9 +10157,9 @@ module Google
       end
       
       # Updates a data source. After the data source is updated successfully, an
-      # execution is triggered to refresh the associated DataSource sheet to read data
-      # from the updated data source. The request requires an additional bigquery.
-      # readonly OAuth scope.
+      # execution is triggered to refresh the associated DATA_SOURCE sheet to read
+      # data from the updated data source. The request requires an additional `
+      # bigquery.readonly` OAuth scope.
       class UpdateDataSourceRequest
         include Google::Apis::Core::Hashable
       
@@ -10087,7 +10169,7 @@ module Google
         attr_accessor :data_source
       
         # The fields that should be updated. At least one field must be specified. The
-        # root 'dataSource' is implied and should not be specified. A single `"*"` can
+        # root `dataSource` is implied and should not be specified. A single `"*"` can
         # be used as short-hand for listing every field.
         # Corresponds to the JSON property `fields`
         # @return [String]
@@ -10108,7 +10190,15 @@ module Google
       class UpdateDataSourceResponse
         include Google::Apis::Core::Hashable
       
-        # The data execution status.
+        # The data execution status. A data execution is created to sync a data source
+        # object with the latest data from a DataSource. It is usually scheduled to run
+        # at background, you can check its state to tell if an execution completes There
+        # are several scenarios where a data execution is triggered to run: * Adding a
+        # data source creates an associated data source sheet as well as a data
+        # execution to sync the data from the data source to the sheet. * Updating a
+        # data source creates a data execution to refresh the associated data source
+        # sheet similarly. * You can send refresh request to explicitly refresh one or
+        # multiple data source objects.
         # Corresponds to the JSON property `dataExecutionStatus`
         # @return [Google::Apis::SheetsV4::DataExecutionStatus]
         attr_accessor :data_execution_status
@@ -10225,7 +10315,7 @@ module Google
       class UpdateDimensionPropertiesRequest
         include Google::Apis::Core::Hashable
       
-        # A range along a single dimension on a DataSource sheet.
+        # A range along a single dimension on a DATA_SOURCE sheet.
         # Corresponds to the JSON property `dataSourceSheetRange`
         # @return [Google::Apis::SheetsV4::DataSourceSheetDimensionRange]
         attr_accessor :data_source_sheet_range