google-api-client 0.44.0 → 0.46.0

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

@@ -199,8 +199,8 @@ module Google
         
         # Search tenancy units for a managed service.
         # @param [String] parent
-        #   Service for which search is performed. services/`service` `service` the name
-        #   of a service, for example 'service.googleapis.com'.
+        #   Required. Service for which search is performed. services/`service` `service`
+        #   the name of a service, for example 'service.googleapis.com'.
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results returned by this request. Currently,
         #   the default maximum is set to 1000. If `page_size` isn't provided or the size
@@ -251,14 +251,14 @@ 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
         # same tag. Operation.
         # @param [String] parent
-        #   Name of the tenancy unit. Such as 'services/service.googleapis.com/projects/
-        #   12345/tenancyUnits/abcd'.
+        #   Required. Name of the tenancy unit. Such as 'services/service.googleapis.com/
+        #   projects/12345/tenancyUnits/abcd'.
         # @param [Google::Apis::ServiceconsumermanagementV1::AddTenantProjectRequest] add_tenant_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -303,8 +303,8 @@ module Google
         # isn't supported. The operation fails if any of the steps fail, but no rollback
         # of already applied configuration changes is attempted. Operation.
         # @param [String] name
-        #   Name of the tenancy unit. Such as 'services/service.googleapis.com/projects/
-        #   12345/tenancyUnits/abcd'.
+        #   Required. Name of the tenancy unit. Such as 'services/service.googleapis.com/
+        #   projects/12345/tenancyUnits/abcd'.
         # @param [Google::Apis::ServiceconsumermanagementV1::ApplyTenantProjectConfigRequest] apply_tenant_project_config_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -345,8 +345,8 @@ module Google
         # of that project. These two requirements are already met if the project is
         # reserved by calling `AddTenantProject`. Operation.
         # @param [String] name
-        #   Name of the tenancy unit that the project will be attached to. Such as '
-        #   services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
+        #   Required. Name of the tenancy unit that the project will be attached to. Such
+        #   as 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
         # @param [Google::Apis::ServiceconsumermanagementV1::AttachTenantProjectRequest] attach_tenant_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -382,11 +382,12 @@ module Google
         # not have tenant_resources field set and ListTenancyUnits has to be used to get
         # a complete TenancyUnit with all fields populated.
         # @param [String] parent
-        #   services/`service`/`collection id`/`resource id` `collection id` is the cloud
-        #   resource collection type representing the service consumer, for example '
-        #   projects', or 'organizations'. `resource id` is the consumer numeric id, such
-        #   as project number: '123456'. `service` the name of a managed service, such as '
-        #   service.googleapis.com'. Enables service binding using the new tenancy unit.
+        #   Required. services/`service`/`collection id`/`resource id` `collection id` is
+        #   the cloud resource collection type representing the service consumer, for
+        #   example 'projects', or 'organizations'. `resource id` is the consumer numeric
+        #   id, such as project number: '123456'. `service` the name of a managed service,
+        #   such as 'service.googleapis.com'. Enables service binding using the new
+        #   tenancy unit.
         # @param [Google::Apis::ServiceconsumermanagementV1::CreateTenancyUnitRequest] create_tenancy_unit_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -420,7 +421,7 @@ module Google
         # Delete a tenancy unit. Before you delete the tenancy unit, there should be no
         # tenant resources in it that aren't in a DELETED state. Operation.
         # @param [String] name
-        #   Name of the tenancy unit to be deleted.
+        #   Required. Name of the tenancy unit to be deleted.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -456,8 +457,8 @@ module Google
         # call the `RemoveTenantProject` method. New resources with the same tag can't
         # be added if there are existing resources in a DELETED state. Operation.
         # @param [String] name
-        #   Name of the tenancy unit. Such as 'services/service.googleapis.com/projects/
-        #   12345/tenancyUnits/abcd'.
+        #   Required. Name of the tenancy unit. Such as 'services/service.googleapis.com/
+        #   projects/12345/tenancyUnits/abcd'.
         # @param [Google::Apis::ServiceconsumermanagementV1::DeleteTenantProjectRequest] delete_tenant_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -493,18 +494,19 @@ module Google
         # the tenant project number when creating VMs. Service producers must persist
         # the tenant project's information after the project is created.
         # @param [String] parent
-        #   Managed service and service consumer. Required. services/`service`/`collection
-        #   id`/`resource id` `collection id` is the cloud resource collection type
-        #   representing the service consumer, for example 'projects', or 'organizations'.
-        #   `resource id` is the consumer numeric id, such as project number: '123456'. `
-        #   service` the name of a service, such as 'service.googleapis.com'.
+        #   Required. Managed service and service consumer. Required. services/`service`/`
+        #   collection id`/`resource id` `collection id` is the cloud resource collection
+        #   type representing the service consumer, for example 'projects', or '
+        #   organizations'. `resource id` is the consumer numeric id, such as project
+        #   number: '123456'. `service` the name of a service, such as 'service.googleapis.
+        #   com'.
         # @param [String] filter
-        #   Filter expression over tenancy resources field. Optional.
+        #   Optional. Filter expression over tenancy resources field. Optional.
         # @param [Fixnum] page_size
-        #   The maximum number of results returned by this request.
+        #   Optional. The maximum number of results returned by this request.
         # @param [String] page_token
-        #   The continuation token, which is used to page through large result sets. To
-        #   get the next page of results, set this parameter to the value of `
+        #   Optional. The continuation token, which is used to page through large result
+        #   sets. To get the next page of results, set this parameter to the value of `
         #   nextPageToken` from the previous response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -544,8 +546,8 @@ module Google
         # DELETED state, resource metadata is permanently removed from the tenancy unit.
         # Operation.
         # @param [String] name
-        #   Name of the tenancy unit. Such as 'services/service.googleapis.com/projects/
-        #   12345/tenancyUnits/abcd'.
+        #   Required. Name of the tenancy unit. Such as 'services/service.googleapis.com/
+        #   projects/12345/tenancyUnits/abcd'.
         # @param [Google::Apis::ServiceconsumermanagementV1::RemoveTenantProjectRequest] remove_tenant_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -582,8 +584,8 @@ module Google
         # method to update its configuration and then validate all managed service
         # resources. Operation.
         # @param [String] name
-        #   Name of the tenancy unit. Such as 'services/service.googleapis.com/projects/
-        #   12345/tenancyUnits/abcd'.
+        #   Required. Name of the tenancy unit. Such as 'services/service.googleapis.com/
+        #   projects/12345/tenancyUnits/abcd'.
         # @param [Google::Apis::ServiceconsumermanagementV1::UndeleteTenantProjectRequest] undelete_tenant_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/servicecontrol_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-control/
     module ServicecontrolV1
       VERSION = 'V1'
-      REVISION = '20200814'
+      REVISION = '20200917'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -390,9 +390,11 @@ module Google
         attr_accessor :authority_selector
       
         # The email address of the authenticated user (or service account on behalf of
-        # third party principal) making the request. For privacy reasons, the principal
-        # email address is redacted for all read-only operations that fail with a "
-        # permission denied" error.
+        # third party principal) making the request. For third party identity callers,
+        # the `principal_subject` field is populated instead of this field. For privacy
+        # reasons, the principal email address is sometimes redacted. For more
+        # information, see [Caller identities in audit logs](https://cloud.google.com/
+        # logging/docs/audit#user-id).
         # Corresponds to the JSON property `principalEmail`
         # @return [String]
         attr_accessor :principal_email
@@ -2079,7 +2081,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The identifier of the parent of this resource instance. Must be in one of the
-        # following formats: - “projects/” - “folders/” - “organizations/”
+        # following formats: - `projects/` - `folders/` - `organizations/`
         # Corresponds to the JSON property `resourceContainer`
         # @return [String]
         attr_accessor :resource_container

data/generated/google/apis/servicecontrol_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-control/
     module ServicecontrolV2
       VERSION = 'V2'
-      REVISION = '20200808'
+      REVISION = '20200917'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -361,9 +361,11 @@ module Google
         attr_accessor :authority_selector
       
         # The email address of the authenticated user (or service account on behalf of
-        # third party principal) making the request. For privacy reasons, the principal
-        # email address is redacted for all read-only operations that fail with a "
-        # permission denied" error.
+        # third party principal) making the request. For third party identity callers,
+        # the `principal_subject` field is populated instead of this field. For privacy
+        # reasons, the principal email address is sometimes redacted. For more
+        # information, see [Caller identities in audit logs](https://cloud.google.com/
+        # logging/docs/audit#user-id).
         # Corresponds to the JSON property `principalEmail`
         # @return [String]
         attr_accessor :principal_email

data/generated/google/apis/servicedirectory_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-directory
     module ServicedirectoryV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200803'
+      REVISION = '20200826'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -26,6 +26,12 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
+        # A client-specified ID for this binding. Expected to be globally unique to
+        # support the internal bindings-by-ID API.
+        # Corresponds to the JSON property `bindingId`
+        # @return [String]
+        attr_accessor :binding_id
+      
         # Represents a textual expression in the Common Expression Language (CEL) syntax.
         # CEL is a C-like expression language. The syntax and semantics of CEL are
         # documented at https://github.com/google/cel-spec. Example (Comparison): title:
@@ -87,6 +93,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @binding_id = args[:binding_id] if args.key?(:binding_id)
           @condition = args[:condition] if args.key?(:condition)
           @members = args[:members] if args.key?(:members)
           @role = args[:role] if args.key?(:role)

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

@@ -139,6 +139,7 @@ module Google
       class Binding
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :binding_id, as: 'bindingId'
           property :condition, as: 'condition', class: Google::Apis::ServicedirectoryV1beta1::Expr, decorator: Google::Apis::ServicedirectoryV1beta1::Expr::Representation
       
           collection :members, as: 'members'

data/generated/google/apis/servicemanagement_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/service-management/
     module ServicemanagementV1
       VERSION = 'V1'
-      REVISION = '20200824'
+      REVISION = '20200918'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -1019,28 +1019,6 @@ module Google
         end
       end
       
-      # Request message for DisableService method.
-      class DisableServiceRequest
-        include Google::Apis::Core::Hashable
-      
-        # Required. The identity of consumer resource which service disablement will be
-        # applied to. The Google Service Management implementation accepts the following
-        # forms: - "project:" Note: this is made compatible with google.api.
-        # servicecontrol.v1.Operation.consumer_id.
-        # Corresponds to the JSON property `consumerId`
-        # @return [String]
-        attr_accessor :consumer_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @consumer_id = args[:consumer_id] if args.key?(:consumer_id)
-        end
-      end
-      
       # Operation payload for DisableService method.
       class DisableServiceResponse
         include Google::Apis::Core::Hashable

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

@@ -178,12 +178,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class DisableServiceRequest
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class DisableServiceResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -812,13 +806,6 @@ module Google
         end
       end
       
-      class DisableServiceRequest
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :consumer_id, as: 'consumerId'
-        end
-      end
-      
       class DisableServiceResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -198,42 +198,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Disables a service for a project, so it can no longer be be used for the
-        # project. It prevents accidental usage that may cause unexpected billing
-        # charges or security leaks. Operation
-        # @param [String] service_name
-        #   Required. Name of the service to disable. Specifying an unknown service name
-        #   will cause the request to fail.
-        # @param [Google::Apis::ServicemanagementV1::DisableServiceRequest] disable_service_request_object
-        # @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::ServicemanagementV1::Operation] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::ServicemanagementV1::Operation]
-        #
-        # @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 disable_service(service_name, disable_service_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v1/services/{serviceName}:disable', options)
-          command.request_representation = Google::Apis::ServicemanagementV1::DisableServiceRequest::Representation
-          command.request_object = disable_service_request_object
-          command.response_representation = Google::Apis::ServicemanagementV1::Operation::Representation
-          command.response_class = Google::Apis::ServicemanagementV1::Operation
-          command.params['serviceName'] = service_name unless service_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
-        
         # Enables a service for a project, so it can be used for the project. See [Cloud
         # Auth Guide](https://cloud.google.com/docs/authentication) for more information.
         # Operation

data/generated/google/apis/servicenetworking_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
     module ServicenetworkingV1
       VERSION = 'V1'
-      REVISION = '20200822'
+      REVISION = '20200908'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -246,14 +246,6 @@ module Google
         # @return [Fixnum]
         attr_accessor :ip_prefix_length
       
-        # Optional. The private IPv6 google access type for the VMs in this subnet. For
-        # information about the access types that can be set using this field, see [
-        # subnetwork](/compute/docs/reference/rest/v1/subnetworks) in the Compute API
-        # documentation.
-        # Corresponds to the JSON property `privateIpv6GoogleAccess`
-        # @return [String]
-        attr_accessor :private_ipv6_google_access
-      
         # Required. The name of a [region](/compute/docs/regions-zones) for the subnet,
         # such `europe-west1`.
         # Corresponds to the JSON property `region`
@@ -292,7 +284,6 @@ module Google
           @consumer_network = args[:consumer_network] if args.key?(:consumer_network)
           @description = args[:description] if args.key?(:description)
           @ip_prefix_length = args[:ip_prefix_length] if args.key?(:ip_prefix_length)
-          @private_ipv6_google_access = args[:private_ipv6_google_access] if args.key?(:private_ipv6_google_access)
           @region = args[:region] if args.key?(:region)
           @requested_address = args[:requested_address] if args.key?(:requested_address)
           @subnetwork = args[:subnetwork] if args.key?(:subnetwork)

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

@@ -651,7 +651,6 @@ module Google
           property :consumer_network, as: 'consumerNetwork'
           property :description, as: 'description'
           property :ip_prefix_length, as: 'ipPrefixLength'
-          property :private_ipv6_google_access, as: 'privateIpv6GoogleAccess'
           property :region, as: 'region'
           property :requested_address, as: 'requestedAddress'
           property :subnetwork, as: 'subnetwork'

data/generated/google/apis/sheets_v4.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/sheets/
     module SheetsV4
       VERSION = 'V4'
-      REVISION = '20200825'
+      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
@@ -9032,7 +9114,7 @@ module Google
       class SpreadsheetTheme
         include Google::Apis::Core::Hashable
       
-        # / Name of the primary font family.
+        # Name of the primary font family.
         # Corresponds to the JSON property `primaryFontFamily`
         # @return [String]
         attr_accessor :primary_font_family
@@ -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