google-api-client 0.39.1 → 0.40.0

data/generated/google/apis/bigquery_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryV2
       VERSION = 'V2'
-      REVISION = '20200429'
+      REVISION = '20200523'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'

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

@@ -2117,6 +2117,11 @@ module Google
         # @return [String]
         attr_accessor :compression
       
+        # [Optional, Trusted Tester] Connection for external data source.
+        # Corresponds to the JSON property `connectionId`
+        # @return [String]
+        attr_accessor :connection_id
+      
         # Additional properties to set if sourceFormat is set to CSV.
         # Corresponds to the JSON property `csvOptions`
         # @return [Google::Apis::BigqueryV2::CsvOptions]
@@ -2192,6 +2197,7 @@ module Google
           @autodetect = args[:autodetect] if args.key?(:autodetect)
           @bigtable_options = args[:bigtable_options] if args.key?(:bigtable_options)
           @compression = args[:compression] if args.key?(:compression)
+          @connection_id = args[:connection_id] if args.key?(:connection_id)
           @csv_options = args[:csv_options] if args.key?(:csv_options)
           @google_sheets_options = args[:google_sheets_options] if args.key?(:google_sheets_options)
           @hive_partitioning_options = args[:hive_partitioning_options] if args.key?(:hive_partitioning_options)
@@ -4678,6 +4684,15 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # The labels associated with this job. You can use these to organize and group
+        # your jobs. Label keys and values can be no longer than 63 characters, can only
+        # contain lowercase letters, numeric characters, underscores and dashes.
+        # International characters are allowed. Label values are optional. Label keys
+        # must start with a letter and each label in the list must have a different key.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
         # The geographic location where the job should run. See details at https://cloud.
         # google.com/bigquery/docs/locations#specifying_your_location.
         # Corresponds to the JSON property `location`
@@ -4693,6 +4708,13 @@ module Google
         # @return [Fixnum]
         attr_accessor :max_results
       
+        # [Optional] Limits the bytes billed for this job. Queries that will have bytes
+        # billed beyond this limit will fail (without incurring a charge). If
+        # unspecified, this will be set to your project default.
+        # Corresponds to the JSON property `maximumBytesBilled`
+        # @return [Fixnum]
+        attr_accessor :maximum_bytes_billed
+      
         # Standard SQL only. Set to POSITIONAL to use positional (?) query parameters or
         # to NAMED to use named (@myparam) query parameters in this query.
         # Corresponds to the JSON property `parameterMode`
@@ -4717,6 +4739,21 @@ module Google
         # @return [Array<Google::Apis::BigqueryV2::QueryParameter>]
         attr_accessor :query_parameters
       
+        # A unique user provided identifier to ensure idempotent behavior for queries.
+        # Note that this is different from the job_id. It has the following properties:
+        # 1. It is case-sensitive, limited to up to 36 ASCII characters. A UUID is
+        # recommended. 2. Read only queries can ignore this token since they are
+        # nullipotent by definition. 3. When a duplicate mutating query request is
+        # detected (i.e. having the same request_id as an earlier query), it returns: a.
+        # the results of the mutation if it completes successfully within the timeout. b.
+        # the running operation if it is still in progress at the end of the timeout. 4.
+        # Its lifetime is limited to 15 minutes. In other words, if two requests are
+        # sent with the same request_id, but more than 15 minutes apart, idempotency is
+        # not guaranteed.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
         # [Optional] How long to wait for the query to complete, in milliseconds, before
         # the request times out and returns. Note that this is only a timeout for the
         # request, not the query. If the query takes longer to run than the timeout
@@ -4755,12 +4792,15 @@ module Google
           @default_dataset = args[:default_dataset] if args.key?(:default_dataset)
           @dry_run = args[:dry_run] if args.key?(:dry_run)
           @kind = args[:kind] if args.key?(:kind)
+          @labels = args[:labels] if args.key?(:labels)
           @location = args[:location] if args.key?(:location)
           @max_results = args[:max_results] if args.key?(:max_results)
+          @maximum_bytes_billed = args[:maximum_bytes_billed] if args.key?(:maximum_bytes_billed)
           @parameter_mode = args[:parameter_mode] if args.key?(:parameter_mode)
           @preserve_nulls = args[:preserve_nulls] if args.key?(:preserve_nulls)
           @query = args[:query] if args.key?(:query)
           @query_parameters = args[:query_parameters] if args.key?(:query_parameters)
+          @request_id = args[:request_id] if args.key?(:request_id)
           @timeout_ms = args[:timeout_ms] if args.key?(:timeout_ms)
           @use_legacy_sql = args[:use_legacy_sql] if args.key?(:use_legacy_sql)
           @use_query_cache = args[:use_query_cache] if args.key?(:use_query_cache)
@@ -6675,7 +6715,12 @@ module Google
         end
       end
       
-      # 
+      # This is used for defining User Defined Function (UDF) resources only when
+      # using legacy SQL. Users of Standard SQL should leverage either DDL (e.g.
+      # CREATE [TEMPORARY] FUNCTION ... ) or the Routines API to define UDF resources.
+      # For additional information on migrating, see: https://cloud.google.com/
+      # bigquery/docs/reference/standard-sql/migrating-from-legacy-sql#
+      # differences_in_user-defined_javascript_functions
       class UserDefinedFunctionResource
         include Google::Apis::Core::Hashable
       

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

@@ -1267,6 +1267,7 @@ module Google
           property :bigtable_options, as: 'bigtableOptions', class: Google::Apis::BigqueryV2::BigtableOptions, decorator: Google::Apis::BigqueryV2::BigtableOptions::Representation
       
           property :compression, as: 'compression'
+          property :connection_id, as: 'connectionId'
           property :csv_options, as: 'csvOptions', class: Google::Apis::BigqueryV2::CsvOptions, decorator: Google::Apis::BigqueryV2::CsvOptions::Representation
       
           property :google_sheets_options, as: 'googleSheetsOptions', class: Google::Apis::BigqueryV2::GoogleSheetsOptions, decorator: Google::Apis::BigqueryV2::GoogleSheetsOptions::Representation
@@ -1876,13 +1877,16 @@ module Google
       
           property :dry_run, as: 'dryRun'
           property :kind, as: 'kind'
+          hash :labels, as: 'labels'
           property :location, as: 'location'
           property :max_results, as: 'maxResults'
+          property :maximum_bytes_billed, :numeric_string => true, as: 'maximumBytesBilled'
           property :parameter_mode, as: 'parameterMode'
           property :preserve_nulls, as: 'preserveNulls'
           property :query, as: 'query'
           collection :query_parameters, as: 'queryParameters', class: Google::Apis::BigqueryV2::QueryParameter, decorator: Google::Apis::BigqueryV2::QueryParameter::Representation
       
+          property :request_id, as: 'requestId'
           property :timeout_ms, as: 'timeoutMs'
           property :use_legacy_sql, as: 'useLegacySql'
           property :use_query_cache, as: 'useQueryCache'

data/generated/google/apis/bigqueryreservation_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryreservationV1
       VERSION = 'V1'
-      REVISION = '20200410'
+      REVISION = '20200519'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'

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

@@ -28,7 +28,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The resource which will use the reservation. E.g.
-        # projects/myproject, folders/123, organizations/456.
+        # `projects/myproject`, `folders/123`, or `organizations/456`.
         # Corresponds to the JSON property `assignee`
         # @return [String]
         attr_accessor :assignee
@@ -39,7 +39,7 @@ module Google
         attr_accessor :job_type
       
         # Output only. Name of the resource. E.g.:
-        # projects/myproject/locations/US/reservations/team1-prod/assignments/123.
+        # `projects/myproject/locations/US/reservations/team1-prod/assignments/123`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -98,8 +98,9 @@ module Google
       # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
       # (in the form of slots) with some committed period of usage. Annual
       # commitments renew by default. Commitments can be removed after their
-      # commitment end time passes. In order to remove annual commitment, its plan
-      # needs to be changed to monthly or flex first.
+      # commitment end time passes.
+      # In order to remove annual commitment, its plan needs to be changed
+      # to monthly or flex first.
       # A capacity commitment resource exists as a child resource of the admin
       # project.
       class CapacityCommitment
@@ -123,7 +124,7 @@ module Google
         attr_accessor :failure_status
       
         # Output only. The resource name of the capacity commitment, e.g.,
-        # projects/myproject/locations/US/capacityCommitments/123
+        # `projects/myproject/locations/US/capacityCommitments/123`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -135,7 +136,7 @@ module Google
       
         # The plan this capacity commitment is converted to after commitment_end_time
         # passes. Once the plan is changed, committed period is extended according to
-        # commitment plan. Only applicable for ANNUAL commitments.
+        # commitment plan. Only applicable for ANNUAL and TRIAL commitments.
         # Corresponds to the JSON property `renewalPlan`
         # @return [String]
         attr_accessor :renewal_plan
@@ -316,6 +317,8 @@ module Google
         # Ids of capacity commitments to merge.
         # These capacity commitments must exist under admin project and location
         # specified in the parent.
+        # ID is the last portion of capacity commitment name e.g., 'abc' for
+        # projects/myproject/locations/US/capacityCommitments/abc
         # Corresponds to the JSON property `capacityCommitmentIds`
         # @return [Array<String>]
         attr_accessor :capacity_commitment_ids
@@ -332,15 +335,16 @@ module Google
       
       # The request for
       # ReservationService.MoveAssignment.
-      # Note: "bigquery.reservationAssignments.create" permission is required on the
-      # destination_id. Note: "bigquery.reservationAssignments.create" and
-      # "bigquery.reservationAssignments.delete" permission is required on the
+      # **Note**: "bigquery.reservationAssignments.create" permission is required on
+      # the destination_id.
+      # **Note**: "bigquery.reservationAssignments.create" and
+      # "bigquery.reservationAssignments.delete" permission are required on the
       # related assignee.
       class MoveAssignmentRequest
         include Google::Apis::Core::Hashable
       
         # The new reservation ID, e.g.:
-        # projects/myotherproject/locations/US/reservations/team2-prod
+        # `projects/myotherproject/locations/US/reservations/team2-prod`
         # Corresponds to the JSON property `destinationId`
         # @return [String]
         attr_accessor :destination_id
@@ -432,7 +436,7 @@ module Google
         alias_method :ignore_idle_slots?, :ignore_idle_slots
       
         # The resource name of the reservation, e.g.,
-        # "projects/*/locations/*/reservations/team1-prod".
+        # `projects/*/locations/*/reservations/team1-prod`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -513,8 +517,9 @@ module Google
         # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
         # (in the form of slots) with some committed period of usage. Annual
         # commitments renew by default. Commitments can be removed after their
-        # commitment end time passes. In order to remove annual commitment, its plan
-        # needs to be changed to monthly or flex first.
+        # commitment end time passes.
+        # In order to remove annual commitment, its plan needs to be changed
+        # to monthly or flex first.
         # A capacity commitment resource exists as a child resource of the admin
         # project.
         # Corresponds to the JSON property `first`
@@ -524,8 +529,9 @@ module Google
         # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
         # (in the form of slots) with some committed period of usage. Annual
         # commitments renew by default. Commitments can be removed after their
-        # commitment end time passes. In order to remove annual commitment, its plan
-        # needs to be changed to monthly or flex first.
+        # commitment end time passes.
+        # In order to remove annual commitment, its plan needs to be changed
+        # to monthly or flex first.
         # A capacity commitment resource exists as a child resource of the admin
         # project.
         # Corresponds to the JSON property `second`

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

@@ -160,34 +160,36 @@ module Google
         
         # Looks up assignments for a specified resource for a particular region.
         # If the request is about a project:
-        # 1) Assignments created on the project will be returned if they exist.
-        # 2) Otherwise assignments created on the closest ancestor will be
-        # returned. 3) Assignments for different JobTypes will all be returned.
-        # Same logic applies if the request is about a folder.
+        # 1. Assignments created on the project will be returned if they exist.
+        # 2. Otherwise assignments created on the closest ancestor will be
+        # returned.
+        # 3. Assignments for different JobTypes will all be returned.
+        # The same logic applies if the request is about a folder.
         # If the request is about an organization, then assignments created on the
         # organization will be returned (organization doesn't have ancestors).
         # Comparing to ListAssignments, there are some behavior
         # differences:
-        # 1) permission on the assignee will be verified in this API.
-        # 2) Hierarchy lookup (project->folder->organization) happens in this API.
-        # 3) Parent here is projects/*/locations/*, instead of
-        # projects/*/locations/*reservations/*.
-        # Note "-" cannot be used for projects
+        # 1. permission on the assignee will be verified in this API.
+        # 2. Hierarchy lookup (project->folder->organization) happens in this API.
+        # 3. Parent here is `projects/*/locations/*`, instead of
+        # `projects/*/locations/*reservations/*`.
+        # **Note** "-" cannot be used for projects
         # nor locations.
         # @param [String] parent
         #   Required. The resource name of the admin project(containing project and
         #   location),
         #   e.g.:
-        #   "projects/myproject/locations/US".
+        #   `projects/myproject/locations/US`.
         # @param [Fixnum] page_size
-        #   The maximum number of items to return.
+        #   The maximum number of items to return per page.
         # @param [String] page_token
         #   The next_page_token value returned from a previous List request, if any.
         # @param [String] query
         #   Please specify resource name as assignee in the query.
-        #   e.g., "assignee=projects/myproject"
-        #   "assignee=folders/123"
-        #   "assignee=organizations/456"
+        #   Examples:
+        #   * `assignee=projects/myproject`
+        #   * `assignee=folders/123`
+        #   * `assignee=organizations/456`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -219,8 +221,8 @@ module Google
         end
         
         # Updates a BI reservation.
-        # Only fields specified in the field_mask are updated.
-        # Singleton BI reservation always exists with default size 0.
+        # Only fields specified in the `field_mask` are updated.
+        # A singleton BI reservation always exists with default size 0.
         # In order to reserve BI capacity it needs to be updated to an amount
         # greater than 0. In order to release BI capacity reservation size
         # must be set to 0.
@@ -264,7 +266,7 @@ module Google
         # Creates a new capacity commitment resource.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1::CapacityCommitment] capacity_commitment_object
         # @param [Boolean] enforce_single_admin_project_per_org
         #   If true, fail the request if another project in the organization has a
@@ -304,7 +306,7 @@ module Google
         # `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to delete. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -335,7 +337,7 @@ module Google
         # Returns information about the capacity commitment.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to retrieve. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -366,7 +368,7 @@ module Google
         # Lists all the capacity commitments for the admin project.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -400,13 +402,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Merges capacity commitments of the same plan into one. Resulting capacity
-        # commitment has the longer commitment_end_time out of the two. Attempting to
-        # merge capacity commitments of different plan will fail with the error code
-        # `google.rpc.Code.FAILED_PRECONDITION`.
+        # Merges capacity commitments of the same plan into a single commitment.
+        # The resulting capacity commitment has the greater commitment_end_time
+        # out of the to-be-merged capacity commitments.
+        # Attempting to merge capacity commitments of different plan will fail
+        # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] parent
         #   Parent resource that identifies admin project and location e.g.,
-        #   projects/myproject/locations/us
+        #   `projects/myproject/locations/us`
         # @param [Google::Apis::BigqueryreservationV1::MergeCapacityCommitmentsRequest] merge_capacity_commitments_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -438,13 +441,13 @@ module Google
         end
         
         # Updates an existing capacity commitment.
-        # Only plan and renewal_plan fields can be updated.
+        # Only `plan` and `renewal_plan` fields can be updated.
         # Plan can only be changed to a plan of a longer commitment period.
         # Attempting to change to a plan with shorter commitment period will fail
         # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
         #   Output only. The resource name of the capacity commitment, e.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1::CapacityCommitment] capacity_commitment_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -479,13 +482,14 @@ module Google
         end
         
         # Splits capacity commitment to two commitments of the same plan and
-        # commitment_end_time. A common use case to do that is to perform a downgrade
-        # e.g., in order to downgrade from 10000 slots to 8000, one might split 10000
-        # capacity commitment to 2000 and 8000, change the plan of the first one to
-        # flex and then delete it.
+        # `commitment_end_time`.
+        # A common use case is to enable downgrading commitments.
+        # For example, in order to downgrade from 10000 slots to 8000, you might
+        # split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
+        # you would change the plan of the first one to `FLEX` and then delete it.
         # @param [String] name
         #   Required. The resource name e.g.,:
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1::SplitCapacityCommitmentRequest] split_capacity_commitment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -519,7 +523,7 @@ module Google
         # Creates a new reservation resource.
         # @param [String] parent
         #   Required. Project, location. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1::Reservation] reservation_object
         # @param [String] reservation_id
         #   The reservation ID. This field must only contain lower case alphanumeric
@@ -559,7 +563,7 @@ module Google
         # assignments.
         # @param [String] name
         #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -590,7 +594,7 @@ module Google
         # Returns information about the reservation.
         # @param [String] name
         #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -621,9 +625,9 @@ module Google
         # Lists all the reservations for the project in the specified location.
         # @param [String] parent
         #   Required. The parent resource name containing project and location, e.g.:
-        #   "projects/myproject/locations/US"
+        #   `projects/myproject/locations/US`
         # @param [Fixnum] page_size
-        #   The maximum number of items to return.
+        #   The maximum number of items to return per page.
         # @param [String] page_token
         #   The next_page_token value returned from a previous List request, if any.
         # @param [String] fields
@@ -658,7 +662,7 @@ module Google
         # Updates an existing reservation resource.
         # @param [String] name
         #   The resource name of the reservation, e.g.,
-        #   "projects/*/locations/*/reservations/team1-prod".
+        #   `projects/*/locations/*/reservations/team1-prod`.
         # @param [Google::Apis::BigqueryreservationV1::Reservation] reservation_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -692,18 +696,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an object which allows the given project to submit jobs
-        # of a certain type using slots from the specified reservation. Currently a
+        # Creates an assignment object which allows the given project to submit jobs
+        # of a certain type using slots from the specified reservation.
+        # Currently a
         # resource (project, folder, organization) can only have one assignment per
-        # `job_type, location`, and that reservation will be used for all jobs of the
-        # matching type. Within the organization, different assignments can be
-        # created on projects, folders or organization level. During query execution,
+        # each (job_type, location) combination, and that reservation will be used
+        # for all jobs of the matching type.
+        # Different assignments can be created on different levels of the
+        # projects, folders or organization hierarchy.  During query execution,
         # the assignment is looked up at the project, folder and organization levels
-        # in that order. The first assignment found is applied to the query. When
-        # creating assignments, it does not matter if other assignments exist at
-        # higher levels. E.g: organizationA contains project1, project2. Assignments
-        # for organizationA, project1 and project2 could all be created, mapping to
-        # the same or different reservations.
+        # in that order. The first assignment found is applied to the query.
+        # When creating assignments, it does not matter if other assignments exist at
+        # higher levels.
+        # Example:
+        # * The organization `organizationA` contains two projects, `project1`
+        # and `project2`.
+        # * Assignments for all three entities (`organizationA`, `project1`, and
+        # `project2`) could all be created and mapped to the same or different
+        # reservations.
         # Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have
         # 'bigquery.admin' permissions on the project using the reservation
         # and the project that owns this reservation.
@@ -711,7 +721,7 @@ module Google
         # does not match location of the reservation.
         # @param [String] parent
         #   Required. The parent resource name of the assignment
-        #   E.g.: projects/myproject/locations/US/reservations/team1-prod
+        #   E.g. `projects/myproject/locations/US/reservations/team1-prod`
         # @param [Google::Apis::BigqueryreservationV1::Assignment] assignment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -743,18 +753,20 @@ module Google
         end
         
         # Deletes a assignment. No expansion will happen.
-        # E.g:
-        # organizationA contains project1 and project2. Reservation res1 exists.
-        # CreateAssignment was invoked previously and following assignments were
-        # created explicitly:
-        # <organizationA, res1>
-        # <project1, res1>
-        # Then deletion of <organizationA, res1> won't affect <project1, res1>. After
-        # deletion of <organizationA, res1>, queries from project1 will still use
-        # res1, while queries from project2 will use on-demand mode.
+        # Example:
+        # * Organization `organizationA` contains two projects, `project1` and
+        # `project2`.
+        # * Reservation `res1` exists and was created previously.
+        # * CreateAssignment was used previously to define the following
+        # associations between entities and reservations: `<organizationA, res1>`
+        # and `<project1, res1>`
+        # In this example, deletion of the `<organizationA, res1>` assignment won't
+        # affect the other assignment `<project1, res1>`. After said deletion,
+        # queries from `project1` will still use `res1` while queries from
+        # `project2` will switch to use on-demand mode.
         # @param [String] name
-        #   Required. Name of the resource, e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod/assignments/123
+        #   Required. Name of the resource, e.g.
+        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -783,24 +795,27 @@ module Google
         end
         
         # Lists assignments.
-        # Only explicitly created assignments will be returned. E.g:
-        # organizationA contains project1 and project2. Reservation res1 exists.
-        # CreateAssignment was invoked previously and following assignments were
-        # created explicitly:
-        # <organizationA, res1>
-        # <project1, res1>
-        # Then this API will just return the above two assignments for reservation
-        # res1, and no expansion/merge will happen. Wildcard "-" can be used for
+        # Only explicitly created assignments will be returned.
+        # Example:
+        # * Organization `organizationA` contains two projects, `project1` and
+        # `project2`.
+        # * Reservation `res1` exists and was created previously.
+        # * CreateAssignment was used previously to define the following
+        # associations between entities and reservations: `<organizationA, res1>`
+        # and `<project1, res1>`
+        # In this example, ListAssignments will just return the above two assignments
+        # for reservation `res1`, and no expansion/merge will happen.
+        # The wildcard "-" can be used for
         # reservations in the request. In that case all assignments belongs to the
-        # specified project and location will be listed. Note
-        # "-" cannot be used for projects nor locations.
+        # specified project and location will be listed.
+        # **Note** "-" cannot be used for projects nor locations.
         # @param [String] parent
         #   Required. The parent resource name e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         #   Or:
-        #   projects/myproject/locations/US/reservations/-
+        #   `projects/myproject/locations/US/reservations/-`
         # @param [Fixnum] page_size
-        #   The maximum number of items to return.
+        #   The maximum number of items to return per page.
         # @param [String] page_token
         #   The next_page_token value returned from a previous List request, if any.
         # @param [String] fields
@@ -832,16 +847,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Moves a assignment under a new reservation. Customers can do this by
-        # deleting the existing assignment followed by creating another assignment
-        # under the new reservation, but this method provides a transactional way to
-        # do so, to make sure the assignee always has an associated reservation.
-        # Without the method customers might see some queries run on-demand which
-        # might be unexpected.
+        # Moves an assignment under a new reservation.
+        # This differs from removing an existing assignment and recreating a new one
+        # by providing a transactional change that ensures an assignee always has an
+        # associated reservation.
         # @param [String] name
         #   Required. The resource name of the assignment,
-        #   e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod/assignments/123
+        #   e.g.
+        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
         # @param [Google::Apis::BigqueryreservationV1::MoveAssignmentRequest] move_assignment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.