google-api-client 0.20.1 → 0.21.2

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

@@ -195,6 +195,27 @@ module Google
         end
       end
       
+      # 
+      class Clustering
+        include Google::Apis::Core::Hashable
+      
+        # [Repeated] One or more fields on which data should be clustered. Only top-
+        # level, non-repeated, simple-type fields are supported. The order of the fields
+        # will determine how clusters will be generated, so it is important.
+        # Corresponds to the JSON property `fields`
+        # @return [Array<String>]
+        attr_accessor :fields
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @fields = args[:fields] if args.key?(:fields)
+        end
+      end
+      
       # 
       class CsvOptions
         include Google::Apis::Core::Hashable
@@ -349,7 +370,7 @@ module Google
         attr_accessor :last_modified_time
       
         # The geographic location where the dataset should reside. The default value is
-        # US.
+        # US. See details at https://cloud.google.com/bigquery/docs/dataset-locations.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -679,7 +700,7 @@ module Google
         # @return [Float]
         attr_accessor :compute_ratio_max
       
-        # Stage end time in milliseconds.
+        # Stage end time represented as milliseconds since epoch.
         # Corresponds to the JSON property `endMs`
         # @return [Fixnum]
         attr_accessor :end_ms
@@ -744,7 +765,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :shuffle_output_bytes_spilled
       
-        # Stage start time in milliseconds.
+        # Stage start time represented as milliseconds since epoch.
         # Corresponds to the JSON property `startMs`
         # @return [Fixnum]
         attr_accessor :start_ms
@@ -1095,6 +1116,12 @@ module Google
       class GoogleSheetsOptions
         include Google::Apis::Core::Hashable
       
+        # [Experimental] [Optional] Range of a sheet to query from. Only used when non-
+        # empty. Typical format: !:
+        # Corresponds to the JSON property `range`
+        # @return [String]
+        attr_accessor :range
+      
         # [Optional] The number of rows at the top of a sheet that BigQuery will skip
         # when reading the data. The default value is 0. This property is useful if you
         # have header rows that should be skipped. When autodetect is on, behavior is
@@ -1116,6 +1143,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @range = args[:range] if args.key?(:range)
           @skip_leading_rows = args[:skip_leading_rows] if args.key?(:skip_leading_rows)
         end
       end
@@ -1362,13 +1390,20 @@ module Google
         attr_accessor :allow_quoted_newlines
         alias_method :allow_quoted_newlines?, :allow_quoted_newlines
       
-        # Indicates if we should automatically infer the options and schema for CSV and
-        # JSON sources.
+        # [Optional] Indicates if we should automatically infer the options and schema
+        # for CSV and JSON sources.
         # Corresponds to the JSON property `autodetect`
         # @return [Boolean]
         attr_accessor :autodetect
         alias_method :autodetect?, :autodetect
       
+        # [Experimental] Clustering specification for the destination table. Must be
+        # specified with time-based partitioning, data in the table will be first
+        # partitioned and subsequently clustered.
+        # Corresponds to the JSON property `clustering`
+        # @return [Google::Apis::BigqueryV2::Clustering]
+        attr_accessor :clustering
+      
         # [Optional] Specifies whether the job is allowed to create new tables. The
         # following values are supported: CREATE_IF_NEEDED: If the table does not exist,
         # BigQuery creates the table. CREATE_NEVER: The table must already exist. If it
@@ -1520,7 +1555,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :source_uris
       
-        # If specified, configures time-based partitioning for the destination table.
+        # Time-based partitioning specification for the destination table.
         # Corresponds to the JSON property `timePartitioning`
         # @return [Google::Apis::BigqueryV2::TimePartitioning]
         attr_accessor :time_partitioning
@@ -1546,6 +1581,7 @@ module Google
           @allow_jagged_rows = args[:allow_jagged_rows] if args.key?(:allow_jagged_rows)
           @allow_quoted_newlines = args[:allow_quoted_newlines] if args.key?(:allow_quoted_newlines)
           @autodetect = args[:autodetect] if args.key?(:autodetect)
+          @clustering = args[:clustering] if args.key?(:clustering)
           @create_disposition = args[:create_disposition] if args.key?(:create_disposition)
           @destination_encryption_configuration = args[:destination_encryption_configuration] if args.key?(:destination_encryption_configuration)
           @destination_table = args[:destination_table] if args.key?(:destination_table)
@@ -1583,6 +1619,13 @@ module Google
         attr_accessor :allow_large_results
         alias_method :allow_large_results?, :allow_large_results
       
+        # [Experimental] Clustering specification for the destination table. Must be
+        # specified with time-based partitioning, data in the table will be first
+        # partitioned and subsequently clustered.
+        # Corresponds to the JSON property `clustering`
+        # @return [Google::Apis::BigqueryV2::Clustering]
+        attr_accessor :clustering
+      
         # [Optional] Specifies whether the job is allowed to create new tables. The
         # following values are supported: CREATE_IF_NEEDED: If the table does not exist,
         # BigQuery creates the table. CREATE_NEVER: The table must already exist. If it
@@ -1683,7 +1726,7 @@ module Google
         # @return [Hash<String,Google::Apis::BigqueryV2::ExternalDataConfiguration>]
         attr_accessor :table_definitions
       
-        # If specified, configures time-based partitioning for the destination table.
+        # Time-based partitioning specification for the destination table.
         # Corresponds to the JSON property `timePartitioning`
         # @return [Google::Apis::BigqueryV2::TimePartitioning]
         attr_accessor :time_partitioning
@@ -1732,6 +1775,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @allow_large_results = args[:allow_large_results] if args.key?(:allow_large_results)
+          @clustering = args[:clustering] if args.key?(:clustering)
           @create_disposition = args[:create_disposition] if args.key?(:create_disposition)
           @default_dataset = args[:default_dataset] if args.key?(:default_dataset)
           @destination_encryption_configuration = args[:destination_encryption_configuration] if args.key?(:destination_encryption_configuration)
@@ -1933,7 +1977,8 @@ module Google
         attr_accessor :job_id
       
         # [Experimental] The geographic location of the job. Required except for US and
-        # EU.
+        # EU. See details at https://cloud.google.com/bigquery/docs/dataset-locations#
+        # specifying_your_location.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -2780,6 +2825,13 @@ module Google
       class Table
         include Google::Apis::Core::Hashable
       
+        # [Experimental] Clustering specification for the table. Must be specified with
+        # time-based partitioning, data in the table will be first partitioned and
+        # subsequently clustered.
+        # Corresponds to the JSON property `clustering`
+        # @return [Google::Apis::BigqueryV2::Clustering]
+        attr_accessor :clustering
+      
         # [Output-only] The time when this table was created, in milliseconds since the
         # epoch.
         # Corresponds to the JSON property `creationTime`
@@ -2893,7 +2945,7 @@ module Google
         # @return [Google::Apis::BigqueryV2::TableReference]
         attr_accessor :table_reference
       
-        # If specified, configures time-based partitioning for this table.
+        # Time-based partitioning specification for this table.
         # Corresponds to the JSON property `timePartitioning`
         # @return [Google::Apis::BigqueryV2::TimePartitioning]
         attr_accessor :time_partitioning
@@ -2917,6 +2969,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @clustering = args[:clustering] if args.key?(:clustering)
           @creation_time = args[:creation_time] if args.key?(:creation_time)
           @description = args[:description] if args.key?(:description)
           @encryption_configuration = args[:encryption_configuration] if args.key?(:encryption_configuration)
@@ -3232,6 +3285,11 @@ module Google
         class Table
           include Google::Apis::Core::Hashable
         
+          # [Experimental] Clustering specification for this table, if configured.
+          # Corresponds to the JSON property `clustering`
+          # @return [Google::Apis::BigqueryV2::Clustering]
+          attr_accessor :clustering
+        
           # The time when this table was created, in milliseconds since the epoch.
           # Corresponds to the JSON property `creationTime`
           # @return [Fixnum]
@@ -3270,7 +3328,7 @@ module Google
           # @return [Google::Apis::BigqueryV2::TableReference]
           attr_accessor :table_reference
         
-          # The time-based partitioning for this table.
+          # The time-based partitioning specification for this table, if configured.
           # Corresponds to the JSON property `timePartitioning`
           # @return [Google::Apis::BigqueryV2::TimePartitioning]
           attr_accessor :time_partitioning
@@ -3291,6 +3349,7 @@ module Google
         
           # Update properties of this object
           def update!(**args)
+            @clustering = args[:clustering] if args.key?(:clustering)
             @creation_time = args[:creation_time] if args.key?(:creation_time)
             @expiration_time = args[:expiration_time] if args.key?(:expiration_time)
             @friendly_name = args[:friendly_name] if args.key?(:friendly_name)
@@ -3399,16 +3458,18 @@ module Google
       class TimePartitioning
         include Google::Apis::Core::Hashable
       
-        # [Optional] Number of milliseconds for which to keep the storage for a
-        # partition.
+        # [Optional] Number of milliseconds for which to keep the storage for partitions
+        # in the table. The storage in a partition will have an expiration time of its
+        # partition time plus this value.
         # Corresponds to the JSON property `expirationMs`
         # @return [Fixnum]
         attr_accessor :expiration_ms
       
         # [Experimental] [Optional] If not set, the table is partitioned by pseudo
-        # column '_PARTITIONTIME'; if set, the table is partitioned by this field. The
-        # field must be a top-level TIMESTAMP or DATE field. Its mode must be NULLABLE
-        # or REQUIRED.
+        # column, referenced via either '_PARTITIONTIME' as TIMESTAMP type, or '
+        # _PARTITIONDATE' as DATE type. If field is specified, the table is instead
+        # partitioned by this field. The field must be a top-level TIMESTAMP or DATE
+        # field. Its mode must be NULLABLE or REQUIRED.
         # Corresponds to the JSON property `field`
         # @return [String]
         attr_accessor :field

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

@@ -40,6 +40,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Clustering
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CsvOptions
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -422,6 +428,13 @@ module Google
         end
       end
       
+      class Clustering
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :fields, as: 'fields'
+        end
+      end
+      
       class CsvOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -622,6 +635,7 @@ module Google
       class GoogleSheetsOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :range, as: 'range'
           property :skip_leading_rows, :numeric_string => true, as: 'skipLeadingRows'
         end
       end
@@ -691,6 +705,8 @@ module Google
           property :allow_jagged_rows, as: 'allowJaggedRows'
           property :allow_quoted_newlines, as: 'allowQuotedNewlines'
           property :autodetect, as: 'autodetect'
+          property :clustering, as: 'clustering', class: Google::Apis::BigqueryV2::Clustering, decorator: Google::Apis::BigqueryV2::Clustering::Representation
+      
           property :create_disposition, as: 'createDisposition'
           property :destination_encryption_configuration, as: 'destinationEncryptionConfiguration', class: Google::Apis::BigqueryV2::EncryptionConfiguration, decorator: Google::Apis::BigqueryV2::EncryptionConfiguration::Representation
       
@@ -723,6 +739,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :allow_large_results, as: 'allowLargeResults'
+          property :clustering, as: 'clustering', class: Google::Apis::BigqueryV2::Clustering, decorator: Google::Apis::BigqueryV2::Clustering::Representation
+      
           property :create_disposition, as: 'createDisposition'
           property :default_dataset, as: 'defaultDataset', class: Google::Apis::BigqueryV2::DatasetReference, decorator: Google::Apis::BigqueryV2::DatasetReference::Representation
       
@@ -1020,6 +1038,8 @@ module Google
       class Table
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :clustering, as: 'clustering', class: Google::Apis::BigqueryV2::Clustering, decorator: Google::Apis::BigqueryV2::Clustering::Representation
+      
           property :creation_time, :numeric_string => true, as: 'creationTime'
           property :description, as: 'description'
           property :encryption_configuration, as: 'encryptionConfiguration', class: Google::Apis::BigqueryV2::EncryptionConfiguration, decorator: Google::Apis::BigqueryV2::EncryptionConfiguration::Representation
@@ -1135,6 +1155,8 @@ module Google
         class Table
           # @private
           class Representation < Google::Apis::Core::JsonRepresentation
+            property :clustering, as: 'clustering', class: Google::Apis::BigqueryV2::Clustering, decorator: Google::Apis::BigqueryV2::Clustering::Representation
+        
             property :creation_time, :numeric_string => true, as: 'creationTime'
             property :expiration_time, :numeric_string => true, as: 'expirationTime'
             property :friendly_name, as: 'friendlyName'

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

@@ -38,14 +38,12 @@ module Google
         attr_accessor :key
 
         # @return [String]
-        #  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.
-        #  Overrides userIp if both are provided.
+        #  An opaque string that represents a user for quota purposes. Must not exceed 40
+        #  characters.
         attr_accessor :quota_user
 
         # @return [String]
-        #  IP address of the site where the request originates. Use this if you want to
-        #  enforce per-user limits.
+        #  Deprecated. Please use quotaUser instead.
         attr_accessor :user_ip
 
         def initialize
@@ -67,12 +65,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -104,12 +100,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -141,12 +135,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -190,12 +182,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -235,12 +225,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -278,12 +266,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -323,12 +309,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -367,12 +351,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -419,12 +401,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -461,12 +441,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [IO, String] upload_source
         #   IO stream or filename containing content to upload
         # @param [String] content_type
@@ -527,12 +505,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -571,12 +547,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -609,12 +583,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -646,12 +618,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -688,12 +658,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -741,12 +709,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -787,12 +753,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -831,12 +795,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -872,12 +834,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -916,12 +876,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -961,12 +919,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -1007,12 +963,10 @@ module Google
         # @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.
-        #   Overrides userIp if both are provided.
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
         # @param [String] user_ip
-        #   IP address of the site where the request originates. Use this if you want to
-        #   enforce per-user limits.
+        #   Deprecated. Please use quotaUser instead.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #