google-cloud-firestore 1.3.0 → 1.4.4

data/lib/google/cloud/firestore/v1/firestore_client_config.json

@@ -7,7 +7,11 @@
           "INTERNAL",
           "UNAVAILABLE"
         ],
-        "non_idempotent": []
+        "non_idempotent": [],
+        "idempotent2": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
       },
       "retry_params": {
         "default": {
@@ -32,12 +36,12 @@
       "methods": {
         "GetDocument": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
         "ListDocuments": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
         "CreateDocument": {
@@ -56,7 +60,7 @@
           "retry_params_name": "default"
         },
         "BatchGetDocuments": {
-          "timeout_millis": 300000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "streaming"
         },
@@ -81,12 +85,12 @@
           "retry_params_name": "streaming"
         },
         "Write": {
-          "timeout_millis": 86400000,
+          "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "streaming"
         },
         "Listen": {
-          "timeout_millis": 86400000,
+          "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "streaming"
         },

data/lib/google/cloud/firestore/v1beta1.rb

@@ -21,6 +21,8 @@ module Google
       # rubocop:disable LineLength
 
       ##
+      # @deprecated Use Google::Cloud::Firestore::V1 instead.
+      #
       # # Ruby Client for Google Cloud Firestore API
       #
       # [Google Cloud Firestore API][Product Documentation]:

data/lib/google/cloud/firestore/v1beta1/firestore_client.rb

@@ -33,6 +33,8 @@ module Google
   module Cloud
     module Firestore
       module V1beta1
+        # @deprecated Use Google::Cloud::Firestore::V1::FirestoreClient instead.
+        #
         # The Cloud Firestore service.
         #
         # This service exposes several types of comparable timestamps:
@@ -68,14 +70,14 @@ module Google
           DEFAULT_TIMEOUT = 30
 
           PAGE_DESCRIPTORS = {
-            "list_documents" => Google::Gax::PageDescriptor.new(
+            "list_collection_ids" => Google::Gax::PageDescriptor.new(
               "page_token",
               "next_page_token",
-              "documents"),
-            "list_collection_ids" => Google::Gax::PageDescriptor.new(
+              "collection_ids"),
+            "list_documents" => Google::Gax::PageDescriptor.new(
               "page_token",
               "next_page_token",
-              "collection_ids")
+              "documents")
           }.freeze
 
           private_constant :PAGE_DESCRIPTORS
@@ -88,80 +90,6 @@ module Google
           ].freeze
 
 
-          ANY_PATH_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/databases/{database}/documents/{document}/{any_path=**}"
-          )
-
-          private_constant :ANY_PATH_PATH_TEMPLATE
-
-          DATABASE_ROOT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/databases/{database}"
-          )
-
-          private_constant :DATABASE_ROOT_PATH_TEMPLATE
-
-          DOCUMENT_PATH_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/databases/{database}/documents/{document_path=**}"
-          )
-
-          private_constant :DOCUMENT_PATH_PATH_TEMPLATE
-
-          DOCUMENT_ROOT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/databases/{database}/documents"
-          )
-
-          private_constant :DOCUMENT_ROOT_PATH_TEMPLATE
-
-          # Returns a fully-qualified any_path resource name string.
-          # @param project [String]
-          # @param database [String]
-          # @param document [String]
-          # @param any_path [String]
-          # @return [String]
-          def self.any_path_path project, database, document, any_path
-            ANY_PATH_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"database" => database,
-              :"document" => document,
-              :"any_path" => any_path
-            )
-          end
-
-          # Returns a fully-qualified database_root resource name string.
-          # @param project [String]
-          # @param database [String]
-          # @return [String]
-          def self.database_root_path project, database
-            DATABASE_ROOT_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"database" => database
-            )
-          end
-
-          # Returns a fully-qualified document_path resource name string.
-          # @param project [String]
-          # @param database [String]
-          # @param document_path [String]
-          # @return [String]
-          def self.document_path_path project, database, document_path
-            DOCUMENT_PATH_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"database" => database,
-              :"document_path" => document_path
-            )
-          end
-
-          # Returns a fully-qualified document_root resource name string.
-          # @param project [String]
-          # @param database [String]
-          # @return [String]
-          def self.document_root_path project, database
-            DOCUMENT_ROOT_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"database" => database
-            )
-          end
-
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -239,6 +167,9 @@ module Google
             google_api_client.freeze
 
             headers = { :"x-goog-api-client" => google_api_client }
+            if credentials.respond_to?(:quota_project_id) && credentials.quota_project_id
+              headers[:"x-goog-user-project"] = credentials.quota_project_id
+            end
             headers.merge!(metadata) unless metadata.nil?
             client_config_file = Pathname.new(__dir__).join(
               "firestore_client_config.json"
@@ -271,32 +202,6 @@ module Google
               &Google::Firestore::V1beta1::Firestore::Stub.method(:new)
             )
 
-            @get_document = Google::Gax.create_api_call(
-              @firestore_stub.method(:get_document),
-              defaults["get_document"],
-              exception_transformer: exception_transformer,
-              params_extractor: proc do |request|
-                {'name' => request.name}
-              end
-            )
-            @list_documents = Google::Gax.create_api_call(
-              @firestore_stub.method(:list_documents),
-              defaults["list_documents"],
-              exception_transformer: exception_transformer
-            )
-            @create_document = Google::Gax.create_api_call(
-              @firestore_stub.method(:create_document),
-              defaults["create_document"],
-              exception_transformer: exception_transformer
-            )
-            @update_document = Google::Gax.create_api_call(
-              @firestore_stub.method(:update_document),
-              defaults["update_document"],
-              exception_transformer: exception_transformer,
-              params_extractor: proc do |request|
-                {'document.name' => request.document.name}
-              end
-            )
             @delete_document = Google::Gax.create_api_call(
               @firestore_stub.method(:delete_document),
               defaults["delete_document"],
@@ -321,14 +226,6 @@ module Google
                 {'database' => request.database}
               end
             )
-            @commit = Google::Gax.create_api_call(
-              @firestore_stub.method(:commit),
-              defaults["commit"],
-              exception_transformer: exception_transformer,
-              params_extractor: proc do |request|
-                {'database' => request.database}
-              end
-            )
             @rollback = Google::Gax.create_api_call(
               @firestore_stub.method(:rollback),
               defaults["rollback"],
@@ -363,351 +260,248 @@ module Google
                 {'parent' => request.parent}
               end
             )
+            @get_document = Google::Gax.create_api_call(
+              @firestore_stub.method(:get_document),
+              defaults["get_document"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
+            @list_documents = Google::Gax.create_api_call(
+              @firestore_stub.method(:list_documents),
+              defaults["list_documents"],
+              exception_transformer: exception_transformer
+            )
+            @create_document = Google::Gax.create_api_call(
+              @firestore_stub.method(:create_document),
+              defaults["create_document"],
+              exception_transformer: exception_transformer
+            )
+            @update_document = Google::Gax.create_api_call(
+              @firestore_stub.method(:update_document),
+              defaults["update_document"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'document.name' => request.document.name}
+              end
+            )
+            @commit = Google::Gax.create_api_call(
+              @firestore_stub.method(:commit),
+              defaults["commit"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'database' => request.database}
+              end
+            )
           end
 
           # Service calls
 
-          # Gets a single document.
+          # Deletes a document.
           #
           # @param name [String]
-          #   Required. The resource name of the Document to get. In the format:
+          #   Required. The resource name of the Document to delete. In the format:
           #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
-          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
-          #   The fields to return. If not set, returns all fields.
-          #
-          #   If the document has a field that is not present in this mask, that field
-          #   will not be returned in the response.
-          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
-          #   can also be provided.
-          # @param transaction [String]
-          #   Reads the document in a transaction.
-          # @param read_time [Google::Protobuf::Timestamp | Hash]
-          #   Reads the version of the document at the given time.
-          #   This may not be older than 60 seconds.
-          #   A hash of the same form as `Google::Protobuf::Timestamp`
+          # @param current_document [Google::Firestore::V1beta1::Precondition | Hash]
+          #   An optional precondition on the document.
+          #   The request will fail if this is set and not met by the target document.
+          #   A hash of the same form as `Google::Firestore::V1beta1::Precondition`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Firestore::V1beta1::Document]
+          # @yieldparam result []
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Firestore::V1beta1::Document]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_name = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
-          #   response = firestore_client.get_document(formatted_name)
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #   firestore_client.delete_document(name)
 
-          def get_document \
+          def delete_document \
               name,
-              mask: nil,
-              transaction: nil,
-              read_time: nil,
+              current_document: nil,
               options: nil,
               &block
             req = {
               name: name,
-              mask: mask,
-              transaction: transaction,
-              read_time: read_time
+              current_document: current_document
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::GetDocumentRequest)
-            @get_document.call(req, options, &block)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::DeleteDocumentRequest)
+            @delete_document.call(req, options, &block)
+            nil
           end
 
-          # Lists documents.
+          # Gets multiple documents.
           #
-          # @param parent [String]
-          #   Required. The parent resource name. In the format:
-          #   `projects/{project_id}/databases/{database_id}/documents` or
+          # Documents returned by this method are not guaranteed to be returned in the
+          # same order that they were requested.
+          #
+          # @param database [String]
+          #   Required. The database name. In the format:
+          #   `projects/{project_id}/databases/{database_id}`.
+          # @param documents [Array<String>]
+          #   The names of the documents to retrieve. In the format:
           #   `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 collection_id [String]
-          #   Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`
-          #   or `messages`.
-          # @param page_size [Integer]
-          #   The maximum number of resources contained in the underlying API
-          #   response. If page streaming is performed per-resource, this
-          #   parameter does not affect the return value. If page streaming is
-          #   performed per-page, this determines the maximum number of
-          #   resources in a page.
-          # @param order_by [String]
-          #   The order to sort results by. For example: `priority desc, name`.
+          #   The request will fail if any of the document is not a child resource of the
+          #   given `database`. Duplicate names will be elided.
           # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
           #   The fields to return. If not set, returns all fields.
           #
-          #   If a document has a field that is not present in this mask, that field
-          #   will not be returned in the response.
+          #   If a document has a field that is not present in this mask, that field will
+          #   not be returned in the response.
           #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
           #   can also be provided.
           # @param transaction [String]
           #   Reads documents in a transaction.
+          # @param new_transaction [Google::Firestore::V1beta1::TransactionOptions | Hash]
+          #   Starts a new transaction and reads the documents.
+          #   Defaults to a read-only transaction.
+          #   The new transaction ID will be returned as the first response in the
+          #   stream.
+          #   A hash of the same form as `Google::Firestore::V1beta1::TransactionOptions`
+          #   can also be provided.
           # @param read_time [Google::Protobuf::Timestamp | Hash]
           #   Reads documents as they were at the given time.
           #   This may not be older than 60 seconds.
           #   A hash of the same form as `Google::Protobuf::Timestamp`
           #   can also be provided.
-          # @param show_missing [true, false]
-          #   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, {Google::Firestore::V1beta1::Document#create_time Document#create_time},
-          #   or {Google::Firestore::V1beta1::Document#update_time Document#update_time} set.
-          #
-          #   Requests with `show_missing` may not specify `where` or
-          #   `order_by`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Firestore::V1beta1::Document>]
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Gax::PagedEnumerable<Google::Firestore::V1beta1::Document>]
-          #   An enumerable of Google::Firestore::V1beta1::Document instances.
-          #   See Google::Gax::PagedEnumerable documentation for other
-          #   operations such as per-page iteration or access to the response
-          #   object.
+          # @return [Enumerable<Google::Firestore::V1beta1::BatchGetDocumentsResponse>]
+          #   An enumerable of Google::Firestore::V1beta1::BatchGetDocumentsResponse instances.
+          #
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_parent = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
-          #
-          #   # TODO: Initialize `collection_id`:
-          #   collection_id = ''
           #
-          #   # Iterate over all results.
-          #   firestore_client.list_documents(formatted_parent, collection_id).each do |element|
+          #   # TODO: Initialize `database`:
+          #   database = ''
+          #   firestore_client.batch_get_documents(database).each do |element|
           #     # Process element.
           #   end
-          #
-          #   # Or iterate over results one page at a time.
-          #   firestore_client.list_documents(formatted_parent, collection_id).each_page do |page|
-          #     # Process each page at a time.
-          #     page.each do |element|
-          #       # Process element.
-          #     end
-          #   end
 
-          def list_documents \
-              parent,
-              collection_id,
-              page_size: nil,
-              order_by: nil,
+          def batch_get_documents \
+              database,
+              documents: nil,
               mask: nil,
               transaction: nil,
+              new_transaction: nil,
               read_time: nil,
-              show_missing: nil,
-              options: nil,
-              &block
+              options: nil
             req = {
-              parent: parent,
-              collection_id: collection_id,
-              page_size: page_size,
-              order_by: order_by,
+              database: database,
+              documents: documents,
               mask: mask,
               transaction: transaction,
-              read_time: read_time,
-              show_missing: show_missing
+              new_transaction: new_transaction,
+              read_time: read_time
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::ListDocumentsRequest)
-            @list_documents.call(req, options, &block)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::BatchGetDocumentsRequest)
+            @batch_get_documents.call(req, options)
           end
 
-          # Creates a new document.
-          #
-          # @param parent [String]
-          #   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 collection_id [String]
-          #   Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`.
-          # @param document_id [String]
-          #   The client-assigned document ID to use for this document.
+          # Starts a new transaction.
           #
-          #   Optional. If not specified, an ID will be assigned by the service.
-          # @param document [Google::Firestore::V1beta1::Document | Hash]
-          #   Required. The document to create. `name` must not be set.
-          #   A hash of the same form as `Google::Firestore::V1beta1::Document`
-          #   can also be provided.
-          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
-          #   The fields to return. If not set, returns all fields.
-          #
-          #   If the document has a field that is not present in this mask, that field
-          #   will not be returned in the response.
-          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
+          # @param database [String]
+          #   Required. The database name. In the format:
+          #   `projects/{project_id}/databases/{database_id}`.
+          # @param options_ [Google::Firestore::V1beta1::TransactionOptions | Hash]
+          #   The options for the transaction.
+          #   Defaults to a read-write transaction.
+          #   A hash of the same form as `Google::Firestore::V1beta1::TransactionOptions`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Firestore::V1beta1::Document]
+          # @yieldparam result [Google::Firestore::V1beta1::BeginTransactionResponse]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Firestore::V1beta1::Document]
+          # @return [Google::Firestore::V1beta1::BeginTransactionResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_parent = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
-          #
-          #   # TODO: Initialize `collection_id`:
-          #   collection_id = ''
           #
-          #   # TODO: Initialize `document_id`:
-          #   document_id = ''
-          #
-          #   # TODO: Initialize `document`:
-          #   document = {}
-          #   response = firestore_client.create_document(formatted_parent, collection_id, document_id, document)
+          #   # TODO: Initialize `database`:
+          #   database = ''
+          #   response = firestore_client.begin_transaction(database)
 
-          def create_document \
-              parent,
-              collection_id,
-              document_id,
-              document,
-              mask: nil,
+          def begin_transaction \
+              database,
+              options_: nil,
               options: nil,
               &block
             req = {
-              parent: parent,
-              collection_id: collection_id,
-              document_id: document_id,
-              document: document,
-              mask: mask
+              database: database,
+              options: options_
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::CreateDocumentRequest)
-            @create_document.call(req, options, &block)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::BeginTransactionRequest)
+            @begin_transaction.call(req, options, &block)
           end
 
-          # Updates or inserts a document.
-          #
-          # @param document [Google::Firestore::V1beta1::Document | Hash]
-          #   Required. The updated document.
-          #   Creates the document if it does not already exist.
-          #   A hash of the same form as `Google::Firestore::V1beta1::Document`
-          #   can also be provided.
-          # @param update_mask [Google::Firestore::V1beta1::DocumentMask | Hash]
-          #   The fields to update.
-          #   None of the field paths in the mask may contain a reserved name.
-          #
-          #   If the document exists on the server and has fields not referenced in the
-          #   mask, they are left unchanged.
-          #   Fields referenced in the mask, but not present in the input document, are
-          #   deleted from the document on the server.
-          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
-          #   can also be provided.
-          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
-          #   The fields to return. If not set, returns all fields.
+          # Rolls back a transaction.
           #
-          #   If the document has a field that is not present in this mask, that field
-          #   will not be returned in the response.
-          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
-          #   can also be provided.
-          # @param current_document [Google::Firestore::V1beta1::Precondition | Hash]
-          #   An optional precondition on the document.
-          #   The request will fail if this is set and not met by the target document.
-          #   A hash of the same form as `Google::Firestore::V1beta1::Precondition`
-          #   can also be provided.
+          # @param database [String]
+          #   Required. The database name. In the format:
+          #   `projects/{project_id}/databases/{database_id}`.
+          # @param transaction [String]
+          #   Required. The transaction to roll back.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Firestore::V1beta1::Document]
+          # @yieldparam result []
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Firestore::V1beta1::Document]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
           #
-          #   # TODO: Initialize `document`:
-          #   document = {}
-          #
-          #   # TODO: Initialize `update_mask`:
-          #   update_mask = {}
-          #   response = firestore_client.update_document(document, update_mask)
-
-          def update_document \
-              document,
-              update_mask,
-              mask: nil,
-              current_document: nil,
-              options: nil,
-              &block
-            req = {
-              document: document,
-              update_mask: update_mask,
-              mask: mask,
-              current_document: current_document
-            }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::UpdateDocumentRequest)
-            @update_document.call(req, options, &block)
-          end
-
-          # Deletes a document.
-          #
-          # @param name [String]
-          #   Required. The resource name of the Document to delete. In the format:
-          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
-          # @param current_document [Google::Firestore::V1beta1::Precondition | Hash]
-          #   An optional precondition on the document.
-          #   The request will fail if this is set and not met by the target document.
-          #   A hash of the same form as `Google::Firestore::V1beta1::Precondition`
-          #   can also be provided.
-          # @param options [Google::Gax::CallOptions]
-          #   Overrides the default settings for this call, e.g, timeout,
-          #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result []
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @raise [Google::Gax::GaxError] if the RPC is aborted.
-          # @example
-          #   require "google/cloud/firestore/v1beta1"
+          #   # TODO: Initialize `database`:
+          #   database = ''
           #
-          #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_name = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
-          #   firestore_client.delete_document(formatted_name)
+          #   # TODO: Initialize `transaction`:
+          #   transaction = ''
+          #   firestore_client.rollback(database, transaction)
 
-          def delete_document \
-              name,
-              current_document: nil,
+          def rollback \
+              database,
+              transaction,
               options: nil,
               &block
             req = {
-              name: name,
-              current_document: current_document
+              database: database,
+              transaction: transaction
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::DeleteDocumentRequest)
-            @delete_document.call(req, options, &block)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::RollbackRequest)
+            @rollback.call(req, options, &block)
             nil
           end
 
-          # Gets multiple documents.
-          #
-          # Documents returned by this method are not guaranteed to be returned in the
-          # same order that they were requested.
+          # Runs a query.
           #
-          # @param database [String]
-          #   Required. The database name. In the format:
-          #   `projects/{project_id}/databases/{database_id}`.
-          # @param documents [Array<String>]
-          #   The names of the documents to retrieve. In the format:
+          # @param parent [String]
+          #   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}`.
-          #   The request will fail if any of the document is not a child resource of the
-          #   given `database`. Duplicate names will be elided.
-          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
-          #   The fields to return. If not set, returns all fields.
-          #
-          #   If a document has a field that is not present in this mask, that field will
-          #   not be returned in the response.
-          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
+          #   For example:
+          #   `projects/my-project/databases/my-database/documents` or
+          #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
+          # @param structured_query [Google::Firestore::V1beta1::StructuredQuery | Hash]
+          #   A structured query.
+          #   A hash of the same form as `Google::Firestore::V1beta1::StructuredQuery`
           #   can also be provided.
           # @param transaction [String]
           #   Reads documents in a transaction.
@@ -726,165 +520,226 @@ module Google
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @return [Enumerable<Google::Firestore::V1beta1::BatchGetDocumentsResponse>]
-          #   An enumerable of Google::Firestore::V1beta1::BatchGetDocumentsResponse instances.
+          # @return [Enumerable<Google::Firestore::V1beta1::RunQueryResponse>]
+          #   An enumerable of Google::Firestore::V1beta1::RunQueryResponse instances.
           #
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
           #
-          #   # TODO: Initialize `documents`:
-          #   documents = []
-          #   firestore_client.batch_get_documents(formatted_database, documents).each do |element|
+          #   # TODO: Initialize `parent`:
+          #   parent = ''
+          #   firestore_client.run_query(parent).each do |element|
           #     # Process element.
           #   end
 
-          def batch_get_documents \
-              database,
-              documents,
-              mask: nil,
+          def run_query \
+              parent,
+              structured_query: nil,
               transaction: nil,
               new_transaction: nil,
               read_time: nil,
               options: nil
             req = {
-              database: database,
-              documents: documents,
-              mask: mask,
+              parent: parent,
+              structured_query: structured_query,
               transaction: transaction,
               new_transaction: new_transaction,
               read_time: read_time
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::BatchGetDocumentsRequest)
-            @batch_get_documents.call(req, options)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::RunQueryRequest)
+            @run_query.call(req, options)
           end
 
-          # Starts a new transaction.
+          # Streams batches of document updates and deletes, in order.
           #
-          # @param database [String]
-          #   Required. The database name. In the format:
-          #   `projects/{project_id}/databases/{database_id}`.
-          # @param options_ [Google::Firestore::V1beta1::TransactionOptions | Hash]
-          #   The options for the transaction.
-          #   Defaults to a read-write transaction.
-          #   A hash of the same form as `Google::Firestore::V1beta1::TransactionOptions`
-          #   can also be provided.
+          # @param reqs [Enumerable<Google::Firestore::V1beta1::WriteRequest>]
+          #   The input requests.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Firestore::V1beta1::BeginTransactionResponse]
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Firestore::V1beta1::BeginTransactionResponse]
+          # @return [Enumerable<Google::Firestore::V1beta1::WriteResponse>]
+          #   An enumerable of Google::Firestore::V1beta1::WriteResponse instances.
+          #
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          #
+          # @note
+          #   EXPERIMENTAL:
+          #     Streaming requests are still undergoing review.
+          #     This method interface might change in the future.
+          #
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
-          #   response = firestore_client.begin_transaction(formatted_database)
+          #
+          #   # TODO: Initialize `database`:
+          #   database = ''
+          #   request = { database: database }
+          #   requests = [request]
+          #   firestore_client.write(requests).each do |element|
+          #     # Process element.
+          #   end
 
-          def begin_transaction \
-              database,
-              options_: nil,
-              options: nil,
-              &block
-            req = {
-              database: database,
-              options: options_
-            }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::BeginTransactionRequest)
-            @begin_transaction.call(req, options, &block)
+          def write reqs, options: nil
+            request_protos = reqs.lazy.map do |req|
+              Google::Gax::to_proto(req, Google::Firestore::V1beta1::WriteRequest)
+            end
+            @write.call(request_protos, options)
           end
 
-          # Commits a transaction, while optionally updating documents.
-          #
-          # @param database [String]
-          #   Required. The database name. In the format:
-          #   `projects/{project_id}/databases/{database_id}`.
-          # @param writes [Array<Google::Firestore::V1beta1::Write | Hash>]
-          #   The writes to apply.
+          # Listens to changes.
           #
-          #   Always executed atomically and in order.
-          #   A hash of the same form as `Google::Firestore::V1beta1::Write`
-          #   can also be provided.
-          # @param transaction [String]
-          #   If set, applies all writes in this transaction, and commits it.
+          # @param reqs [Enumerable<Google::Firestore::V1beta1::ListenRequest>]
+          #   The input requests.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Firestore::V1beta1::CommitResponse]
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Firestore::V1beta1::CommitResponse]
+          # @return [Enumerable<Google::Firestore::V1beta1::ListenResponse>]
+          #   An enumerable of Google::Firestore::V1beta1::ListenResponse instances.
+          #
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          #
+          # @note
+          #   EXPERIMENTAL:
+          #     Streaming requests are still undergoing review.
+          #     This method interface might change in the future.
+          #
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
           #
-          #   # TODO: Initialize `writes`:
-          #   writes = []
-          #   response = firestore_client.commit(formatted_database, writes)
+          #   # TODO: Initialize `database`:
+          #   database = ''
+          #   request = { database: database }
+          #   requests = [request]
+          #   firestore_client.listen(requests).each do |element|
+          #     # Process element.
+          #   end
 
-          def commit \
-              database,
-              writes,
-              transaction: nil,
+          def listen reqs, options: nil
+            request_protos = reqs.lazy.map do |req|
+              Google::Gax::to_proto(req, Google::Firestore::V1beta1::ListenRequest)
+            end
+            @listen.call(request_protos, options)
+          end
+
+          # Lists all the collection IDs underneath a document.
+          #
+          # @param parent [String]
+          #   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 page_size [Integer]
+          #   The maximum number of resources contained in the underlying API
+          #   response. If page streaming is performed per-resource, this
+          #   parameter does not affect the return value. If page streaming is
+          #   performed per-page, this determines the maximum number of
+          #   resources in a page.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Gax::PagedEnumerable<String>]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Gax::PagedEnumerable<String>]
+          #   An enumerable of String instances.
+          #   See Google::Gax::PagedEnumerable documentation for other
+          #   operations such as per-page iteration or access to the response
+          #   object.
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/firestore/v1beta1"
+          #
+          #   firestore_client = Google::Cloud::Firestore::V1beta1.new
+          #
+          #   # TODO: Initialize `parent`:
+          #   parent = ''
+          #
+          #   # Iterate over all results.
+          #   firestore_client.list_collection_ids(parent).each do |element|
+          #     # Process element.
+          #   end
+          #
+          #   # Or iterate over results one page at a time.
+          #   firestore_client.list_collection_ids(parent).each_page do |page|
+          #     # Process each page at a time.
+          #     page.each do |element|
+          #       # Process element.
+          #     end
+          #   end
+
+          def list_collection_ids \
+              parent,
+              page_size: nil,
               options: nil,
               &block
             req = {
-              database: database,
-              writes: writes,
-              transaction: transaction
+              parent: parent,
+              page_size: page_size
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::CommitRequest)
-            @commit.call(req, options, &block)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::ListCollectionIdsRequest)
+            @list_collection_ids.call(req, options, &block)
           end
 
-          # Rolls back a transaction.
+          # Gets a single document.
           #
-          # @param database [String]
-          #   Required. The database name. In the format:
-          #   `projects/{project_id}/databases/{database_id}`.
+          # @param name [String]
+          #   Required. The resource name of the Document to get. In the format:
+          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
+          #   The fields to return. If not set, returns all fields.
+          #
+          #   If the document has a field that is not present in this mask, that field
+          #   will not be returned in the response.
+          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
+          #   can also be provided.
           # @param transaction [String]
-          #   Required. The transaction to roll back.
+          #   Reads the document in a transaction.
+          # @param read_time [Google::Protobuf::Timestamp | Hash]
+          #   Reads the version of the document at the given time.
+          #   This may not be older than 60 seconds.
+          #   A hash of the same form as `Google::Protobuf::Timestamp`
+          #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result []
+          # @yieldparam result [Google::Firestore::V1beta1::Document]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Firestore::V1beta1::Document]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
           #
-          #   # TODO: Initialize `transaction`:
-          #   transaction = ''
-          #   firestore_client.rollback(formatted_database, transaction)
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #   response = firestore_client.get_document(name)
 
-          def rollback \
-              database,
-              transaction,
+          def get_document \
+              name,
+              mask: nil,
+              transaction: nil,
+              read_time: nil,
               options: nil,
               &block
             req = {
-              database: database,
-              transaction: transaction
+              name: name,
+              mask: mask,
+              transaction: transaction,
+              read_time: read_time
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::RollbackRequest)
-            @rollback.call(req, options, &block)
-            nil
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::GetDocumentRequest)
+            @get_document.call(req, options, &block)
           end
 
-          # Runs a query.
+          # Lists documents.
           #
           # @param parent [String]
           #   Required. The parent resource name. In the format:
@@ -893,183 +748,271 @@ module Google
           #   For example:
           #   `projects/my-project/databases/my-database/documents` or
           #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
-          # @param structured_query [Google::Firestore::V1beta1::StructuredQuery | Hash]
-          #   A structured query.
-          #   A hash of the same form as `Google::Firestore::V1beta1::StructuredQuery`
+          # @param collection_id [String]
+          #   Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`
+          #   or `messages`.
+          # @param page_size [Integer]
+          #   The maximum number of resources contained in the underlying API
+          #   response. If page streaming is performed per-resource, this
+          #   parameter does not affect the return value. If page streaming is
+          #   performed per-page, this determines the maximum number of
+          #   resources in a page.
+          # @param order_by [String]
+          #   The order to sort results by. For example: `priority desc, name`.
+          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
+          #   The fields to return. If not set, returns all fields.
+          #
+          #   If a document has a field that is not present in this mask, that field
+          #   will not be returned in the response.
+          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
           #   can also be provided.
           # @param transaction [String]
           #   Reads documents in a transaction.
-          # @param new_transaction [Google::Firestore::V1beta1::TransactionOptions | Hash]
-          #   Starts a new transaction and reads the documents.
-          #   Defaults to a read-only transaction.
-          #   The new transaction ID will be returned as the first response in the
-          #   stream.
-          #   A hash of the same form as `Google::Firestore::V1beta1::TransactionOptions`
-          #   can also be provided.
           # @param read_time [Google::Protobuf::Timestamp | Hash]
           #   Reads documents as they were at the given time.
           #   This may not be older than 60 seconds.
           #   A hash of the same form as `Google::Protobuf::Timestamp`
           #   can also be provided.
+          # @param show_missing [true, false]
+          #   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, {Google::Firestore::V1beta1::Document#create_time Document#create_time},
+          #   or {Google::Firestore::V1beta1::Document#update_time Document#update_time} set.
+          #
+          #   Requests with `show_missing` may not specify `where` or
+          #   `order_by`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @return [Enumerable<Google::Firestore::V1beta1::RunQueryResponse>]
-          #   An enumerable of Google::Firestore::V1beta1::RunQueryResponse instances.
-          #
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Gax::PagedEnumerable<Google::Firestore::V1beta1::Document>]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Gax::PagedEnumerable<Google::Firestore::V1beta1::Document>]
+          #   An enumerable of Google::Firestore::V1beta1::Document instances.
+          #   See Google::Gax::PagedEnumerable documentation for other
+          #   operations such as per-page iteration or access to the response
+          #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_parent = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
-          #   firestore_client.run_query(formatted_parent).each do |element|
+          #
+          #   # TODO: Initialize `parent`:
+          #   parent = ''
+          #
+          #   # TODO: Initialize `collection_id`:
+          #   collection_id = ''
+          #
+          #   # Iterate over all results.
+          #   firestore_client.list_documents(parent, collection_id).each do |element|
           #     # Process element.
           #   end
+          #
+          #   # Or iterate over results one page at a time.
+          #   firestore_client.list_documents(parent, collection_id).each_page do |page|
+          #     # Process each page at a time.
+          #     page.each do |element|
+          #       # Process element.
+          #     end
+          #   end
 
-          def run_query \
+          def list_documents \
               parent,
-              structured_query: nil,
+              collection_id,
+              page_size: nil,
+              order_by: nil,
+              mask: nil,
               transaction: nil,
-              new_transaction: nil,
               read_time: nil,
-              options: nil
+              show_missing: nil,
+              options: nil,
+              &block
             req = {
               parent: parent,
-              structured_query: structured_query,
+              collection_id: collection_id,
+              page_size: page_size,
+              order_by: order_by,
+              mask: mask,
               transaction: transaction,
-              new_transaction: new_transaction,
-              read_time: read_time
+              read_time: read_time,
+              show_missing: show_missing
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::RunQueryRequest)
-            @run_query.call(req, options)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::ListDocumentsRequest)
+            @list_documents.call(req, options, &block)
           end
 
-          # Streams batches of document updates and deletes, in order.
+          # Creates a new document.
           #
-          # @param reqs [Enumerable<Google::Firestore::V1beta1::WriteRequest>]
-          #   The input requests.
+          # @param parent [String]
+          #   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 collection_id [String]
+          #   Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+          # @param document [Google::Firestore::V1beta1::Document | Hash]
+          #   Required. The document to create. `name` must not be set.
+          #   A hash of the same form as `Google::Firestore::V1beta1::Document`
+          #   can also be provided.
+          # @param document_id [String]
+          #   The client-assigned document ID to use for this document.
+          #
+          #   Optional. If not specified, an ID will be assigned by the service.
+          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
+          #   The fields to return. If not set, returns all fields.
+          #
+          #   If the document has a field that is not present in this mask, that field
+          #   will not be returned in the response.
+          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
+          #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @return [Enumerable<Google::Firestore::V1beta1::WriteResponse>]
-          #   An enumerable of Google::Firestore::V1beta1::WriteResponse instances.
-          #
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Firestore::V1beta1::Document]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Firestore::V1beta1::Document]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
-          #
-          # @note
-          #   EXPERIMENTAL:
-          #     Streaming requests are still undergoing review.
-          #     This method interface might change in the future.
-          #
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
-          #   request = { database: formatted_database }
-          #   requests = [request]
-          #   firestore_client.write(requests).each do |element|
-          #     # Process element.
-          #   end
+          #
+          #   # TODO: Initialize `parent`:
+          #   parent = ''
+          #
+          #   # TODO: Initialize `collection_id`:
+          #   collection_id = ''
+          #
+          #   # TODO: Initialize `document`:
+          #   document = {}
+          #   response = firestore_client.create_document(parent, collection_id, document)
 
-          def write reqs, options: nil
-            request_protos = reqs.lazy.map do |req|
-              Google::Gax::to_proto(req, Google::Firestore::V1beta1::WriteRequest)
-            end
-            @write.call(request_protos, options)
+          def create_document \
+              parent,
+              collection_id,
+              document,
+              document_id: nil,
+              mask: nil,
+              options: nil,
+              &block
+            req = {
+              parent: parent,
+              collection_id: collection_id,
+              document: document,
+              document_id: document_id,
+              mask: mask
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::CreateDocumentRequest)
+            @create_document.call(req, options, &block)
           end
 
-          # Listens to changes.
+          # Updates or inserts a document.
           #
-          # @param reqs [Enumerable<Google::Firestore::V1beta1::ListenRequest>]
-          #   The input requests.
+          # @param document [Google::Firestore::V1beta1::Document | Hash]
+          #   Required. The updated document.
+          #   Creates the document if it does not already exist.
+          #   A hash of the same form as `Google::Firestore::V1beta1::Document`
+          #   can also be provided.
+          # @param update_mask [Google::Firestore::V1beta1::DocumentMask | Hash]
+          #   The fields to update.
+          #   None of the field paths in the mask may contain a reserved name.
+          #
+          #   If the document exists on the server and has fields not referenced in the
+          #   mask, they are left unchanged.
+          #   Fields referenced in the mask, but not present in the input document, are
+          #   deleted from the document on the server.
+          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
+          #   can also be provided.
+          # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
+          #   The fields to return. If not set, returns all fields.
+          #
+          #   If the document has a field that is not present in this mask, that field
+          #   will not be returned in the response.
+          #   A hash of the same form as `Google::Firestore::V1beta1::DocumentMask`
+          #   can also be provided.
+          # @param current_document [Google::Firestore::V1beta1::Precondition | Hash]
+          #   An optional precondition on the document.
+          #   The request will fail if this is set and not met by the target document.
+          #   A hash of the same form as `Google::Firestore::V1beta1::Precondition`
+          #   can also be provided.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
-          # @return [Enumerable<Google::Firestore::V1beta1::ListenResponse>]
-          #   An enumerable of Google::Firestore::V1beta1::ListenResponse instances.
-          #
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Firestore::V1beta1::Document]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Firestore::V1beta1::Document]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
-          #
-          # @note
-          #   EXPERIMENTAL:
-          #     Streaming requests are still undergoing review.
-          #     This method interface might change in the future.
-          #
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
-          #   request = { database: formatted_database }
-          #   requests = [request]
-          #   firestore_client.listen(requests).each do |element|
-          #     # Process element.
-          #   end
+          #
+          #   # TODO: Initialize `document`:
+          #   document = {}
+          #   response = firestore_client.update_document(document)
 
-          def listen reqs, options: nil
-            request_protos = reqs.lazy.map do |req|
-              Google::Gax::to_proto(req, Google::Firestore::V1beta1::ListenRequest)
-            end
-            @listen.call(request_protos, options)
+          def update_document \
+              document,
+              update_mask: nil,
+              mask: nil,
+              current_document: nil,
+              options: nil,
+              &block
+            req = {
+              document: document,
+              update_mask: update_mask,
+              mask: mask,
+              current_document: current_document
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::UpdateDocumentRequest)
+            @update_document.call(req, options, &block)
           end
 
-          # Lists all the collection IDs underneath a document.
+          # Commits a transaction, while optionally updating documents.
           #
-          # @param parent [String]
-          #   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 page_size [Integer]
-          #   The maximum number of resources contained in the underlying API
-          #   response. If page streaming is performed per-resource, this
-          #   parameter does not affect the return value. If page streaming is
-          #   performed per-page, this determines the maximum number of
-          #   resources in a page.
+          # @param database [String]
+          #   Required. The database name. In the format:
+          #   `projects/{project_id}/databases/{database_id}`.
+          # @param writes [Array<Google::Firestore::V1beta1::Write | Hash>]
+          #   The writes to apply.
+          #
+          #   Always executed atomically and in order.
+          #   A hash of the same form as `Google::Firestore::V1beta1::Write`
+          #   can also be provided.
+          # @param transaction [String]
+          #   If set, applies all writes in this transaction, and commits it.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Gax::PagedEnumerable<String>]
+          # @yieldparam result [Google::Firestore::V1beta1::CommitResponse]
           # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Gax::PagedEnumerable<String>]
-          #   An enumerable of String instances.
-          #   See Google::Gax::PagedEnumerable documentation for other
-          #   operations such as per-page iteration or access to the response
-          #   object.
+          # @return [Google::Firestore::V1beta1::CommitResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
           #   require "google/cloud/firestore/v1beta1"
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
-          #   formatted_parent = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
-          #
-          #   # Iterate over all results.
-          #   firestore_client.list_collection_ids(formatted_parent).each do |element|
-          #     # Process element.
-          #   end
           #
-          #   # Or iterate over results one page at a time.
-          #   firestore_client.list_collection_ids(formatted_parent).each_page do |page|
-          #     # Process each page at a time.
-          #     page.each do |element|
-          #       # Process element.
-          #     end
-          #   end
+          #   # TODO: Initialize `database`:
+          #   database = ''
+          #   response = firestore_client.commit(database)
 
-          def list_collection_ids \
-              parent,
-              page_size: nil,
+          def commit \
+              database,
+              writes: nil,
+              transaction: nil,
               options: nil,
               &block
             req = {
-              parent: parent,
-              page_size: page_size
+              database: database,
+              writes: writes,
+              transaction: transaction
             }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::ListCollectionIdsRequest)
-            @list_collection_ids.call(req, options, &block)
+            req = Google::Gax::to_proto(req, Google::Firestore::V1beta1::CommitRequest)
+            @commit.call(req, options, &block)
           end
         end
       end