google-api-client 0.42.1 → 0.44.2

data/generated/google/apis/bigqueryreservation_v1alpha2.rb

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

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

@@ -22,13 +22,12 @@ module Google
   module Apis
     module BigqueryreservationV1alpha2
       
-      # The metadata for operation returned from
-      # ReservationService.CreateSlotPool.
+      # The metadata for operation returned from ReservationService.CreateSlotPool.
       class CreateSlotPoolMetadata
         include Google::Apis::Core::Hashable
       
-        # Resource name of the slot pool that is being created. E.g.,
-        # projects/myproject/locations/us-central1/reservations/foo/slotPools/123
+        # Resource name of the slot pool that is being created. E.g., projects/myproject/
+        # locations/us-central1/reservations/foo/slotPools/123
         # Corresponds to the JSON property `slotPool`
         # @return [String]
         attr_accessor :slot_pool
@@ -43,13 +42,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -66,8 +63,8 @@ module Google
       class ListReservationGrantsResponse
         include Google::Apis::Core::Hashable
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -92,8 +89,8 @@ module Google
       class ListReservationsResponse
         include Google::Apis::Core::Hashable
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -118,8 +115,8 @@ module Google
       class ListSlotPoolsResponse
         include Google::Apis::Core::Hashable
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -145,47 +142,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::BigqueryreservationV1alpha2::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -208,35 +203,31 @@ module Google
       class Reservation
         include Google::Apis::Core::Hashable
       
-        # The resource name of the reservation, e.g.,
-        # "projects/*/locations/*/reservations/dev/team/product". Reservation names
-        # (e.g., "dev/team/product") exceeding a depth of six will fail with
-        # `google.rpc.Code.INVALID_ARGUMENT`.
+        # The resource name of the reservation, e.g., "projects/*/locations/*/
+        # reservations/dev/team/product". Reservation names (e.g., "dev/team/product")
+        # exceeding a depth of six will fail with `google.rpc.Code.INVALID_ARGUMENT`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Maximum slots available to this reservation and its children. A slot is a
-        # unit of computational power in BigQuery, and serves as the unit of
-        # parallelism. In a scan of a multi-partitioned table, a single slot operates
-        # on a single partition of the table.
-        # If the new reservation's slot capacity exceed the parent's slot capacity or
-        # if total slot capacity of the new reservation and its siblings exceeds the
-        # parent's slot capacity, the request will fail with
-        # `google.rpc.Code.RESOURCE_EXHAUSTED`.
+        # Maximum slots available to this reservation and its children. A slot is a unit
+        # of computational power in BigQuery, and serves as the unit of parallelism. In
+        # a scan of a multi-partitioned table, a single slot operates on a single
+        # partition of the table. If the new reservation's slot capacity exceed the
+        # parent's slot capacity or if total slot capacity of the new reservation and
+        # its siblings exceeds the parent's slot capacity, the request will fail with `
+        # google.rpc.Code.RESOURCE_EXHAUSTED`.
         # Corresponds to the JSON property `slotCapacity`
         # @return [Fixnum]
         attr_accessor :slot_capacity
       
-        # If true, any query using this reservation will also be submitted to the
-        # parent reservation. This allows the query to share the additional slot
-        # capacity of the parent with other queries in the parent reservation. If the
-        # parent also has this field set to true, then this process will continue
-        # until it encounters a reservation for which this is false.
-        # If false, a query using this reservation will
-        # execute with the maximum slot capacity as specified above.
-        # If not specified, default value is true.
-        # Ignored for top-level reservation.
+        # If true, any query using this reservation will also be submitted to the parent
+        # reservation. This allows the query to share the additional slot capacity of
+        # the parent with other queries in the parent reservation. If the parent also
+        # has this field set to true, then this process will continue until it
+        # encounters a reservation for which this is false. If false, a query using this
+        # reservation will execute with the maximum slot capacity as specified above. If
+        # not specified, default value is true. Ignored for top-level reservation.
         # Corresponds to the JSON property `useParentReservation`
         # @return [Boolean]
         attr_accessor :use_parent_reservation
@@ -254,13 +245,13 @@ module Google
         end
       end
       
-      # A ReservationGrant allows a project to submit jobs
-      # of a certain type using slots from the specified reservation.
+      # A ReservationGrant allows a project to submit jobs of a certain type using
+      # slots from the specified reservation.
       class ReservationGrant
         include Google::Apis::Core::Hashable
       
-        # The resource which will use the reservation. E.g.
-        # projects/myproject, folders/123, organizations/456.
+        # The resource which will use the reservation. E.g. projects/myproject, folders/
+        # 123, organizations/456.
         # Corresponds to the JSON property `grantee`
         # @return [String]
         attr_accessor :grantee
@@ -270,16 +261,15 @@ module Google
         # @return [String]
         attr_accessor :job_type
       
-        # Output only. Name of the resource. E.g.:
-        # projects/myproject/locations/eu/reservationGrants/123.
+        # Output only. Name of the resource. E.g.: projects/myproject/locations/eu/
+        # reservationGrants/123.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Resource name of the reservation.
-        # E.g., projects/myproject/locations/eu/reservations/my_reservation.
-        # This reservation must be in the same location as the grant.
-        # This reservation should belong to the same parent project.
+        # Resource name of the reservation. E.g., projects/myproject/locations/eu/
+        # reservations/my_reservation. This reservation must be in the same location as
+        # the grant. This reservation should belong to the same parent project.
         # Corresponds to the JSON property `reservation`
         # @return [String]
         attr_accessor :reservation
@@ -307,8 +297,8 @@ module Google
       class SearchReservationGrantsResponse
         include Google::Apis::Core::Hashable
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -333,34 +323,32 @@ module Google
       # usage. Slot pool is immutable and cannot be deleted until the end of the
       # commitment period. After the end of the commitment period, slots are still
       # available but can be freely removed any time. Annual commitments will
-      # automatically be downgraded to monthly after the commitment ends.
-      # A slot pool resource exists as a child resource of a top-level reservation.
-      # Sum of all the ACTIVE pools slot_count is always equal to the reservation
-      # slot_capacity.
+      # automatically be downgraded to monthly after the commitment ends. A slot pool
+      # resource exists as a child resource of a top-level reservation. Sum of all the
+      # ACTIVE pools slot_count is always equal to the reservation slot_capacity.
       class SlotPool
         include Google::Apis::Core::Hashable
       
-        # Output only. The end of the commitment period. Slot pool cannot be
-        # removed before commitment_end_time. It is applicable only for ACTIVE slot
-        # pools and is computed as a combination of the plan and the time when the
-        # slot pool became ACTIVE.
+        # Output only. The end of the commitment period. Slot pool cannot be removed
+        # before commitment_end_time. It is applicable only for ACTIVE slot pools and is
+        # computed as a combination of the plan and the time when the slot pool became
+        # ACTIVE.
         # Corresponds to the JSON property `commitmentEndTime`
         # @return [String]
         attr_accessor :commitment_end_time
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `failureStatus`
         # @return [Google::Apis::BigqueryreservationV1alpha2::Status]
         attr_accessor :failure_status
       
-        # Output only. The resource name of the slot pool, e.g.,
-        # projects/myproject/locations/us-central1/reservations/myreservation/
-        # slotPools/123
+        # Output only. The resource name of the slot pool, e.g., projects/myproject/
+        # locations/us-central1/reservations/myreservation/slotPools/123
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -395,12 +383,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -409,15 +397,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

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

@@ -47,31 +47,26 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Look up grants for a specified resource for a particular region.
-        # If the request is about a project:
-        # 1) Grants created on the project will be returned if they exist.
-        # 2) Otherwise grants created on the closest ancestor will be returned.
-        # 3) Grants for different JobTypes will all be returned.
-        # Same logic applies if the request is about a folder.
-        # If the request is about an organization, then grants created on the
-        # organization will be returned (organization doesn't have ancestors).
-        # Comparing to ListReservationGrants, there are two behavior
-        # differences:
-        # 1) permission on the grantee will be verified in this API.
-        # 2) Hierarchy lookup (project->folder->organization) happens in this API.
+        # Look up grants for a specified resource for a particular region. If the
+        # request is about a project: 1) Grants created on the project will be returned
+        # if they exist. 2) Otherwise grants created on the closest ancestor will be
+        # returned. 3) Grants for different JobTypes will all be returned. Same logic
+        # applies if the request is about a folder. If the request is about an
+        # organization, then grants created on the organization will be returned (
+        # organization doesn't have ancestors). Comparing to ListReservationGrants,
+        # there are two behavior differences: 1) permission on the grantee will be
+        # verified in this API. 2) Hierarchy lookup (project->folder->organization)
+        # happens in this API.
         # @param [String] parent
         #   The parent resource name (containing project and location), which owns the
-        #   grants. e.g.:
-        #   "projects/myproject/locations/us-central1".
+        #   grants. e.g.: "projects/myproject/locations/us-central1".
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @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 grantee in the query.
-        #   e.g., "grantee=projects/myproject"
-        #   "grantee=folders/123"
-        #   "grantee=organizations/456"
+        #   Please specify resource name as grantee in the query. e.g., "grantee=projects/
+        #   myproject" "grantee=folders/123" "grantee=organizations/456"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -102,15 +97,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
-        # Operations.GetOperation or
-        # other methods to check whether the cancellation succeeded or whether the
-        # operation completed despite cancellation. On successful cancellation,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. If the
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+        # Clients can use Operations.GetOperation or other methods to check whether the
+        # cancellation succeeded or whether the operation completed despite cancellation.
+        # On successful cancellation, the operation is not deleted; instead, it becomes
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -141,9 +134,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -173,14 +165,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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.
-        # Returns `google.rpc.Code.INVALID_ARGUMENT` when location of the grant
-        # does not match location of the reservation.
+        # 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. Returns `google.rpc.Code.INVALID_ARGUMENT` when
+        # location of the grant does not match location of the reservation.
         # @param [String] parent
-        #   The parent resource name of the reservation grant
-        #   E.g.: projects/myproject/location/eu.
+        #   The parent resource name of the reservation grant E.g.: projects/myproject/
+        #   location/eu.
         # @param [Google::Apis::BigqueryreservationV1alpha2::ReservationGrant] reservation_grant_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -211,19 +202,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a reservation grant. No expansion will happen.
-        # E.g:
-        # organizationA contains project1 and project2. Reservation res1 exists.
+        # Deletes a reservation grant. No expansion will happen. E.g: organizationA
+        # contains project1 and project2. Reservation res1 exists.
         # CreateReservationGrant was invoked previously and following grants 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.
+        # created explicitly: Then deletion of won't affect . After deletion of ,
+        # queries from project1 will still use res1, while queries from project2 will
+        # use on-demand mode.
         # @param [String] name
-        #   Name of the resource, e.g.:
-        #   projects/myproject/locations/eu/reservationGrants/123
+        #   Name of the resource, e.g.: projects/myproject/locations/eu/reservationGrants/
+        #   123
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -251,15 +238,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists reservation grants.
-        # Only explicitly created grants will be returned. E.g:
+        # Lists reservation grants. Only explicitly created grants will be returned. E.g:
         # organizationA contains project1 and project2. Reservation res1 exists.
         # CreateReservationGrant was invoked previously and following grants were
-        # created explicitly:
-        # <organizationA, res1>
-        # <project1, res1>
-        # Then this API will just return the above two grants for reservation res1,
-        # and no expansion/merge will happen.
+        # created explicitly: Then this API will just return the above two grants for
+        # reservation res1, and no expansion/merge will happen.
         # @param [String] parent
         #   The parent resource name e.g.: projects/myproject/location/eu.
         # @param [Fixnum] page_size
@@ -295,15 +278,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new reservation resource. Multiple reservations are created if
-        # the ancestor reservations do not exist.
+        # Creates a new reservation resource. Multiple reservations are created if the
+        # ancestor reservations do not exist.
         # @param [String] parent
-        #   Project, location, and (optionally) reservation name. E.g.,
-        #   projects/myproject/locations/us-central1/reservations/parent
+        #   Project, location, and (optionally) reservation name. E.g., projects/myproject/
+        #   locations/us-central1/reservations/parent
         # @param [Google::Apis::BigqueryreservationV1alpha2::Reservation] reservation_object
         # @param [String] reservation_id
-        #   The reservation ID relative to the parent, e.g., "dev". This field must
-        #   only contain alphanumeric characters.
+        #   The reservation ID relative to the parent, e.g., "dev". This field must only
+        #   contain alphanumeric characters.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -334,15 +317,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new reservation resource. Multiple reservations are created if
-        # the ancestor reservations do not exist.
+        # Creates a new reservation resource. Multiple reservations are created if the
+        # ancestor reservations do not exist.
         # @param [String] parent
-        #   Project, location, and (optionally) reservation name. E.g.,
-        #   projects/myproject/locations/us-central1/reservations/parent
+        #   Project, location, and (optionally) reservation name. E.g., projects/myproject/
+        #   locations/us-central1/reservations/parent
         # @param [Google::Apis::BigqueryreservationV1alpha2::Reservation] reservation_object
         # @param [String] reservation_id
-        #   The reservation ID relative to the parent, e.g., "dev". This field must
-        #   only contain alphanumeric characters.
+        #   The reservation ID relative to the parent, e.g., "dev". This field must only
+        #   contain alphanumeric characters.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -373,19 +356,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a reservation.
-        # Returns `google.rpc.Code.FAILED_PRECONDITION` in the following cases:
-        # 1. When reservation has child reservations. This check can be bypassed by
-        # setting DeleteReservationRequest.force flag to true.
-        # 2. When top-level reservation with slot pools is being deleted.
+        # Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` in the
+        # following cases: 1. When reservation has child reservations. This check can be
+        # bypassed by setting DeleteReservationRequest.force flag to true. 2. When top-
+        # level reservation with slot pools is being deleted.
         # @param [String] name
-        #   Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/us-central1/reservations/my_reservation
+        #   Resource name of the reservation to retrieve. E.g., projects/myproject/
+        #   locations/us-central1/reservations/my_reservation
         # @param [Boolean] force
         #   If true, deletes all the child reservations of the given reservation.
-        #   Otherwise, attempting to delete a reservation that has child
-        #   reservations will fail with error code
-        #   `google.rpc.Code.FAILED_PRECONDITION`.
+        #   Otherwise, attempting to delete a reservation that has child reservations will
+        #   fail with error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -416,8 +397,8 @@ module Google
         
         # Returns information about the reservation.
         # @param [String] name
-        #   Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/us-central1/reservations/path/to/reserv
+        #   Resource name of the reservation to retrieve. E.g., projects/myproject/
+        #   locations/us-central1/reservations/path/to/reserv
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -447,14 +428,13 @@ module Google
         
         # Lists all the reservations for the project in the specified location.
         # @param [String] parent
-        #   The parent resource name containing project and location, e.g.:
-        #   "projects/myproject/locations/us-central1"
+        #   The parent resource name containing project and location, e.g.: "projects/
+        #   myproject/locations/us-central1"
         # @param [String] filter
         #   Can be used to filter out reservations based on names, capacity, etc, e.g.:
-        #   filter="reservation.slot_capacity > 200"
-        #   filter="reservation.name = \"*dev/*\""
-        #   Advanced filtering syntax can be
-        #   [here](https://cloud.google.com/logging/docs/view/advanced-filters).
+        #   filter="reservation.slot_capacity > 200" filter="reservation.name = \"*dev/*\""
+        #   Advanced filtering syntax can be [here](https://cloud.google.com/logging/docs/
+        #   view/advanced-filters).
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -492,10 +472,9 @@ module Google
         # Updates an existing reservation resource. Applicable only for child
         # reservations.
         # @param [String] name
-        #   The resource name of the reservation, e.g.,
-        #   "projects/*/locations/*/reservations/dev/team/product". Reservation names
-        #   (e.g., "dev/team/product") exceeding a depth of six will fail with
-        #   `google.rpc.Code.INVALID_ARGUMENT`.
+        #   The resource name of the reservation, e.g., "projects/*/locations/*/
+        #   reservations/dev/team/product". Reservation names (e.g., "dev/team/product")
+        #   exceeding a depth of six will fail with `google.rpc.Code.INVALID_ARGUMENT`.
         # @param [Google::Apis::BigqueryreservationV1alpha2::Reservation] reservation_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -530,12 +509,11 @@ module Google
         end
         
         # Deletes a slot pool. Attempting to delete slot pool before its
-        # commitment_end_time will fail with the error code
-        # `google.rpc.Code.FAILED_PRECONDITION`.
+        # commitment_end_time will fail with the error code `google.rpc.Code.
+        # FAILED_PRECONDITION`.
         # @param [String] name
-        #   Resource name of the slot pool to delete. E.g.,
-        #   projects/myproject/locations/us-central1/reservations/my_reservation/
-        #   slotPools/123
+        #   Resource name of the slot pool to delete. E.g., projects/myproject/locations/
+        #   us-central1/reservations/my_reservation/slotPools/123
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -565,9 +543,8 @@ module Google
         
         # Returns information about the slot pool.
         # @param [String] name
-        #   Resource name of the slot pool to retrieve. E.g.,
-        #   projects/myproject/locations/us-central1/reservations/my_reservation/
-        #   slotPools/123
+        #   Resource name of the slot pool to retrieve. E.g., projects/myproject/locations/
+        #   us-central1/reservations/my_reservation/slotPools/123
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -597,9 +574,9 @@ module Google
         
         # Lists all the slot pools for the reservation.
         # @param [String] parent
-        #   Resource name of the parent reservation. Only top-level reservations can
-        #   have slot pools. E.g.,
-        #   projects/myproject/locations/us-central1/reservations/my_reservation
+        #   Resource name of the parent reservation. Only top-level reservations can have
+        #   slot pools. E.g., projects/myproject/locations/us-central1/reservations/
+        #   my_reservation
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token