google-cloud-firestore 1.2.1 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b29ff86c36d87de106c57de21c3b95a8b619b277ebcd03b4fd60667105b47a5d
-  data.tar.gz: 98727377686a78257943fee73d9b7ac0bd616a289942067cbdc9160ab45dbeda
+  metadata.gz: 6ef427537b88a216a13b4dd74abec63f412b8515e9e7781aaf1c3d144945e4a1
+  data.tar.gz: 2163095254cda5555d4537c8a88ca6fd85fa0b737ab9be4ca32b4e3944a77799
 SHA512:
-  metadata.gz: 5b78369b8a28c595420617ddcba060e9864440253a5d8ebfd46651fa0ad2c6de95869c41132f23d0657e93a73b77e275a812e41d9d02426d37acc17a2eb3a61f
-  data.tar.gz: 9461ff64e23edd02dd0410096c16f5d892068fcd2bfd6cadb2dc1ac2173f41a7b8a4299a15fef9fc0f7332db67adf84c5c8c93b0810886fb53290d1a642955c7
+  metadata.gz: b8d54d04aab91a4042c9e5d17546c73a0ccadc4af2b224c4a303eb0d43691af3ca4b1effc8c7bd2da92fba67e49c402e698c9caa1dfc411bd539b0fd1f5a09b1
+  data.tar.gz: 00c10d47aeaf52e9fafe544ebd7d9e6fdf38a6541a001977e08c168b8954aed27d6b3e954e2e833b77c17e0788bf85a0fc9de775b302efb61b9a422335ef646f

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History
 
+### 1.2.2 / 2019-12-18
+
+#### Bug Fixes
+
+* Fix MonitorMixin usage on Ruby 2.7
+  * Ruby 2.7 will error if new_cond is called before super().
+  * Make the call to super() be the first call in initialize
+
+#### Documentation
+
+* Update lower-level API documentation
+
 ### 1.2.1 / 2019-11-06
 
 #### Bug Fixes

data/lib/google/cloud/firestore/admin/v1/doc/google/firestore/admin/v1/firestore_admin.rb

@@ -20,17 +20,17 @@ module Google
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::CreateIndex FirestoreAdmin::CreateIndex}.
         # @!attribute [rw] parent
         #   @return [String]
-        #     A parent name of the form
+        #     Required. A parent name of the form
         #     `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
         # @!attribute [rw] index
         #   @return [Google::Firestore::Admin::V1::Index]
-        #     The composite index to create.
+        #     Required. The composite index to create.
         class CreateIndexRequest; end
 
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::ListIndexes FirestoreAdmin::ListIndexes}.
         # @!attribute [rw] parent
         #   @return [String]
-        #     A parent name of the form
+        #     Required. A parent name of the form
         #     `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
         # @!attribute [rw] filter
         #   @return [String]
@@ -58,21 +58,21 @@ module Google
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::GetIndex FirestoreAdmin::GetIndex}.
         # @!attribute [rw] name
         #   @return [String]
-        #     A name of the form
+        #     Required. A name of the form
         #     `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
         class GetIndexRequest; end
 
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::DeleteIndex FirestoreAdmin::DeleteIndex}.
         # @!attribute [rw] name
         #   @return [String]
-        #     A name of the form
+        #     Required. A name of the form
         #     `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
         class DeleteIndexRequest; end
 
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::UpdateField FirestoreAdmin::UpdateField}.
         # @!attribute [rw] field
         #   @return [Google::Firestore::Admin::V1::Field]
-        #     The field to be updated.
+        #     Required. The field to be updated.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
         #     A mask, relative to the field. If specified, only configuration specified
@@ -82,14 +82,14 @@ module Google
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::GetField FirestoreAdmin::GetField}.
         # @!attribute [rw] name
         #   @return [String]
-        #     A name of the form
+        #     Required. A name of the form
         #     `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}`
         class GetFieldRequest; end
 
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::ListFields FirestoreAdmin::ListFields}.
         # @!attribute [rw] parent
         #   @return [String]
-        #     A parent name of the form
+        #     Required. A parent name of the form
         #     `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
         # @!attribute [rw] filter
         #   @return [String]
@@ -121,7 +121,7 @@ module Google
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::ExportDocuments FirestoreAdmin::ExportDocuments}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Database to export. Should be of the form:
+        #     Required. Database to export. Should be of the form:
         #     `projects/{project_id}/databases/{database_id}`.
         # @!attribute [rw] collection_ids
         #   @return [Array<String>]
@@ -141,7 +141,7 @@ module Google
         # The request for {Google::Firestore::Admin::V1::FirestoreAdmin::ImportDocuments FirestoreAdmin::ImportDocuments}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Database to import into. Should be of the form:
+        #     Required. Database to import into. Should be of the form:
         #     `projects/{project_id}/databases/{database_id}`.
         # @!attribute [rw] collection_ids
         #   @return [Array<String>]

data/lib/google/cloud/firestore/admin/v1/firestore_admin_client.rb

@@ -343,10 +343,10 @@ module Google
             # the operation will be the type {Google::Firestore::Admin::V1::IndexOperationMetadata IndexOperationMetadata}.
             #
             # @param parent [String]
-            #   A parent name of the form
+            #   Required. A parent name of the form
             #   `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
             # @param index [Google::Firestore::Admin::V1::Index | Hash]
-            #   The composite index to create.
+            #   Required. The composite index to create.
             #   A hash of the same form as `Google::Firestore::Admin::V1::Index`
             #   can also be provided.
             # @param options [Google::Gax::CallOptions]
@@ -383,7 +383,7 @@ module Google
             # Lists composite indexes.
             #
             # @param parent [String]
-            #   A parent name of the form
+            #   Required. A parent name of the form
             #   `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
             # @param filter [String]
             #   The filter to apply to list results.
@@ -442,7 +442,7 @@ module Google
             # Gets a composite index.
             #
             # @param name [String]
-            #   A name of the form
+            #   Required. A name of the form
             #   `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
@@ -473,7 +473,7 @@ module Google
             # Deletes a composite index.
             #
             # @param name [String]
-            #   A name of the form
+            #   Required. A name of the form
             #   `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
@@ -508,7 +508,7 @@ module Google
             # that a subset of the data has already been imported to Cloud Firestore.
             #
             # @param name [String]
-            #   Database to import into. Should be of the form:
+            #   Required. Database to import into. Should be of the form:
             #   `projects/{project_id}/databases/{database_id}`.
             # @param collection_ids [Array<String>]
             #   Which collection ids to import. Unspecified means all collections included
@@ -559,7 +559,7 @@ module Google
             # Cloud Storage.
             #
             # @param name [String]
-            #   Database to export. Should be of the form:
+            #   Required. Database to export. Should be of the form:
             #   `projects/{project_id}/databases/{database_id}`.
             # @param collection_ids [Array<String>]
             #   Which collection ids to export. Unspecified means all collections.
@@ -605,7 +605,7 @@ module Google
             # Gets the metadata and configuration for a Field.
             #
             # @param name [String]
-            #   A name of the form
+            #   Required. A name of the form
             #   `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}`
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
@@ -641,7 +641,7 @@ module Google
             # `indexConfig.usesAncestorConfig:false`.
             #
             # @param parent [String]
-            #   A parent name of the form
+            #   Required. A parent name of the form
             #   `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
             # @param filter [String]
             #   The filter to apply to list results. Currently,
@@ -716,7 +716,7 @@ module Google
             # `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`.
             #
             # @param field [Google::Firestore::Admin::V1::Field | Hash]
-            #   The field to be updated.
+            #   Required. The field to be updated.
             #   A hash of the same form as `Google::Firestore::Admin::V1::Field`
             #   can also be provided.
             # @param update_mask [Google::Protobuf::FieldMask | Hash]

data/lib/google/cloud/firestore/v1/doc/google/firestore/v1/firestore.rb

@@ -19,7 +19,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::GetDocument Firestore::GetDocument}.
       # @!attribute [rw] name
       #   @return [String]
-      #     The resource name of the Document to get. In the format:
+      #     Required. The resource name of the Document to get. In the format:
       #     `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
       # @!attribute [rw] mask
       #   @return [Google::Firestore::V1::DocumentMask]
@@ -39,7 +39,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::ListDocuments Firestore::ListDocuments}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent resource name. In the format:
+      #     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:
@@ -47,7 +47,7 @@ module Google
       #     `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
       # @!attribute [rw] collection_id
       #   @return [String]
-      #     The collection ID, relative to `parent`, to list. For example: `chatrooms`
+      #     Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`
       #     or `messages`.
       # @!attribute [rw] page_size
       #   @return [Integer]
@@ -94,12 +94,12 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::CreateDocument Firestore::CreateDocument}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent resource. For example:
+      #     Required. The parent resource. For example:
       #     `projects/{project_id}/databases/{database_id}/documents` or
       #     `projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}`
       # @!attribute [rw] collection_id
       #   @return [String]
-      #     The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+      #     Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`.
       # @!attribute [rw] document_id
       #   @return [String]
       #     The client-assigned document ID to use for this document.
@@ -107,7 +107,7 @@ module Google
       #     Optional. If not specified, an ID will be assigned by the service.
       # @!attribute [rw] document
       #   @return [Google::Firestore::V1::Document]
-      #     The document to create. `name` must not be set.
+      #     Required. The document to create. `name` must not be set.
       # @!attribute [rw] mask
       #   @return [Google::Firestore::V1::DocumentMask]
       #     The fields to return. If not set, returns all fields.
@@ -119,7 +119,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::UpdateDocument Firestore::UpdateDocument}.
       # @!attribute [rw] document
       #   @return [Google::Firestore::V1::Document]
-      #     The updated document.
+      #     Required. The updated document.
       #     Creates the document if it does not already exist.
       # @!attribute [rw] update_mask
       #   @return [Google::Firestore::V1::DocumentMask]
@@ -145,7 +145,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::DeleteDocument Firestore::DeleteDocument}.
       # @!attribute [rw] name
       #   @return [String]
-      #     The resource name of the Document to delete. In the format:
+      #     Required. The resource name of the Document to delete. In the format:
       #     `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
       # @!attribute [rw] current_document
       #   @return [Google::Firestore::V1::Precondition]
@@ -156,7 +156,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::BatchGetDocuments Firestore::BatchGetDocuments}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] documents
       #   @return [Array<String>]
@@ -209,7 +209,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::BeginTransaction Firestore::BeginTransaction}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] options
       #   @return [Google::Firestore::V1::TransactionOptions]
@@ -226,7 +226,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::Commit Firestore::Commit}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] writes
       #   @return [Array<Google::Firestore::V1::Write>]
@@ -253,17 +253,17 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::Rollback Firestore::Rollback}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] transaction
       #   @return [String]
-      #     The transaction to roll back.
+      #     Required. The transaction to roll back.
       class RollbackRequest; end
 
       # The request for {Google::Firestore::V1::Firestore::RunQuery Firestore::RunQuery}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent resource name. In the format:
+      #     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:
@@ -325,7 +325,7 @@ module Google
       # the next request.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       #     This is only required in the first message.
       # @!attribute [rw] stream_id
@@ -387,7 +387,7 @@ module Google
       # A request for {Google::Firestore::V1::Firestore::Listen Firestore::Listen}
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] add_target
       #   @return [Google::Firestore::V1::Target]
@@ -538,7 +538,7 @@ module Google
       # The request for {Google::Firestore::V1::Firestore::ListCollectionIds Firestore::ListCollectionIds}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent document. In the format:
+      #     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`

data/lib/google/cloud/firestore/v1/doc/google/firestore/v1/query.rb

@@ -174,15 +174,6 @@ module Google
           end
         end
 
-        # The projection of document's fields to return.
-        # @!attribute [rw] fields
-        #   @return [Array<Google::Firestore::V1::StructuredQuery::FieldReference>]
-        #     The fields to return.
-        #
-        #     If empty, all fields are returned. To only return the name
-        #     of the document, use `['__name__']`.
-        class Projection; end
-
         # An order on a field.
         # @!attribute [rw] field
         #   @return [Google::Firestore::V1::StructuredQuery::FieldReference]
@@ -197,6 +188,15 @@ module Google
         #   @return [String]
         class FieldReference; end
 
+        # The projection of document's fields to return.
+        # @!attribute [rw] fields
+        #   @return [Array<Google::Firestore::V1::StructuredQuery::FieldReference>]
+        #     The fields to return.
+        #
+        #     If empty, all fields are returned. To only return the name
+        #     of the document, use `['__name__']`.
+        class Projection; end
+
         # A sort direction.
         module Direction
           # Unspecified.

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

@@ -370,7 +370,7 @@ module Google
           # Gets a single document.
           #
           # @param name [String]
-          #   The resource name of the Document to get. In the format:
+          #   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::V1::DocumentMask | Hash]
           #   The fields to return. If not set, returns all fields.
@@ -421,14 +421,14 @@ module Google
           # Lists documents.
           #
           # @param parent [String]
-          #   The parent resource name. In the format:
+          #   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 collection_id [String]
-          #   The collection ID, relative to `parent`, to list. For example: `chatrooms`
+          #   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
@@ -522,17 +522,17 @@ module Google
           # Creates a new document.
           #
           # @param parent [String]
-          #   The parent resource. For example:
+          #   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]
-          #   The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+          #   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.
           #
           #   Optional. If not specified, an ID will be assigned by the service.
           # @param document [Google::Firestore::V1::Document | Hash]
-          #   The document to create. `name` must not be set.
+          #   Required. The document to create. `name` must not be set.
           #   A hash of the same form as `Google::Firestore::V1::Document`
           #   can also be provided.
           # @param mask [Google::Firestore::V1::DocumentMask | Hash]
@@ -588,7 +588,7 @@ module Google
           # Updates or inserts a document.
           #
           # @param document [Google::Firestore::V1::Document | Hash]
-          #   The updated document.
+          #   Required. The updated document.
           #   Creates the document if it does not already exist.
           #   A hash of the same form as `Google::Firestore::V1::Document`
           #   can also be provided.
@@ -654,7 +654,7 @@ module Google
           # Deletes a document.
           #
           # @param name [String]
-          #   The resource name of the Document to delete. 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 current_document [Google::Firestore::V1::Precondition | Hash]
           #   An optional precondition on the document.
@@ -695,7 +695,7 @@ module Google
           # same order that they were requested.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   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:
@@ -765,7 +765,7 @@ module Google
           # Starts a new transaction.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   Required. The database name. In the format:
           #   `projects/{project_id}/databases/{database_id}`.
           # @param options_ [Google::Firestore::V1::TransactionOptions | Hash]
           #   The options for the transaction.
@@ -803,7 +803,7 @@ module Google
           # Commits a transaction, while optionally updating documents.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   Required. The database name. In the format:
           #   `projects/{project_id}/databases/{database_id}`.
           # @param writes [Array<Google::Firestore::V1::Write | Hash>]
           #   The writes to apply.
@@ -849,10 +849,10 @@ module Google
           # Rolls back a transaction.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   Required. The database name. In the format:
           #   `projects/{project_id}/databases/{database_id}`.
           # @param transaction [String]
-          #   The transaction to roll back.
+          #   Required. The transaction to roll back.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -887,7 +887,7 @@ module Google
           # Runs a query.
           #
           # @param parent [String]
-          #   The parent resource name. In the format:
+          #   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:
@@ -1018,7 +1018,7 @@ module Google
           # Lists all the collection IDs underneath a document.
           #
           # @param parent [String]
-          #   The parent document. In the format:
+          #   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`

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

@@ -19,7 +19,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::GetDocument Firestore::GetDocument}.
       # @!attribute [rw] name
       #   @return [String]
-      #     The resource name of the Document to get. In the format:
+      #     Required. The resource name of the Document to get. In the format:
       #     `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
       # @!attribute [rw] mask
       #   @return [Google::Firestore::V1beta1::DocumentMask]
@@ -39,7 +39,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::ListDocuments Firestore::ListDocuments}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent resource name. In the format:
+      #     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:
@@ -47,7 +47,7 @@ module Google
       #     `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
       # @!attribute [rw] collection_id
       #   @return [String]
-      #     The collection ID, relative to `parent`, to list. For example: `chatrooms`
+      #     Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`
       #     or `messages`.
       # @!attribute [rw] page_size
       #   @return [Integer]
@@ -94,12 +94,12 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::CreateDocument Firestore::CreateDocument}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent resource. For example:
+      #     Required. The parent resource. For example:
       #     `projects/{project_id}/databases/{database_id}/documents` or
       #     `projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}`
       # @!attribute [rw] collection_id
       #   @return [String]
-      #     The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+      #     Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`.
       # @!attribute [rw] document_id
       #   @return [String]
       #     The client-assigned document ID to use for this document.
@@ -107,7 +107,7 @@ module Google
       #     Optional. If not specified, an ID will be assigned by the service.
       # @!attribute [rw] document
       #   @return [Google::Firestore::V1beta1::Document]
-      #     The document to create. `name` must not be set.
+      #     Required. The document to create. `name` must not be set.
       # @!attribute [rw] mask
       #   @return [Google::Firestore::V1beta1::DocumentMask]
       #     The fields to return. If not set, returns all fields.
@@ -119,7 +119,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::UpdateDocument Firestore::UpdateDocument}.
       # @!attribute [rw] document
       #   @return [Google::Firestore::V1beta1::Document]
-      #     The updated document.
+      #     Required. The updated document.
       #     Creates the document if it does not already exist.
       # @!attribute [rw] update_mask
       #   @return [Google::Firestore::V1beta1::DocumentMask]
@@ -145,7 +145,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::DeleteDocument Firestore::DeleteDocument}.
       # @!attribute [rw] name
       #   @return [String]
-      #     The resource name of the Document to delete. In the format:
+      #     Required. The resource name of the Document to delete. In the format:
       #     `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
       # @!attribute [rw] current_document
       #   @return [Google::Firestore::V1beta1::Precondition]
@@ -156,7 +156,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::BatchGetDocuments Firestore::BatchGetDocuments}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] documents
       #   @return [Array<String>]
@@ -209,7 +209,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::BeginTransaction Firestore::BeginTransaction}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] options
       #   @return [Google::Firestore::V1beta1::TransactionOptions]
@@ -226,7 +226,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::Commit Firestore::Commit}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] writes
       #   @return [Array<Google::Firestore::V1beta1::Write>]
@@ -253,17 +253,17 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::Rollback Firestore::Rollback}.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] transaction
       #   @return [String]
-      #     The transaction to roll back.
+      #     Required. The transaction to roll back.
       class RollbackRequest; end
 
       # The request for {Google::Firestore::V1beta1::Firestore::RunQuery Firestore::RunQuery}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent resource name. In the format:
+      #     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:
@@ -325,7 +325,7 @@ module Google
       # the next request.
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       #     This is only required in the first message.
       # @!attribute [rw] stream_id
@@ -387,7 +387,7 @@ module Google
       # A request for {Google::Firestore::V1beta1::Firestore::Listen Firestore::Listen}
       # @!attribute [rw] database
       #   @return [String]
-      #     The database name. In the format:
+      #     Required. The database name. In the format:
       #     `projects/{project_id}/databases/{database_id}`.
       # @!attribute [rw] add_target
       #   @return [Google::Firestore::V1beta1::Target]
@@ -538,7 +538,7 @@ module Google
       # The request for {Google::Firestore::V1beta1::Firestore::ListCollectionIds Firestore::ListCollectionIds}.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The parent document. In the format:
+      #     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`

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

@@ -183,6 +183,11 @@ module Google
         #     The direction to order by. Defaults to `ASCENDING`.
         class Order; end
 
+        # A reference to a field, such as `max(messages.time) as max_time`.
+        # @!attribute [rw] field_path
+        #   @return [String]
+        class FieldReference; end
+
         # The projection of document's fields to return.
         # @!attribute [rw] fields
         #   @return [Array<Google::Firestore::V1beta1::StructuredQuery::FieldReference>]
@@ -192,11 +197,6 @@ module Google
         #     of the document, use `['__name__']`.
         class Projection; end
 
-        # A reference to a field, such as `max(messages.time) as max_time`.
-        # @!attribute [rw] field_path
-        #   @return [String]
-        class FieldReference; end
-
         # A sort direction.
         module Direction
           # Unspecified.

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

@@ -370,7 +370,7 @@ module Google
           # Gets a single document.
           #
           # @param name [String]
-          #   The resource name of the Document to get. In the format:
+          #   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.
@@ -421,14 +421,14 @@ module Google
           # Lists documents.
           #
           # @param parent [String]
-          #   The parent resource name. In the format:
+          #   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 collection_id [String]
-          #   The collection ID, relative to `parent`, to list. For example: `chatrooms`
+          #   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
@@ -522,17 +522,17 @@ module Google
           # Creates a new document.
           #
           # @param parent [String]
-          #   The parent resource. For example:
+          #   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]
-          #   The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+          #   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.
           #
           #   Optional. If not specified, an ID will be assigned by the service.
           # @param document [Google::Firestore::V1beta1::Document | Hash]
-          #   The document to create. `name` must not be set.
+          #   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]
@@ -588,7 +588,7 @@ module Google
           # Updates or inserts a document.
           #
           # @param document [Google::Firestore::V1beta1::Document | Hash]
-          #   The updated document.
+          #   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.
@@ -654,7 +654,7 @@ module Google
           # Deletes a document.
           #
           # @param name [String]
-          #   The resource name of the Document to delete. 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 current_document [Google::Firestore::V1beta1::Precondition | Hash]
           #   An optional precondition on the document.
@@ -695,7 +695,7 @@ module Google
           # same order that they were requested.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   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:
@@ -765,7 +765,7 @@ module Google
           # Starts a new transaction.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   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.
@@ -803,7 +803,7 @@ module Google
           # Commits a transaction, while optionally updating documents.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   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.
@@ -849,10 +849,10 @@ module Google
           # Rolls back a transaction.
           #
           # @param database [String]
-          #   The database name. In the format:
+          #   Required. The database name. In the format:
           #   `projects/{project_id}/databases/{database_id}`.
           # @param transaction [String]
-          #   The transaction to roll back.
+          #   Required. The transaction to roll back.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -887,7 +887,7 @@ module Google
           # Runs a query.
           #
           # @param parent [String]
-          #   The parent resource name. In the format:
+          #   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:
@@ -1018,7 +1018,7 @@ module Google
           # Lists all the collection IDs underneath a document.
           #
           # @param parent [String]
-          #   The parent document. In the format:
+          #   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`

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Firestore
-      VERSION = "1.2.1".freeze
+      VERSION = "1.2.2".freeze
     end
   end
 end

data/lib/google/cloud/firestore/watch/listener.rb

@@ -65,13 +65,13 @@ module Google
           end
 
           def initialize query, doc_ref, client, init_listen_req, &callback
+            super() # to init MonitorMixin
+
             @query = query
             @doc_ref = doc_ref
             @client = client
             @init_listen_req = init_listen_req
             @callback = callback
-
-            super() # to init MonitorMixin
           end
 
           def start

data/lib/google/firestore/admin/v1/field_pb.rb

@@ -4,6 +4,7 @@
 
 require 'google/protobuf'
 
+require 'google/api/resource_pb'
 require 'google/firestore/admin/v1/index_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/lib/google/firestore/admin/v1/firestore_admin_pb.rb

@@ -5,12 +5,14 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/firestore/admin/v1/field_pb'
 require 'google/firestore/admin/v1/index_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
-require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.firestore.admin.v1.CreateIndexRequest" do
     optional :parent, :string, 1

data/lib/google/firestore/admin/v1/index_pb.rb

@@ -4,6 +4,7 @@
 
 require 'google/protobuf'
 
+require 'google/api/resource_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.firestore.admin.v1.Index" do

data/lib/google/firestore/v1/firestore_pb.rb

@@ -5,6 +5,8 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
 require 'google/firestore/v1/common_pb'
 require 'google/firestore/v1/document_pb'
 require 'google/firestore/v1/query_pb'
@@ -12,7 +14,6 @@ require 'google/firestore/v1/write_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
-require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.firestore.v1.GetDocumentRequest" do
     optional :name, :string, 1

data/lib/google/firestore/v1/query_pb.rb

@@ -64,9 +64,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :IS_NAN, 2
     value :IS_NULL, 3
   end
-  add_message "google.firestore.v1.StructuredQuery.Projection" do
-    repeated :fields, :message, 2, "google.firestore.v1.StructuredQuery.FieldReference"
-  end
   add_message "google.firestore.v1.StructuredQuery.Order" do
     optional :field, :message, 1, "google.firestore.v1.StructuredQuery.FieldReference"
     optional :direction, :enum, 2, "google.firestore.v1.StructuredQuery.Direction"
@@ -74,6 +71,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.firestore.v1.StructuredQuery.FieldReference" do
     optional :field_path, :string, 2
   end
+  add_message "google.firestore.v1.StructuredQuery.Projection" do
+    repeated :fields, :message, 2, "google.firestore.v1.StructuredQuery.FieldReference"
+  end
   add_enum "google.firestore.v1.StructuredQuery.Direction" do
     value :DIRECTION_UNSPECIFIED, 0
     value :ASCENDING, 1
@@ -97,9 +97,9 @@ module Google
       StructuredQuery::FieldFilter::Operator = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.FieldFilter.Operator").enummodule
       StructuredQuery::UnaryFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.UnaryFilter").msgclass
       StructuredQuery::UnaryFilter::Operator = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.UnaryFilter.Operator").enummodule
-      StructuredQuery::Projection = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Projection").msgclass
       StructuredQuery::Order = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Order").msgclass
       StructuredQuery::FieldReference = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.FieldReference").msgclass
+      StructuredQuery::Projection = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Projection").msgclass
       StructuredQuery::Direction = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.StructuredQuery.Direction").enummodule
       Cursor = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1.Cursor").msgclass
     end

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

@@ -5,6 +5,8 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
 require 'google/firestore/v1beta1/common_pb'
 require 'google/firestore/v1beta1/document_pb'
 require 'google/firestore/v1beta1/query_pb'
@@ -12,7 +14,6 @@ require 'google/firestore/v1beta1/write_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
-require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.firestore.v1beta1.GetDocumentRequest" do
     optional :name, :string, 1

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

@@ -68,12 +68,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :field, :message, 1, "google.firestore.v1beta1.StructuredQuery.FieldReference"
     optional :direction, :enum, 2, "google.firestore.v1beta1.StructuredQuery.Direction"
   end
-  add_message "google.firestore.v1beta1.StructuredQuery.Projection" do
-    repeated :fields, :message, 2, "google.firestore.v1beta1.StructuredQuery.FieldReference"
-  end
   add_message "google.firestore.v1beta1.StructuredQuery.FieldReference" do
     optional :field_path, :string, 2
   end
+  add_message "google.firestore.v1beta1.StructuredQuery.Projection" do
+    repeated :fields, :message, 2, "google.firestore.v1beta1.StructuredQuery.FieldReference"
+  end
   add_enum "google.firestore.v1beta1.StructuredQuery.Direction" do
     value :DIRECTION_UNSPECIFIED, 0
     value :ASCENDING, 1
@@ -98,8 +98,8 @@ module Google
       StructuredQuery::UnaryFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.StructuredQuery.UnaryFilter").msgclass
       StructuredQuery::UnaryFilter::Operator = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.StructuredQuery.UnaryFilter.Operator").enummodule
       StructuredQuery::Order = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.StructuredQuery.Order").msgclass
-      StructuredQuery::Projection = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.StructuredQuery.Projection").msgclass
       StructuredQuery::FieldReference = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.StructuredQuery.FieldReference").msgclass
+      StructuredQuery::Projection = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.StructuredQuery.Projection").msgclass
       StructuredQuery::Direction = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.StructuredQuery.Direction").enummodule
       Cursor = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.firestore.v1beta1.Cursor").msgclass
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-firestore
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.2
 platform: ruby
 authors:
 - Google Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-07 00:00:00.000000000 Z
+date: 2019-12-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core