google-api-client 0.44.2 → 0.46.2

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

@@ -142,6 +142,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ConsumerConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ConsumerConfigMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ConsumerProject
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -773,6 +785,28 @@ module Google
         end
       end
       
+      class ConsumerConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_export_custom_routes, as: 'consumerExportCustomRoutes'
+          property :consumer_export_subnet_routes_with_public_ip, as: 'consumerExportSubnetRoutesWithPublicIp'
+          property :consumer_import_custom_routes, as: 'consumerImportCustomRoutes'
+          property :consumer_import_subnet_routes_with_public_ip, as: 'consumerImportSubnetRoutesWithPublicIp'
+          property :producer_export_custom_routes, as: 'producerExportCustomRoutes'
+          property :producer_export_subnet_routes_with_public_ip, as: 'producerExportSubnetRoutesWithPublicIp'
+          property :producer_import_custom_routes, as: 'producerImportCustomRoutes'
+          property :producer_import_subnet_routes_with_public_ip, as: 'producerImportSubnetRoutesWithPublicIp'
+          property :producer_network, as: 'producerNetwork'
+          collection :reserved_ranges, as: 'reservedRanges'
+        end
+      end
+      
+      class ConsumerConfigMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class ConsumerProject
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -816,8 +816,8 @@ module Google
         
         # Service producers can use this method to add roles in the shared VPC host
         # project. Each role is bound to the provided member. Each role must be selected
-        # from within a whitelisted set of roles. Each role is applied at only the
-        # granularity specified in the whitelist.
+        # from within an allowlisted set of roles. Each role is applied at only the
+        # granularity specified in the allowlist.
         # @param [String] parent
         #   Required. This is in a form services/`service` where `service` is the name of
         #   the private access management service. For example 'service-peering.example.

data/generated/google/apis/servicenetworking_v1beta.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
     module ServicenetworkingV1beta
       VERSION = 'V1beta'
-      REVISION = '20200819'
+      REVISION = '20201015'
 
       # 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_v1beta/classes.rb

@@ -414,7 +414,8 @@ module Google
       class AuthenticationRule
         include Google::Apis::Core::Hashable
       
-        # If true, the service accepts API keys without any other credential.
+        # If true, the service accepts API keys without any other credential. This flag
+        # only applies to HTTP and gRPC requests.
         # Corresponds to the JSON property `allowWithoutCredential`
         # @return [Boolean]
         attr_accessor :allow_without_credential
@@ -684,12 +685,114 @@ module Google
         end
       end
       
+      # Configuration information for a private service access connection.
+      class ConsumerConfig
+        include Google::Apis::Core::Hashable
+      
+        # Export custom routes flag value for peering from consumer to producer.
+        # Corresponds to the JSON property `consumerExportCustomRoutes`
+        # @return [Boolean]
+        attr_accessor :consumer_export_custom_routes
+        alias_method :consumer_export_custom_routes?, :consumer_export_custom_routes
+      
+        # Export subnet routes with public ip flag value for peering from consumer to
+        # producer.
+        # Corresponds to the JSON property `consumerExportSubnetRoutesWithPublicIp`
+        # @return [Boolean]
+        attr_accessor :consumer_export_subnet_routes_with_public_ip
+        alias_method :consumer_export_subnet_routes_with_public_ip?, :consumer_export_subnet_routes_with_public_ip
+      
+        # Import custom routes flag value for peering from consumer to producer.
+        # Corresponds to the JSON property `consumerImportCustomRoutes`
+        # @return [Boolean]
+        attr_accessor :consumer_import_custom_routes
+        alias_method :consumer_import_custom_routes?, :consumer_import_custom_routes
+      
+        # Import subnet routes with public ip flag value for peering from consumer to
+        # producer.
+        # Corresponds to the JSON property `consumerImportSubnetRoutesWithPublicIp`
+        # @return [Boolean]
+        attr_accessor :consumer_import_subnet_routes_with_public_ip
+        alias_method :consumer_import_subnet_routes_with_public_ip?, :consumer_import_subnet_routes_with_public_ip
+      
+        # Export custom routes flag value for peering from producer to consumer.
+        # Corresponds to the JSON property `producerExportCustomRoutes`
+        # @return [Boolean]
+        attr_accessor :producer_export_custom_routes
+        alias_method :producer_export_custom_routes?, :producer_export_custom_routes
+      
+        # Export subnet routes with public ip flag value for peering from producer to
+        # consumer.
+        # Corresponds to the JSON property `producerExportSubnetRoutesWithPublicIp`
+        # @return [Boolean]
+        attr_accessor :producer_export_subnet_routes_with_public_ip
+        alias_method :producer_export_subnet_routes_with_public_ip?, :producer_export_subnet_routes_with_public_ip
+      
+        # Import custom routes flag value for peering from producer to consumer.
+        # Corresponds to the JSON property `producerImportCustomRoutes`
+        # @return [Boolean]
+        attr_accessor :producer_import_custom_routes
+        alias_method :producer_import_custom_routes?, :producer_import_custom_routes
+      
+        # Import subnet routes with public ip flag value for peering from producer to
+        # consumer.
+        # Corresponds to the JSON property `producerImportSubnetRoutesWithPublicIp`
+        # @return [Boolean]
+        attr_accessor :producer_import_subnet_routes_with_public_ip
+        alias_method :producer_import_subnet_routes_with_public_ip?, :producer_import_subnet_routes_with_public_ip
+      
+        # Output only. The VPC host network that is used to host managed service
+        # instances. In the format, projects/`project`/global/networks/`network` where `
+        # project` is the project number e.g. '12345' and `network` is the network name.
+        # Corresponds to the JSON property `producerNetwork`
+        # @return [String]
+        attr_accessor :producer_network
+      
+        # Output only. The name of the allocated IP address ranges for this private
+        # service access connection.
+        # Corresponds to the JSON property `reservedRanges`
+        # @return [Array<String>]
+        attr_accessor :reserved_ranges
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consumer_export_custom_routes = args[:consumer_export_custom_routes] if args.key?(:consumer_export_custom_routes)
+          @consumer_export_subnet_routes_with_public_ip = args[:consumer_export_subnet_routes_with_public_ip] if args.key?(:consumer_export_subnet_routes_with_public_ip)
+          @consumer_import_custom_routes = args[:consumer_import_custom_routes] if args.key?(:consumer_import_custom_routes)
+          @consumer_import_subnet_routes_with_public_ip = args[:consumer_import_subnet_routes_with_public_ip] if args.key?(:consumer_import_subnet_routes_with_public_ip)
+          @producer_export_custom_routes = args[:producer_export_custom_routes] if args.key?(:producer_export_custom_routes)
+          @producer_export_subnet_routes_with_public_ip = args[:producer_export_subnet_routes_with_public_ip] if args.key?(:producer_export_subnet_routes_with_public_ip)
+          @producer_import_custom_routes = args[:producer_import_custom_routes] if args.key?(:producer_import_custom_routes)
+          @producer_import_subnet_routes_with_public_ip = args[:producer_import_subnet_routes_with_public_ip] if args.key?(:producer_import_subnet_routes_with_public_ip)
+          @producer_network = args[:producer_network] if args.key?(:producer_network)
+          @reserved_ranges = args[:reserved_ranges] if args.key?(:reserved_ranges)
+        end
+      end
+      
+      # Metadata provided through GetOperation request for the LRO generated by
+      # UpdateConsumerConfig API.
+      class ConsumerConfigMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # `Context` defines which contexts an API requests. Example: context: rules: -
       # selector: "*" requested: - google.rpc.context.ProjectContext - google.rpc.
       # context.OriginContext The above specifies that all methods in the API request `
       # google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`.
       # Available context types are defined in package `google.rpc.context`. This also
-      # provides mechanism to whitelist any protobuf message extension that can be
+      # provides mechanism to allowlist any protobuf message extension that can be
       # sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format.
       # For example, list any service specific protobuf types that can appear in grpc
       # metadata as follows in your yaml file: Example: context: rules: - selector: "
@@ -2453,7 +2556,7 @@ module Google
         # @return [String]
         attr_accessor :member
       
-        # Required. Role to apply. Only whitelisted roles can be used at the specified
+        # Required. Role to apply. Only allowlisted roles can be used at the specified
         # granularity. The role must be one of the following: - 'roles/container.
         # hostServiceAgentUser' applied on the shared VPC host project - 'roles/compute.
         # securityAdmin' applied on the shared VPC host project
@@ -2845,7 +2948,7 @@ module Google
         # context.OriginContext The above specifies that all methods in the API request `
         # google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`.
         # Available context types are defined in package `google.rpc.context`. This also
-        # provides mechanism to whitelist any protobuf message extension that can be
+        # provides mechanism to allowlist any protobuf message extension that can be
         # sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format.
         # For example, list any service specific protobuf types that can appear in grpc
         # metadata as follows in your yaml file: Example: context: rules: - selector: "

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

@@ -118,6 +118,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ConsumerConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ConsumerConfigMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Context
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -643,6 +655,28 @@ module Google
         end
       end
       
+      class ConsumerConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :consumer_export_custom_routes, as: 'consumerExportCustomRoutes'
+          property :consumer_export_subnet_routes_with_public_ip, as: 'consumerExportSubnetRoutesWithPublicIp'
+          property :consumer_import_custom_routes, as: 'consumerImportCustomRoutes'
+          property :consumer_import_subnet_routes_with_public_ip, as: 'consumerImportSubnetRoutesWithPublicIp'
+          property :producer_export_custom_routes, as: 'producerExportCustomRoutes'
+          property :producer_export_subnet_routes_with_public_ip, as: 'producerExportSubnetRoutesWithPublicIp'
+          property :producer_import_custom_routes, as: 'producerImportCustomRoutes'
+          property :producer_import_subnet_routes_with_public_ip, as: 'producerImportSubnetRoutesWithPublicIp'
+          property :producer_network, as: 'producerNetwork'
+          collection :reserved_ranges, as: 'reservedRanges'
+        end
+      end
+      
+      class ConsumerConfigMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Context
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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