google-api-client 0.42.1 → 0.44.2

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

@@ -48,17 +48,16 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Exports a copy of all or a subset of documents from Google Cloud Firestore
-        # to another storage system, such as Google Cloud Storage. Recent updates to
+        # Exports a copy of all or a subset of documents from Google Cloud Firestore to
+        # another storage system, such as Google Cloud Storage. Recent updates to
         # documents may not be reflected in the export. The export occurs in the
-        # background and its progress can be monitored and managed via the
-        # Operation resource that is created. The output of an export may only be
-        # used once the associated operation is done. If an export operation is
-        # cancelled before completion it may leave partial data behind in Google
-        # Cloud Storage.
+        # background and its progress can be monitored and managed via the Operation
+        # resource that is created. The output of an export may only be used once the
+        # associated operation is done. If an export operation is cancelled before
+        # completion it may leave partial data behind in Google Cloud Storage.
         # @param [String] name
-        #   Database to export. Should be of the form:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Database to export. Should be of the form: `projects/`project_id`/databases/`
+        #   database_id``.
         # @param [Google::Apis::FirestoreV1beta1::GoogleFirestoreAdminV1beta1ExportDocumentsRequest] google_firestore_admin_v1beta1_export_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -92,11 +91,11 @@ module Google
         # Imports documents into Google Cloud Firestore. Existing documents with the
         # same name are overwritten. The import occurs in the background and its
         # progress can be monitored and managed via the Operation resource that is
-        # created. If an ImportDocuments operation is cancelled, it is possible
-        # that a subset of the data has already been imported to Cloud Firestore.
+        # created. If an ImportDocuments operation is cancelled, it is possible that a
+        # subset of the data has already been imported to Cloud Firestore.
         # @param [String] name
-        #   Database to import into. Should be of the form:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Database to import into. Should be of the form: `projects/`project_id`/
+        #   databases/`database_id``.
         # @param [Google::Apis::FirestoreV1beta1::GoogleFirestoreAdminV1beta1ImportDocumentsRequest] google_firestore_admin_v1beta1_import_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -127,12 +126,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets multiple documents.
-        # Documents returned by this method are not guaranteed to be returned in the
-        # same order that they were requested.
+        # Gets multiple documents. Documents returned by this method are not guaranteed
+        # to be returned in the same order that they were requested.
         # @param [String] database
-        #   Required. The database name. In the format:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Required. The database name. In the format: `projects/`project_id`/databases/`
+        #   database_id``.
         # @param [Google::Apis::FirestoreV1beta1::BatchGetDocumentsRequest] batch_get_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -163,16 +161,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Applies a batch of write operations.
-        # The BatchWrite method does not apply the write operations atomically
-        # and can apply them out of order. Method does not allow more than one write
-        # per document. Each write succeeds or fails independently. See the
-        # BatchWriteResponse for the success status of each write.
-        # If you require an atomically applied set of writes, use
-        # Commit instead.
+        # Applies a batch of write operations. The BatchWrite method does not apply the
+        # write operations atomically and can apply them out of order. Method does not
+        # allow more than one write per document. Each write succeeds or fails
+        # independently. See the BatchWriteResponse for the success status of each write.
+        # If you require an atomically applied set of writes, use Commit instead.
         # @param [String] database
-        #   Required. The database name. In the format:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Required. The database name. In the format: `projects/`project_id`/databases/`
+        #   database_id``.
         # @param [Google::Apis::FirestoreV1beta1::BatchWriteRequest] batch_write_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -205,8 +201,8 @@ module Google
         
         # Starts a new transaction.
         # @param [String] database
-        #   Required. The database name. In the format:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Required. The database name. In the format: `projects/`project_id`/databases/`
+        #   database_id``.
         # @param [Google::Apis::FirestoreV1beta1::BeginTransactionRequest] begin_transaction_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -239,8 +235,8 @@ module Google
         
         # Commits a transaction, while optionally updating documents.
         # @param [String] database
-        #   Required. The database name. In the format:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Required. The database name. In the format: `projects/`project_id`/databases/`
+        #   database_id``.
         # @param [Google::Apis::FirestoreV1beta1::CommitRequest] commit_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -273,20 +269,19 @@ module Google
         
         # Creates a new document.
         # @param [String] parent
-        #   Required. The parent resource. For example:
-        #   `projects/`project_id`/databases/`database_id`/documents` or
-        #   `projects/`project_id`/databases/`database_id`/documents/chatrooms/`
-        #   chatroom_id``
+        #   Required. The parent resource. For example: `projects/`project_id`/databases/`
+        #   database_id`/documents` or `projects/`project_id`/databases/`database_id`/
+        #   documents/chatrooms/`chatroom_id``
         # @param [String] collection_id
         #   Required. The collection ID, relative to `parent`, to list. For example: `
         #   chatrooms`.
         # @param [Google::Apis::FirestoreV1beta1::Document] document_object
         # @param [String] document_id
-        #   The client-assigned document ID to use for this document.
-        #   Optional. If not specified, an ID will be assigned by the service.
+        #   The client-assigned document ID to use for this document. Optional. If not
+        #   specified, an ID will be assigned by the service.
         # @param [Array<String>, String] mask_field_paths
-        #   The list of field paths in the mask. See Document.fields for a field
-        #   path syntax reference.
+        #   The list of field paths in the mask. See Document.fields for a field path
+        #   syntax reference.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -321,14 +316,14 @@ module Google
         
         # Deletes a document.
         # @param [String] name
-        #   Required. The resource name of the Document to delete. In the format:
-        #   `projects/`project_id`/databases/`database_id`/documents/`document_path``.
+        #   Required. The resource name of the Document to delete. In the format: `
+        #   projects/`project_id`/databases/`database_id`/documents/`document_path``.
         # @param [Boolean] current_document_exists
-        #   When set to `true`, the target document must exist.
-        #   When set to `false`, the target document must not exist.
+        #   When set to `true`, the target document must exist. When set to `false`, the
+        #   target document must not exist.
         # @param [String] current_document_update_time
-        #   When set, the target document must exist and have been last updated at
-        #   that time.
+        #   When set, the target document must exist and have been last updated at that
+        #   time.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -360,14 +355,14 @@ module Google
         
         # Gets a single document.
         # @param [String] name
-        #   Required. The resource name of the Document to get. In the format:
-        #   `projects/`project_id`/databases/`database_id`/documents/`document_path``.
+        #   Required. The resource name of the Document to get. In the format: `projects/`
+        #   project_id`/databases/`database_id`/documents/`document_path``.
         # @param [Array<String>, String] mask_field_paths
-        #   The list of field paths in the mask. See Document.fields for a field
-        #   path syntax reference.
+        #   The list of field paths in the mask. See Document.fields for a field path
+        #   syntax reference.
         # @param [String] read_time
-        #   Reads the version of the document at the given time.
-        #   This may not be older than 270 seconds.
+        #   Reads the version of the document at the given time. This may not be older
+        #   than 270 seconds.
         # @param [String] transaction
         #   Reads the document in a transaction.
         # @param [String] fields
@@ -402,19 +397,17 @@ module Google
         
         # Lists documents.
         # @param [String] parent
-        #   Required. The parent resource name. In the format:
-        #   `projects/`project_id`/databases/`database_id`/documents` or
-        #   `projects/`project_id`/databases/`database_id`/documents/`document_path``.
-        #   For example:
-        #   `projects/my-project/databases/my-database/documents` or
-        #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
+        #   Required. The parent resource name. In the format: `projects/`project_id`/
+        #   databases/`database_id`/documents` or `projects/`project_id`/databases/`
+        #   database_id`/documents/`document_path``. For example: `projects/my-project/
+        #   databases/my-database/documents` or `projects/my-project/databases/my-database/
+        #   documents/chatrooms/my-chatroom`
         # @param [String] collection_id
         #   Required. The collection ID, relative to `parent`, to list. For example: `
-        #   chatrooms`
-        #   or `messages`.
+        #   chatrooms` or `messages`.
         # @param [Array<String>, String] mask_field_paths
-        #   The list of field paths in the mask. See Document.fields for a field
-        #   path syntax reference.
+        #   The list of field paths in the mask. See Document.fields for a field path
+        #   syntax reference.
         # @param [String] order_by
         #   The order to sort results by. For example: `priority desc, name`.
         # @param [Fixnum] page_size
@@ -422,15 +415,14 @@ module Google
         # @param [String] page_token
         #   The `next_page_token` value returned from a previous List request, if any.
         # @param [String] read_time
-        #   Reads documents as they were at the given time.
-        #   This may not be older than 270 seconds.
+        #   Reads documents as they were at the given time. This may not be older than 270
+        #   seconds.
         # @param [Boolean] show_missing
-        #   If the list should show missing documents. A missing document is a
-        #   document that does not exist but has sub-documents. These documents will
-        #   be returned with a key but will not have fields, Document.create_time,
-        #   or Document.update_time set.
-        #   Requests with `show_missing` may not specify `where` or
-        #   `order_by`.
+        #   If the list should show missing documents. A missing document is a document
+        #   that does not exist but has sub-documents. These documents will be returned
+        #   with a key but will not have fields, Document.create_time, or Document.
+        #   update_time set. Requests with `show_missing` may not specify `where` or `
+        #   order_by`.
         # @param [String] transaction
         #   Reads documents in a transaction.
         # @param [String] fields
@@ -470,10 +462,9 @@ module Google
         
         # Lists all the collection IDs underneath a document.
         # @param [String] parent
-        #   Required. The parent document. In the format:
-        #   `projects/`project_id`/databases/`database_id`/documents/`document_path``.
-        #   For example:
-        #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
+        #   Required. The parent document. In the format: `projects/`project_id`/databases/
+        #   `database_id`/documents/`document_path``. For example: `projects/my-project/
+        #   databases/my-database/documents/chatrooms/my-chatroom`
         # @param [Google::Apis::FirestoreV1beta1::ListCollectionIdsRequest] list_collection_ids_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -506,8 +497,8 @@ module Google
         
         # Listens to changes.
         # @param [String] database
-        #   Required. The database name. In the format:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Required. The database name. In the format: `projects/`project_id`/databases/`
+        #   database_id``.
         # @param [Google::Apis::FirestoreV1beta1::ListenRequest] listen_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -538,14 +529,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Partitions a query by returning partition cursors that can be used to run
-        # the query in parallel. The returned partition cursors are split points that
-        # can be used by RunQuery as starting/end points for the query results.
+        # Partitions a query by returning partition cursors that can be used to run the
+        # query in parallel. The returned partition cursors are split points that can be
+        # used by RunQuery as starting/end points for the query results.
         # @param [String] parent
-        #   Required. The parent resource name. In the format:
-        #   `projects/`project_id`/databases/`database_id`/documents`.
-        #   Document resource names are not supported; only database resource names
-        #   can be specified.
+        #   Required. The parent resource name. In the format: `projects/`project_id`/
+        #   databases/`database_id`/documents`. Document resource names are not supported;
+        #   only database resource names can be specified.
         # @param [Google::Apis::FirestoreV1beta1::PartitionQueryRequest] partition_query_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -578,21 +568,21 @@ module Google
         
         # Updates or inserts a document.
         # @param [String] name
-        #   The resource name of the document, for example
-        #   `projects/`project_id`/databases/`database_id`/documents/`document_path``.
+        #   The resource name of the document, for example `projects/`project_id`/
+        #   databases/`database_id`/documents/`document_path``.
         # @param [Google::Apis::FirestoreV1beta1::Document] document_object
         # @param [Boolean] current_document_exists
-        #   When set to `true`, the target document must exist.
-        #   When set to `false`, the target document must not exist.
+        #   When set to `true`, the target document must exist. When set to `false`, the
+        #   target document must not exist.
         # @param [String] current_document_update_time
-        #   When set, the target document must exist and have been last updated at
-        #   that time.
+        #   When set, the target document must exist and have been last updated at that
+        #   time.
         # @param [Array<String>, String] mask_field_paths
-        #   The list of field paths in the mask. See Document.fields for a field
-        #   path syntax reference.
+        #   The list of field paths in the mask. See Document.fields for a field path
+        #   syntax reference.
         # @param [Array<String>, String] update_mask_field_paths
-        #   The list of field paths in the mask. See Document.fields for a field
-        #   path syntax reference.
+        #   The list of field paths in the mask. See Document.fields for a field path
+        #   syntax reference.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -628,8 +618,8 @@ module Google
         
         # Rolls back a transaction.
         # @param [String] database
-        #   Required. The database name. In the format:
-        #   `projects/`project_id`/databases/`database_id``.
+        #   Required. The database name. In the format: `projects/`project_id`/databases/`
+        #   database_id``.
         # @param [Google::Apis::FirestoreV1beta1::RollbackRequest] rollback_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -662,12 +652,11 @@ module Google
         
         # Runs a query.
         # @param [String] parent
-        #   Required. The parent resource name. In the format:
-        #   `projects/`project_id`/databases/`database_id`/documents` or
-        #   `projects/`project_id`/databases/`database_id`/documents/`document_path``.
-        #   For example:
-        #   `projects/my-project/databases/my-database/documents` or
-        #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
+        #   Required. The parent resource name. In the format: `projects/`project_id`/
+        #   databases/`database_id`/documents` or `projects/`project_id`/databases/`
+        #   database_id`/documents/`document_path``. For example: `projects/my-project/
+        #   databases/my-database/documents` or `projects/my-project/databases/my-database/
+        #   documents/chatrooms/my-chatroom`
         # @param [Google::Apis::FirestoreV1beta1::RunQueryRequest] run_query_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -700,9 +689,8 @@ module Google
         
         # Streams batches of document updates and deletes, in order.
         # @param [String] database
-        #   Required. The database name. In the format:
-        #   `projects/`project_id`/databases/`database_id``.
-        #   This is only required in the first message.
+        #   Required. The database name. In the format: `projects/`project_id`/databases/`
+        #   database_id``. This is only required in the first message.
         # @param [Google::Apis::FirestoreV1beta1::WriteRequest] write_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -733,20 +721,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates the specified index.
-        # A newly created index's initial state is `CREATING`. On completion of the
-        # returned google.longrunning.Operation, the state will be `READY`.
-        # If the index already exists, the call will return an `ALREADY_EXISTS`
-        # status.
-        # During creation, the process could result in an error, in which case the
-        # index will move to the `ERROR` state. The process can be recovered by
-        # fixing the data that caused the error, removing the index with
-        # delete, then re-creating the index with
-        # create.
-        # Indexes with a single field cannot be created.
+        # Creates the specified index. A newly created index's initial state is `
+        # CREATING`. On completion of the returned google.longrunning.Operation, the
+        # state will be `READY`. If the index already exists, the call will return an `
+        # ALREADY_EXISTS` status. During creation, the process could result in an error,
+        # in which case the index will move to the `ERROR` state. The process can be
+        # recovered by fixing the data that caused the error, removing the index with
+        # delete, then re-creating the index with create. Indexes with a single field
+        # cannot be created.
         # @param [String] parent
-        #   The name of the database this index will apply to. For example:
-        #   `projects/`project_id`/databases/`database_id``
+        #   The name of the database this index will apply to. For example: `projects/`
+        #   project_id`/databases/`database_id``
         # @param [Google::Apis::FirestoreV1beta1::GoogleFirestoreAdminV1beta1Index] google_firestore_admin_v1beta1_index_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -779,8 +764,8 @@ module Google
         
         # Deletes an index.
         # @param [String] name
-        #   The index name. For example:
-        #   `projects/`project_id`/databases/`database_id`/indexes/`index_id``
+        #   The index name. For example: `projects/`project_id`/databases/`database_id`/
+        #   indexes/`index_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -810,8 +795,8 @@ module Google
         
         # Gets an index.
         # @param [String] name
-        #   The name of the index. For example:
-        #   `projects/`project_id`/databases/`database_id`/indexes/`index_id``
+        #   The name of the index. For example: `projects/`project_id`/databases/`
+        #   database_id`/indexes/`index_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -841,8 +826,7 @@ module Google
         
         # Lists the indexes that match the specified filters.
         # @param [String] parent
-        #   The database name. For example:
-        #   `projects/`project_id`/databases/`database_id``
+        #   The database name. For example: `projects/`project_id`/databases/`database_id``
         # @param [String] filter
         # @param [Fixnum] page_size
         #   The standard List page size.

data/generated/google/apis/firestore_v1beta2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/firestore
     module FirestoreV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20200215'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,13 +22,11 @@ module Google
   module Apis
     module FirestoreV1beta2
       
-      # 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
       
@@ -41,8 +39,8 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.ExportDocuments.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # ExportDocuments.
       class GoogleFirestoreAdminV1beta2ExportDocumentsMetadata
         include Google::Apis::Core::Hashable
       
@@ -67,16 +65,14 @@ module Google
         # @return [String]
         attr_accessor :output_uri_prefix
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressBytes`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :progress_bytes
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressDocuments`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :progress_documents
@@ -111,14 +107,13 @@ module Google
         # @return [Array<String>]
         attr_accessor :collection_ids
       
-        # The output URI. Currently only supports Google Cloud Storage URIs of the
-        # form: `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name
-        # of the Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional
-        # Google Cloud Storage namespace path. When
-        # choosing a name, be sure to consider Google Cloud Storage naming
-        # guidelines: https://cloud.google.com/storage/docs/naming.
-        # If the URI is a bucket (without a namespace path), a prefix will be
-        # generated based on the start time.
+        # The output URI. Currently only supports Google Cloud Storage URIs of the form:
+        # `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name of the
+        # Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional Google Cloud
+        # Storage namespace path. When choosing a name, be sure to consider Google Cloud
+        # Storage naming guidelines: https://cloud.google.com/storage/docs/naming. If
+        # the URI is a bucket (without a namespace path), a prefix will be generated
+        # based on the start time.
         # Corresponds to the JSON property `outputUriPrefix`
         # @return [String]
         attr_accessor :output_uri_prefix
@@ -138,9 +133,9 @@ module Google
       class GoogleFirestoreAdminV1beta2ExportDocumentsResponse
         include Google::Apis::Core::Hashable
       
-        # Location of the output files. This can be used to begin an import
-        # into Cloud Firestore (this project or another project) after the operation
-        # completes successfully.
+        # Location of the output files. This can be used to begin an import into Cloud
+        # Firestore (this project or another project) after the operation completes
+        # successfully.
         # Corresponds to the JSON property `outputUriPrefix`
         # @return [String]
         attr_accessor :output_uri_prefix
@@ -155,9 +150,9 @@ module Google
         end
       end
       
-      # Represents a single field in the database.
-      # Fields are grouped by their "Collection Group", which represent all
-      # collections in the database with the same id.
+      # Represents a single field in the database. Fields are grouped by their "
+      # Collection Group", which represent all collections in the database with the
+      # same id.
       class GoogleFirestoreAdminV1beta2Field
         include Google::Apis::Core::Hashable
       
@@ -166,28 +161,21 @@ module Google
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2IndexConfig]
         attr_accessor :index_config
       
-        # A field name of the form
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /fields/`field_path``
-        # A field path may be a simple field name, e.g. `address` or a path to fields
-        # within map_value , e.g. `address.city`,
-        # or a special field path. The only valid special field is `*`, which
-        # represents any field.
-        # Field paths may be quoted using ` (backtick). The only character that needs
-        # to be escaped within a quoted field path is the backtick character itself,
-        # escaped using a backslash. Special characters in field paths that
-        # must be quoted include: `*`, `.`,
-        # ``` (backtick), `[`, `]`, as well as any ascii symbolic characters.
-        # Examples:
-        # (Note: Comments here are written in markdown syntax, so there is an
-        # additional layer of backticks to represent a code block)
-        # `\`address.city\`` represents a field named `address.city`, not the map key
-        # `city` in the field `address`.
-        # `\`*\`` represents a field named `*`, not any field.
-        # A special `Field` contains the default indexing settings for all fields.
-        # This field's resource name is:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/__default__/
-        # fields/*`
+        # A field name of the form `projects/`project_id`/databases/`database_id`/
+        # collectionGroups/`collection_id`/fields/`field_path`` A field path may be a
+        # simple field name, e.g. `address` or a path to fields within map_value , e.g. `
+        # address.city`, or a special field path. The only valid special field is `*`,
+        # which represents any field. Field paths may be quoted using ` (backtick). The
+        # only character that needs to be escaped within a quoted field path is the
+        # backtick character itself, escaped using a backslash. Special characters in
+        # field paths that must be quoted include: `*`, `.`, ``` (backtick), `[`, `]`,
+        # as well as any ascii symbolic characters. Examples: (Note: Comments here are
+        # written in markdown syntax, so there is an additional layer of backticks to
+        # represent a code block) `\`address.city\`` represents a field named `address.
+        # city`, not the map key `city` in the field `address`. `\`*\`` represents a
+        # field named `*`, not any field. A special `Field` contains the default
+        # indexing settings for all fields. This field's resource name is: `projects/`
+        # project_id`/databases/`database_id`/collectionGroups/__default__/fields/*`
         # Indexes defined on this `Field` will be applied to all fields which do not
         # have their own `Field` index configuration.
         # Corresponds to the JSON property `name`
@@ -205,21 +193,19 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.UpdateField.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # UpdateField.
       class GoogleFirestoreAdminV1beta2FieldOperationMetadata
         include Google::Apis::Core::Hashable
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `bytesProgress`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :bytes_progress
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `documentProgress`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :document_progress
@@ -230,15 +216,14 @@ module Google
         # @return [String]
         attr_accessor :end_time
       
-        # The field resource that this operation is acting on. For example:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /fields/`field_path``
+        # The field resource that this operation is acting on. For example: `projects/`
+        # project_id`/databases/`database_id`/collectionGroups/`collection_id`/fields/`
+        # field_path``
         # Corresponds to the JSON property `field`
         # @return [String]
         attr_accessor :field
       
-        # A list of IndexConfigDelta, which describe the intent of this
-        # operation.
+        # A list of IndexConfigDelta, which describe the intent of this operation.
         # Corresponds to the JSON property `indexConfigDeltas`
         # @return [Array<Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2IndexConfigDelta>]
         attr_accessor :index_config_deltas
@@ -269,8 +254,8 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.ImportDocuments.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # ImportDocuments.
       class GoogleFirestoreAdminV1beta2ImportDocumentsMetadata
         include Google::Apis::Core::Hashable
       
@@ -295,16 +280,14 @@ module Google
         # @return [String]
         attr_accessor :operation_state
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressBytes`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :progress_bytes
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressDocuments`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :progress_documents
@@ -334,16 +317,14 @@ module Google
       class GoogleFirestoreAdminV1beta2ImportDocumentsRequest
         include Google::Apis::Core::Hashable
       
-        # Which collection ids to import. Unspecified means all collections included
-        # in the import.
+        # Which collection ids to import. Unspecified means all collections included in
+        # the import.
         # Corresponds to the JSON property `collectionIds`
         # @return [Array<String>]
         attr_accessor :collection_ids
       
-        # Location of the exported files.
-        # This must match the output_uri_prefix of an ExportDocumentsResponse from
-        # an export that has completed successfully.
-        # See:
+        # Location of the exported files. This must match the output_uri_prefix of an
+        # ExportDocumentsResponse from an export that has completed successfully. See:
         # google.firestore.admin.v1beta2.ExportDocumentsResponse.output_uri_prefix.
         # Corresponds to the JSON property `inputUriPrefix`
         # @return [String]
@@ -360,39 +341,37 @@ module Google
         end
       end
       
-      # Cloud Firestore indexes enable simple and complex queries against
-      # documents in a database.
+      # Cloud Firestore indexes enable simple and complex queries against documents in
+      # a database.
       class GoogleFirestoreAdminV1beta2Index
         include Google::Apis::Core::Hashable
       
-        # The fields supported by this index.
-        # For composite indexes, this is always 2 or more fields.
-        # The last field entry is always for the field path `__name__`. If, on
-        # creation, `__name__` was not specified as the last field, it will be added
+        # The fields supported by this index. For composite indexes, this is always 2 or
+        # more fields. The last field entry is always for the field path `__name__`. If,
+        # on creation, `__name__` was not specified as the last field, it will be added
         # automatically with the same direction as that of the last field defined. If
-        # the final field in a composite index is not directional, the `__name__`
-        # will be ordered ASCENDING (unless explicitly specified).
-        # For single field indexes, this will always be exactly one entry with a
-        # field path equal to the field path of the associated field.
+        # the final field in a composite index is not directional, the `__name__` will
+        # be ordered ASCENDING (unless explicitly specified). For single field indexes,
+        # this will always be exactly one entry with a field path equal to the field
+        # path of the associated field.
         # Corresponds to the JSON property `fields`
         # @return [Array<Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2IndexField>]
         attr_accessor :fields
       
-        # Output only. A server defined name for this index.
-        # The form of this name for composite indexes will be:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /indexes/`composite_index_id``
-        # For single field indexes, this field will be empty.
+        # Output only. A server defined name for this index. The form of this name for
+        # composite indexes will be: `projects/`project_id`/databases/`database_id`/
+        # collectionGroups/`collection_id`/indexes/`composite_index_id`` For single
+        # field indexes, this field will be empty.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Indexes with a collection query scope specified allow queries
-        # against a collection that is the child of a specific document, specified at
-        # query time, and that has the same collection id.
-        # Indexes with a collection group query scope specified allow queries against
-        # all collections descended from a specific document, specified at query
-        # time, and that have the same collection id as this index.
+        # Indexes with a collection query scope specified allow queries against a
+        # collection that is the child of a specific document, specified at query time,
+        # and that has the same collection id. Indexes with a collection group query
+        # scope specified allow queries against all collections descended from a
+        # specific document, specified at query time, and that have the same collection
+        # id as this index.
         # Corresponds to the JSON property `queryScope`
         # @return [String]
         attr_accessor :query_scope
@@ -420,10 +399,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Output only. Specifies the resource name of the `Field` from which this field'
-        # s
-        # index configuration is set (when `uses_ancestor_config` is true),
-        # or from which it *would* be set if this field had no index configuration
-        # (when `uses_ancestor_config` is false).
+        # s index configuration is set (when `uses_ancestor_config` is true), or from
+        # which it *would* be set if this field had no index configuration (when `
+        # uses_ancestor_config` is false).
         # Corresponds to the JSON property `ancestorField`
         # @return [String]
         attr_accessor :ancestor_field
@@ -433,19 +411,18 @@ module Google
         # @return [Array<Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Index>]
         attr_accessor :indexes
       
-        # Output only
-        # When true, the `Field`'s index configuration is in the process of being
-        # reverted. Once complete, the index config will transition to the same
-        # state as the field specified by `ancestor_field`, at which point
-        # `uses_ancestor_config` will be `true` and `reverting` will be `false`.
+        # Output only When true, the `Field`'s index configuration is in the process of
+        # being reverted. Once complete, the index config will transition to the same
+        # state as the field specified by `ancestor_field`, at which point `
+        # uses_ancestor_config` will be `true` and `reverting` will be `false`.
         # Corresponds to the JSON property `reverting`
         # @return [Boolean]
         attr_accessor :reverting
         alias_method :reverting?, :reverting
       
         # Output only. When true, the `Field`'s index configuration is set from the
-        # configuration specified by the `ancestor_field`.
-        # When false, the `Field`'s index configuration is defined explicitly.
+        # configuration specified by the `ancestor_field`. When false, the `Field`'s
+        # index configuration is defined explicitly.
         # Corresponds to the JSON property `usesAncestorConfig`
         # @return [Boolean]
         attr_accessor :uses_ancestor_config
@@ -473,8 +450,8 @@ module Google
         # @return [String]
         attr_accessor :change_type
       
-        # Cloud Firestore indexes enable simple and complex queries against
-        # documents in a database.
+        # Cloud Firestore indexes enable simple and complex queries against documents in
+        # a database.
         # Corresponds to the JSON property `index`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Index]
         attr_accessor :index
@@ -490,9 +467,8 @@ module Google
         end
       end
       
-      # A field in an index.
-      # The field_path describes which field is indexed, the value_mode describes
-      # how the field value is indexed.
+      # A field in an index. The field_path describes which field is indexed, the
+      # value_mode describes how the field value is indexed.
       class GoogleFirestoreAdminV1beta2IndexField
         include Google::Apis::Core::Hashable
       
@@ -501,9 +477,8 @@ module Google
         # @return [String]
         attr_accessor :array_config
       
-        # Can be __name__.
-        # For single field indexes, this must match the name of the field or may
-        # be omitted.
+        # Can be __name__. For single field indexes, this must match the name of the
+        # field or may be omitted.
         # Corresponds to the JSON property `fieldPath`
         # @return [String]
         attr_accessor :field_path
@@ -526,8 +501,8 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.CreateIndex.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # CreateIndex.
       class GoogleFirestoreAdminV1beta2IndexOperationMetadata
         include Google::Apis::Core::Hashable
       
@@ -537,23 +512,21 @@ module Google
         # @return [String]
         attr_accessor :end_time
       
-        # The index resource that this operation is acting on. For example:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /indexes/`index_id``
+        # The index resource that this operation is acting on. For example: `projects/`
+        # project_id`/databases/`database_id`/collectionGroups/`collection_id`/indexes/`
+        # index_id``
         # Corresponds to the JSON property `index`
         # @return [String]
         attr_accessor :index
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressBytes`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :progress_bytes
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressDocuments`
         # @return [Google::Apis::FirestoreV1beta2::GoogleFirestoreAdminV1beta2Progress]
         attr_accessor :progress_documents
@@ -635,9 +608,8 @@ module Google
         end
       end
       
-      # Describes the progress of the operation.
-      # Unit of work is generic and must be interpreted based on where Progress
-      # is used.
+      # Describes the progress of the operation. Unit of work is generic and must be
+      # interpreted based on where Progress is used.
       class GoogleFirestoreAdminV1beta2Progress
         include Google::Apis::Core::Hashable
       
@@ -667,47 +639,45 @@ module Google
       class GoogleLongrunningOperation
         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::FirestoreV1beta2::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
@@ -726,12 +696,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
       
@@ -740,15 +710,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