google-api-client 0.42.1 → 0.44.2

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

@@ -48,30 +48,22 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Test `Source` for syntactic and semantic correctness. Issues present, if
-        # any, will be returned to the caller with a description, severity, and
-        # source location.
-        # The test method may be executed with `Source` or a `Ruleset` name.
+        # Test `Source` for syntactic and semantic correctness. Issues present, if any,
+        # will be returned to the caller with a description, severity, and source
+        # location. The test method may be executed with `Source` or a `Ruleset` name.
         # Passing `Source` is useful for unit testing new rules. Passing a `Ruleset`
-        # name is useful for regression testing an existing rule.
-        # The following is an example of `Source` that permits users to upload images
-        # to a bucket bearing their user id and matching the correct metadata:
-        # _*Example*_
-        # // Users are allowed to subscribe and unsubscribe to the blog.
-        # service firebase.storage `
-        # match /users/`userId`/images/`imageName` `
-        # allow write: if userId == request.auth.uid
-        # && (imageName.matches('*.png$')
-        # || imageName.matches('*.jpg$'))
-        # && resource.mimeType.matches('^image/')
-        # `
-        # `
+        # name is useful for regression testing an existing rule. The following is an
+        # example of `Source` that permits users to upload images to a bucket bearing
+        # their user id and matching the correct metadata: _*Example*_ // Users are
+        # allowed to subscribe and unsubscribe to the blog. service firebase.storage `
+        # match /users/`userId`/images/`imageName` ` allow write: if userId == request.
+        # auth.uid && (imageName.matches('*.png$') || imageName.matches('*.jpg$')) &&
+        # resource.mimeType.matches('^image/') ` `
         # @param [String] name
-        #   Tests may either provide `source` or a `Ruleset` resource name.
-        #   For tests against `source`, the resource name must refer to the project:
-        #   Format: `projects/`project_id``
-        #   For tests against a `Ruleset`, this must be the `Ruleset` resource name:
-        #   Format: `projects/`project_id`/rulesets/`ruleset_id``
+        #   Tests may either provide `source` or a `Ruleset` resource name. For tests
+        #   against `source`, the resource name must refer to the project: Format: `
+        #   projects/`project_id`` For tests against a `Ruleset`, this must be the `
+        #   Ruleset` resource name: Format: `projects/`project_id`/rulesets/`ruleset_id``
         # @param [Google::Apis::FirebaserulesV1::TestRulesetRequest] test_ruleset_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -102,27 +94,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Create a `Release`.
-        # Release names should reflect the developer's deployment practices. For
-        # example, the release name may include the environment name, application
-        # name, application version, or any other name meaningful to the developer.
-        # Once a `Release` refers to a `Ruleset`, the rules can be enforced by
-        # Firebase Rules-enabled services.
-        # More than one `Release` may be 'live' concurrently. Consider the following
-        # three `Release` names for `projects/foo` and the `Ruleset` to which they
-        # refer.
-        # Release Name                    | Ruleset Name
-        # --------------------------------|-------------
-        # projects/foo/releases/prod      | projects/foo/rulesets/uuid123
-        # projects/foo/releases/prod/beta | projects/foo/rulesets/uuid123
-        # projects/foo/releases/prod/v23  | projects/foo/rulesets/uuid456
-        # The table reflects the `Ruleset` rollout in progress. The `prod` and
-        # `prod/beta` releases refer to the same `Ruleset`. However, `prod/v23`
-        # refers to a new `Ruleset`. The `Ruleset` reference for a `Release` may be
-        # updated using the UpdateRelease method.
+        # Create a `Release`. Release names should reflect the developer's deployment
+        # practices. For example, the release name may include the environment name,
+        # application name, application version, or any other name meaningful to the
+        # developer. Once a `Release` refers to a `Ruleset`, the rules can be enforced
+        # by Firebase Rules-enabled services. More than one `Release` may be 'live'
+        # concurrently. Consider the following three `Release` names for `projects/foo`
+        # and the `Ruleset` to which they refer. Release Name | Ruleset Name ------------
+        # --------------------|------------- projects/foo/releases/prod | projects/foo/
+        # rulesets/uuid123 projects/foo/releases/prod/beta | projects/foo/rulesets/
+        # uuid123 projects/foo/releases/prod/v23 | projects/foo/rulesets/uuid456 The
+        # table reflects the `Ruleset` rollout in progress. The `prod` and `prod/beta`
+        # releases refer to the same `Ruleset`. However, `prod/v23` refers to a new `
+        # Ruleset`. The `Ruleset` reference for a `Release` may be updated using the
+        # UpdateRelease method.
         # @param [String] name
-        #   Resource name for the project which owns this `Release`.
-        #   Format: `projects/`project_id``
+        #   Resource name for the project which owns this `Release`. Format: `projects/`
+        #   project_id``
         # @param [Google::Apis::FirebaserulesV1::Release] release_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -155,8 +143,8 @@ module Google
         
         # Delete a `Release` by resource name.
         # @param [String] name
-        #   Resource name for the `Release` to delete.
-        #   Format: `projects/`project_id`/releases/`release_id``
+        #   Resource name for the `Release` to delete. Format: `projects/`project_id`/
+        #   releases/`release_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -186,8 +174,8 @@ module Google
         
         # Get a `Release` by name.
         # @param [String] name
-        #   Resource name of the `Release`.
-        #   Format: `projects/`project_id`/releases/`release_id``
+        #   Resource name of the `Release`. Format: `projects/`project_id`/releases/`
+        #   release_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -217,11 +205,11 @@ module Google
         
         # Get the `Release` executable to use when enforcing rules.
         # @param [String] name
-        #   Resource name of the `Release`.
-        #   Format: `projects/`project_id`/releases/`release_id``
+        #   Resource name of the `Release`. Format: `projects/`project_id`/releases/`
+        #   release_id``
         # @param [String] executable_version
-        #   The requested runtime executable version.
-        #   Defaults to FIREBASE_RULES_EXECUTABLE_V1.
+        #   The requested runtime executable version. Defaults to
+        #   FIREBASE_RULES_EXECUTABLE_V1.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -250,38 +238,32 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List the `Release` values for a project. This list may optionally be
-        # filtered by `Release` name, `Ruleset` name, `TestSuite` name, or any
-        # combination thereof.
+        # List the `Release` values for a project. This list may optionally be filtered
+        # by `Release` name, `Ruleset` name, `TestSuite` name, or any combination
+        # thereof.
         # @param [String] name
-        #   Resource name for the project.
-        #   Format: `projects/`project_id``
+        #   Resource name for the project. Format: `projects/`project_id``
         # @param [String] filter
-        #   `Release` filter. The list method supports filters with restrictions on the
-        #   `Release.name`, `Release.ruleset_name`, and `Release.test_suite_name`.
-        #   Example 1: A filter of 'name=prod*' might return `Release`s with names
-        #   within 'projects/foo' prefixed with 'prod':
-        #   Name                          | Ruleset Name
-        #   ------------------------------|-------------
-        #   projects/foo/releases/prod    | projects/foo/rulesets/uuid1234
-        #   projects/foo/releases/prod/v1 | projects/foo/rulesets/uuid1234
-        #   projects/foo/releases/prod/v2 | projects/foo/rulesets/uuid8888
-        #   Example 2: A filter of `name=prod* ruleset_name=uuid1234` would return only
-        #   `Release` instances for 'projects/foo' with names prefixed with 'prod'
-        #   referring to the same `Ruleset` name of 'uuid1234':
-        #   Name                          | Ruleset Name
-        #   ------------------------------|-------------
-        #   projects/foo/releases/prod    | projects/foo/rulesets/1234
-        #   projects/foo/releases/prod/v1 | projects/foo/rulesets/1234
-        #   In the examples, the filter parameters refer to the search filters are
-        #   relative to the project. Fully qualified prefixed may also be used. e.g.
-        #   `test_suite_name=projects/foo/testsuites/uuid1`
+        #   `Release` filter. The list method supports filters with restrictions on the `
+        #   Release.name`, `Release.ruleset_name`, and `Release.test_suite_name`. Example
+        #   1: A filter of 'name=prod*' might return `Release`s with names within '
+        #   projects/foo' prefixed with 'prod': Name | Ruleset Name -----------------------
+        #   -------|------------- projects/foo/releases/prod | projects/foo/rulesets/
+        #   uuid1234 projects/foo/releases/prod/v1 | projects/foo/rulesets/uuid1234
+        #   projects/foo/releases/prod/v2 | projects/foo/rulesets/uuid8888 Example 2: A
+        #   filter of `name=prod* ruleset_name=uuid1234` would return only `Release`
+        #   instances for 'projects/foo' with names prefixed with 'prod' referring to the
+        #   same `Ruleset` name of 'uuid1234': Name | Ruleset Name ------------------------
+        #   ------|------------- projects/foo/releases/prod | projects/foo/rulesets/1234
+        #   projects/foo/releases/prod/v1 | projects/foo/rulesets/1234 In the examples,
+        #   the filter parameters refer to the search filters are relative to the project.
+        #   Fully qualified prefixed may also be used. e.g. `test_suite_name=projects/foo/
+        #   testsuites/uuid1`
         # @param [Fixnum] page_size
-        #   Page size to load. Maximum of 100. Defaults to 10.
-        #   Note: `page_size` is just a hint and the service may choose to load fewer
-        #   than `page_size` results due to the size of the output. To traverse all of
-        #   the releases, the caller should iterate until the `page_token` on the
-        #   response is empty.
+        #   Page size to load. Maximum of 100. Defaults to 10. Note: `page_size` is just a
+        #   hint and the service may choose to load fewer than `page_size` results due to
+        #   the size of the output. To traverse all of the releases, the caller should
+        #   iterate until the `page_token` on the response is empty.
         # @param [String] page_token
         #   Next page token for the next batch of `Release` instances.
         # @param [String] fields
@@ -314,13 +296,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update a `Release` via PATCH.
-        # Only updates to the `ruleset_name` and `test_suite_name` fields will be
-        # honored. `Release` rename is not supported. To create a `Release` use the
-        # CreateRelease method.
+        # Update a `Release` via PATCH. Only updates to the `ruleset_name` and `
+        # test_suite_name` fields will be honored. `Release` rename is not supported. To
+        # create a `Release` use the CreateRelease method.
         # @param [String] name
-        #   Resource name for the project which owns this `Release`.
-        #   Format: `projects/`project_id``
+        #   Resource name for the project which owns this `Release`. Format: `projects/`
+        #   project_id``
         # @param [Google::Apis::FirebaserulesV1::UpdateReleaseRequest] update_release_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -351,14 +332,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Create a `Ruleset` from `Source`.
-        # The `Ruleset` is given a unique generated name which is returned to the
-        # caller. `Source` containing syntactic or semantics errors will result in an
-        # error response indicating the first error encountered. For a detailed view
-        # of `Source` issues, use TestRuleset.
+        # Create a `Ruleset` from `Source`. The `Ruleset` is given a unique generated
+        # name which is returned to the caller. `Source` containing syntactic or
+        # semantics errors will result in an error response indicating the first error
+        # encountered. For a detailed view of `Source` issues, use TestRuleset.
         # @param [String] name
-        #   Resource name for Project which owns this `Ruleset`.
-        #   Format: `projects/`project_id``
+        #   Resource name for Project which owns this `Ruleset`. Format: `projects/`
+        #   project_id``
         # @param [Google::Apis::FirebaserulesV1::Ruleset] ruleset_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -389,11 +369,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete a `Ruleset` by resource name.
-        # If the `Ruleset` is referenced by a `Release` the operation will fail.
+        # Delete a `Ruleset` by resource name. If the `Ruleset` is referenced by a `
+        # Release` the operation will fail.
         # @param [String] name
-        #   Resource name for the ruleset to delete.
-        #   Format: `projects/`project_id`/rulesets/`ruleset_id``
+        #   Resource name for the ruleset to delete. Format: `projects/`project_id`/
+        #   rulesets/`ruleset_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -423,8 +403,8 @@ module Google
         
         # Get a `Ruleset` by name including the full `Source` contents.
         # @param [String] name
-        #   Resource name for the ruleset to get.
-        #   Format: `projects/`project_id`/rulesets/`ruleset_id``
+        #   Resource name for the ruleset to get. Format: `projects/`project_id`/rulesets/`
+        #   ruleset_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -453,23 +433,20 @@ module Google
         end
         
         # List `Ruleset` metadata only and optionally filter the results by `Ruleset`
-        # name.
-        # The full `Source` contents of a `Ruleset` may be retrieved with
+        # name. The full `Source` contents of a `Ruleset` may be retrieved with
         # GetRuleset.
         # @param [String] name
-        #   Resource name for the project.
-        #   Format: `projects/`project_id``
+        #   Resource name for the project. Format: `projects/`project_id``
         # @param [String] filter
-        #   `Ruleset` filter. The list method supports filters with restrictions on
-        #   `Ruleset.name`.
-        #   Filters on `Ruleset.create_time` should use the `date` function which
-        #   parses strings that conform to the RFC 3339 date/time specifications.
+        #   `Ruleset` filter. The list method supports filters with restrictions on `
+        #   Ruleset.name`. Filters on `Ruleset.create_time` should use the `date` function
+        #   which parses strings that conform to the RFC 3339 date/time specifications.
         #   Example: `create_time > date("2017-01-01T00:00:00Z") AND name=UUID-*`
         # @param [Fixnum] page_size
-        #   Page size to load. Maximum of 100. Defaults to 10.
-        #   Note: `page_size` is just a hint and the service may choose to load less
-        #   than `page_size` due to the size of the output. To traverse all of the
-        #   releases, caller should iterate until the `page_token` is empty.
+        #   Page size to load. Maximum of 100. Defaults to 10. Note: `page_size` is just a
+        #   hint and the service may choose to load less than `page_size` due to the size
+        #   of the output. To traverse all of the releases, caller should iterate until
+        #   the `page_token` is empty.
         # @param [String] page_token
         #   Next page token for loading the next batch of `Ruleset` instances.
         # @param [String] fields

data/generated/google/apis/firestore_v1.rb

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

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

@@ -45,19 +45,18 @@ module Google
       class BatchGetDocumentsRequest
         include Google::Apis::Core::Hashable
       
-        # The names of the documents to retrieve. In the format:
-        # `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.
+        # The names of the documents to retrieve. In the format: `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.
         # Corresponds to the JSON property `documents`
         # @return [Array<String>]
         attr_accessor :documents
       
-        # A set of field paths on a document.
-        # Used to restrict a get or update operation on a document to a subset of its
-        # fields.
-        # This is different from standard field masks, as this is always scoped to a
-        # Document, and takes in account the dynamic nature of Value.
+        # A set of field paths on a document. Used to restrict a get or update operation
+        # on a document to a subset of its fields. This is different from standard field
+        # masks, as this is always scoped to a Document, and takes in account the
+        # dynamic nature of Value.
         # Corresponds to the JSON property `mask`
         # @return [Google::Apis::FirestoreV1::DocumentMask]
         attr_accessor :mask
@@ -67,8 +66,8 @@ module Google
         # @return [Google::Apis::FirestoreV1::TransactionOptions]
         attr_accessor :new_transaction
       
-        # Reads documents as they were at the given time.
-        # This may not be older than 270 seconds.
+        # Reads documents as they were at the given time. This may not be older than 270
+        # seconds.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
@@ -97,29 +96,27 @@ module Google
       class BatchGetDocumentsResponse
         include Google::Apis::Core::Hashable
       
-        # A Firestore document.
-        # Must not exceed 1 MiB - 4 bytes.
+        # A Firestore document. Must not exceed 1 MiB - 4 bytes.
         # Corresponds to the JSON property `found`
         # @return [Google::Apis::FirestoreV1::Document]
         attr_accessor :found
       
-        # A document name that was requested but does not exist. In the format:
-        # `projects/`project_id`/databases/`database_id`/documents/`document_path``.
+        # A document name that was requested but does not exist. In the format: `
+        # projects/`project_id`/databases/`database_id`/documents/`document_path``.
         # Corresponds to the JSON property `missing`
         # @return [String]
         attr_accessor :missing
       
-        # The time at which the document was read.
-        # This may be monotically increasing, in this case the previous documents in
-        # the result stream are guaranteed not to have changed between their
-        # read_time and this one.
+        # The time at which the document was read. This may be monotically increasing,
+        # in this case the previous documents in the result stream are guaranteed not to
+        # have changed between their read_time and this one.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
       
-        # The transaction that was started as part of this request.
-        # Will only be set in the first response, and only if
-        # BatchGetDocumentsRequest.new_transaction was set in the request.
+        # The transaction that was started as part of this request. Will only be set in
+        # the first response, and only if BatchGetDocumentsRequest.new_transaction was
+        # set in the request.
         # Corresponds to the JSON property `transaction`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -147,10 +144,9 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The writes to apply.
-        # Method does not apply writes atomically and does not guarantee ordering.
-        # Each write succeeds or fails independently. You cannot write to the same
-        # document more than once per request.
+        # The writes to apply. Method does not apply writes atomically and does not
+        # guarantee ordering. Each write succeeds or fails independently. You cannot
+        # write to the same document more than once per request.
         # Corresponds to the JSON property `writes`
         # @return [Array<Google::Apis::FirestoreV1::Write>]
         attr_accessor :writes
@@ -170,16 +166,14 @@ module Google
       class BatchWriteResponse
         include Google::Apis::Core::Hashable
       
-        # The status of applying the writes.
-        # This i-th write status corresponds to the i-th write in the
-        # request.
+        # The status of applying the writes. This i-th write status corresponds to the i-
+        # th write in the request.
         # Corresponds to the JSON property `status`
         # @return [Array<Google::Apis::FirestoreV1::Status>]
         attr_accessor :status
       
-        # The result of applying the writes.
-        # This i-th write result corresponds to the i-th write in the
-        # request.
+        # The result of applying the writes. This i-th write result corresponds to the i-
+        # th write in the request.
         # Corresponds to the JSON property `writeResults`
         # @return [Array<Google::Apis::FirestoreV1::WriteResult>]
         attr_accessor :write_results
@@ -238,16 +232,15 @@ module Google
       class CollectionSelector
         include Google::Apis::Core::Hashable
       
-        # When false, selects only collections that are immediate children of
-        # the `parent` specified in the containing `RunQueryRequest`.
-        # When true, selects all descendant collections.
+        # When false, selects only collections that are immediate children of the `
+        # parent` specified in the containing `RunQueryRequest`. When true, selects all
+        # descendant collections.
         # Corresponds to the JSON property `allDescendants`
         # @return [Boolean]
         attr_accessor :all_descendants
         alias_method :all_descendants?, :all_descendants
       
-        # The collection ID.
-        # When set, selects only collections with this ID.
+        # The collection ID. When set, selects only collections with this ID.
         # Corresponds to the JSON property `collectionId`
         # @return [String]
         attr_accessor :collection_id
@@ -273,8 +266,7 @@ module Google
         # @return [String]
         attr_accessor :transaction
       
-        # The writes to apply.
-        # Always executed atomically and in order.
+        # The writes to apply. Always executed atomically and in order.
         # Corresponds to the JSON property `writes`
         # @return [Array<Google::Apis::FirestoreV1::Write>]
         attr_accessor :writes
@@ -294,15 +286,14 @@ module Google
       class CommitResponse
         include Google::Apis::Core::Hashable
       
-        # The time at which the commit occurred. Any read with an equal or greater
-        # `read_time` is guaranteed to see the effects of the commit.
+        # The time at which the commit occurred. Any read with an equal or greater `
+        # read_time` is guaranteed to see the effects of the commit.
         # Corresponds to the JSON property `commitTime`
         # @return [String]
         attr_accessor :commit_time
       
-        # The result of applying the writes.
-        # This i-th write result corresponds to the i-th write in the
-        # request.
+        # The result of applying the writes. This i-th write result corresponds to the i-
+        # th write in the request.
         # Corresponds to the JSON property `writeResults`
         # @return [Array<Google::Apis::FirestoreV1::WriteResult>]
         attr_accessor :write_results
@@ -322,8 +313,7 @@ module Google
       class CompositeFilter
         include Google::Apis::Core::Hashable
       
-        # The list of filters to combine.
-        # Must contain at least one filter.
+        # The list of filters to combine. Must contain at least one filter.
         # Corresponds to the JSON property `filters`
         # @return [Array<Google::Apis::FirestoreV1::Filter>]
         attr_accessor :filters
@@ -348,16 +338,16 @@ module Google
       class Cursor
         include Google::Apis::Core::Hashable
       
-        # If the position is just before or just after the given values, relative
-        # to the sort order defined by the query.
+        # If the position is just before or just after the given values, relative to the
+        # sort order defined by the query.
         # Corresponds to the JSON property `before`
         # @return [Boolean]
         attr_accessor :before
         alias_method :before?, :before
       
-        # The values that represent a position, in the order they appear in
-        # the order by clause of a query.
-        # Can contain fewer values than specified in the order by clause.
+        # The values that represent a position, in the order they appear in the order by
+        # clause of a query. Can contain fewer values than specified in the order by
+        # clause.
         # Corresponds to the JSON property `values`
         # @return [Array<Google::Apis::FirestoreV1::Value>]
         attr_accessor :values
@@ -373,52 +363,45 @@ module Google
         end
       end
       
-      # A Firestore document.
-      # Must not exceed 1 MiB - 4 bytes.
+      # A Firestore document. Must not exceed 1 MiB - 4 bytes.
       class Document
         include Google::Apis::Core::Hashable
       
-        # Output only. The time at which the document was created.
-        # This value increases monotonically when a document is deleted then
-        # recreated. It can also be compared to values from other documents and
-        # the `read_time` of a query.
+        # Output only. The time at which the document was created. This value increases
+        # monotonically when a document is deleted then recreated. It can also be
+        # compared to values from other documents and the `read_time` of a query.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # The document's fields.
-        # The map keys represent field names.
-        # A simple field name contains only characters `a` to `z`, `A` to `Z`,
-        # `0` to `9`, or `_`, and must not start with `0` to `9`. For example,
-        # `foo_bar_17`.
-        # Field names matching the regular expression `__.*__` are reserved. Reserved
-        # field names are forbidden except in certain documented contexts. The map
-        # keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be
-        # empty.
-        # Field paths may be used in other contexts to refer to structured fields
-        # defined here. For `map_value`, the field path is represented by the simple
-        # or quoted field names of the containing fields, delimited by `.`. For
-        # example, the structured field
-        # `"foo" : ` map_value: ` "x&y" : ` string_value: "hello" ```` would be
-        # represented by the field path `foo.x&y`.
-        # Within a field path, a quoted field name starts and ends with `` ` `` and
-        # may contain any character. Some characters, including `` ` ``, must be
-        # escaped using a `\`. For example, `` `x&y` `` represents `x&y` and
-        # `` `bak\`tik` `` represents `` bak`tik ``.
+        # The document's fields. The map keys represent field names. A simple field name
+        # contains only characters `a` to `z`, `A` to `Z`, `0` to `9`, or `_`, and must
+        # not start with `0` to `9`. For example, `foo_bar_17`. Field names matching the
+        # regular expression `__.*__` are reserved. Reserved field names are forbidden
+        # except in certain documented contexts. The map keys, represented as UTF-8,
+        # must not exceed 1,500 bytes and cannot be empty. Field paths may be used in
+        # other contexts to refer to structured fields defined here. For `map_value`,
+        # the field path is represented by the simple or quoted field names of the
+        # containing fields, delimited by `.`. For example, the structured field `"foo" :
+        # ` map_value: ` "x&y" : ` string_value: "hello" ```` would be represented by
+        # the field path `foo.x&y`. Within a field path, a quoted field name starts and
+        # ends with `` ` `` and may contain any character. Some characters, including ``
+        # ` ``, must be escaped using a `\`. For example, `` `x&y` `` represents `x&y`
+        # and `` `bak\`tik` `` represents `` bak`tik ``.
         # Corresponds to the JSON property `fields`
         # @return [Hash<String,Google::Apis::FirestoreV1::Value>]
         attr_accessor :fields
       
-        # The resource name of the document, for example
-        # `projects/`project_id`/databases/`database_id`/documents/`document_path``.
+        # The resource name of the document, for example `projects/`project_id`/
+        # databases/`database_id`/documents/`document_path``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output only. The time at which the document was last changed.
-        # This value is initially set to the `create_time` then increases
-        # monotonically with each change to the document. It can also be
-        # compared to values from other documents and the `read_time` of a query.
+        # Output only. The time at which the document was last changed. This value is
+        # initially set to the `create_time` then increases monotonically with each
+        # change to the document. It can also be compared to values from other documents
+        # and the `read_time` of a query.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -436,16 +419,14 @@ module Google
         end
       end
       
-      # A Document has changed.
-      # May be the result of multiple writes, including deletes, that
-      # ultimately resulted in a new value for the Document.
-      # Multiple DocumentChange messages may be returned for the same logical
-      # change, if multiple targets are affected.
+      # A Document has changed. May be the result of multiple writes, including
+      # deletes, that ultimately resulted in a new value for the Document. Multiple
+      # DocumentChange messages may be returned for the same logical change, if
+      # multiple targets are affected.
       class DocumentChange
         include Google::Apis::Core::Hashable
       
-        # A Firestore document.
-        # Must not exceed 1 MiB - 4 bytes.
+        # A Firestore document. Must not exceed 1 MiB - 4 bytes.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::FirestoreV1::Document]
         attr_accessor :document
@@ -472,11 +453,10 @@ module Google
         end
       end
       
-      # A Document has been deleted.
-      # May be the result of multiple writes, including updates, the
-      # last of which deleted the Document.
-      # Multiple DocumentDelete messages may be returned for the same logical
-      # delete, if multiple targets are affected.
+      # A Document has been deleted. May be the result of multiple writes, including
+      # updates, the last of which deleted the Document. Multiple DocumentDelete
+      # messages may be returned for the same logical delete, if multiple targets are
+      # affected.
       class DocumentDelete
         include Google::Apis::Core::Hashable
       
@@ -485,8 +465,8 @@ module Google
         # @return [String]
         attr_accessor :document
       
-        # The read timestamp at which the delete was observed.
-        # Greater or equal to the `commit_time` of the delete.
+        # The read timestamp at which the delete was observed. Greater or equal to the `
+        # commit_time` of the delete.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
@@ -508,16 +488,15 @@ module Google
         end
       end
       
-      # A set of field paths on a document.
-      # Used to restrict a get or update operation on a document to a subset of its
-      # fields.
-      # This is different from standard field masks, as this is always scoped to a
-      # Document, and takes in account the dynamic nature of Value.
+      # A set of field paths on a document. Used to restrict a get or update operation
+      # on a document to a subset of its fields. This is different from standard field
+      # masks, as this is always scoped to a Document, and takes in account the
+      # dynamic nature of Value.
       class DocumentMask
         include Google::Apis::Core::Hashable
       
-        # The list of field paths in the mask. See Document.fields for a field
-        # path syntax reference.
+        # The list of field paths in the mask. See Document.fields for a field path
+        # syntax reference.
         # Corresponds to the JSON property `fieldPaths`
         # @return [Array<String>]
         attr_accessor :field_paths
@@ -532,12 +511,11 @@ module Google
         end
       end
       
-      # A Document has been removed from the view of the targets.
-      # Sent if the document is no longer relevant to a target and is out of view.
-      # Can be sent instead of a DocumentDelete or a DocumentChange if the server
-      # can not send the new value of the document.
-      # Multiple DocumentRemove messages may be returned for the same logical
-      # write or delete, if multiple targets are affected.
+      # A Document has been removed from the view of the targets. Sent if the document
+      # is no longer relevant to a target and is out of view. Can be sent instead of a
+      # DocumentDelete or a DocumentChange if the server can not send the new value of
+      # the document. Multiple DocumentRemove messages may be returned for the same
+      # logical write or delete, if multiple targets are affected.
       class DocumentRemove
         include Google::Apis::Core::Hashable
       
@@ -546,8 +524,8 @@ module Google
         # @return [String]
         attr_accessor :document
       
-        # The read timestamp at which the remove was observed.
-        # Greater or equal to the `commit_time` of the change/delete/remove.
+        # The read timestamp at which the remove was observed. Greater or equal to the `
+        # commit_time` of the change/delete/remove.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
@@ -578,8 +556,7 @@ module Google
         # @return [String]
         attr_accessor :document
       
-        # The list of transformations to apply to the fields of the document, in
-        # order.
+        # The list of transformations to apply to the fields of the document, in order.
         # This must not be empty.
         # Corresponds to the JSON property `fieldTransforms`
         # @return [Array<Google::Apis::FirestoreV1::FieldTransform>]
@@ -600,10 +577,10 @@ module Google
       class DocumentsTarget
         include Google::Apis::Core::Hashable
       
-        # The names of the documents to retrieve. In the format:
-        # `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.
+        # The names of the documents to retrieve. In the format: `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.
         # Corresponds to the JSON property `documents`
         # @return [Array<String>]
         attr_accessor :documents
@@ -618,13 +595,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -641,9 +616,9 @@ module Google
       class ExistenceFilter
         include Google::Apis::Core::Hashable
       
-        # The total count of documents that match target_id.
-        # If different from the count of documents in the client that match, the
-        # client must manually determine which documents no longer match the target.
+        # The total count of documents that match target_id. If different from the count
+        # of documents in the client that match, the client must manually determine
+        # which documents no longer match the target.
         # Corresponds to the JSON property `count`
         # @return [Fixnum]
         attr_accessor :count
@@ -723,8 +698,7 @@ module Google
         # @return [Google::Apis::FirestoreV1::ArrayValue]
         attr_accessor :append_missing_elements
       
-        # The path of the field. See Document.fields for the field path syntax
-        # reference.
+        # The path of the field. See Document.fields for the field path syntax reference.
         # Corresponds to the JSON property `fieldPath`
         # @return [String]
         attr_accessor :field_path
@@ -801,8 +775,8 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.ExportDocuments.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # ExportDocuments.
       class GoogleFirestoreAdminV1ExportDocumentsMetadata
         include Google::Apis::Core::Hashable
       
@@ -827,16 +801,14 @@ module Google
         # @return [String]
         attr_accessor :output_uri_prefix
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressBytes`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_bytes
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressDocuments`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_documents
@@ -871,14 +843,13 @@ module Google
         # @return [Array<String>]
         attr_accessor :collection_ids
       
-        # The output URI. Currently only supports Google Cloud Storage URIs of the
-        # form: `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name
-        # of the Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional
-        # Google Cloud Storage namespace path. When
-        # choosing a name, be sure to consider Google Cloud Storage naming
-        # guidelines: https://cloud.google.com/storage/docs/naming.
-        # If the URI is a bucket (without a namespace path), a prefix will be
-        # generated based on the start time.
+        # The output URI. Currently only supports Google Cloud Storage URIs of the form:
+        # `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name of the
+        # Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional Google Cloud
+        # Storage namespace path. When choosing a name, be sure to consider Google Cloud
+        # Storage naming guidelines: https://cloud.google.com/storage/docs/naming. If
+        # the URI is a bucket (without a namespace path), a prefix will be generated
+        # based on the start time.
         # Corresponds to the JSON property `outputUriPrefix`
         # @return [String]
         attr_accessor :output_uri_prefix
@@ -898,9 +869,9 @@ module Google
       class GoogleFirestoreAdminV1ExportDocumentsResponse
         include Google::Apis::Core::Hashable
       
-        # Location of the output files. This can be used to begin an import
-        # into Cloud Firestore (this project or another project) after the operation
-        # completes successfully.
+        # Location of the output files. This can be used to begin an import into Cloud
+        # Firestore (this project or another project) after the operation completes
+        # successfully.
         # Corresponds to the JSON property `outputUriPrefix`
         # @return [String]
         attr_accessor :output_uri_prefix
@@ -915,9 +886,9 @@ module Google
         end
       end
       
-      # Represents a single field in the database.
-      # Fields are grouped by their "Collection Group", which represent all
-      # collections in the database with the same id.
+      # Represents a single field in the database. Fields are grouped by their "
+      # Collection Group", which represent all collections in the database with the
+      # same id.
       class GoogleFirestoreAdminV1Field
         include Google::Apis::Core::Hashable
       
@@ -926,28 +897,21 @@ module Google
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1IndexConfig]
         attr_accessor :index_config
       
-        # A field name of the form
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /fields/`field_path``
-        # A field path may be a simple field name, e.g. `address` or a path to fields
-        # within map_value , e.g. `address.city`,
-        # or a special field path. The only valid special field is `*`, which
-        # represents any field.
-        # Field paths may be quoted using ` (backtick). The only character that needs
-        # to be escaped within a quoted field path is the backtick character itself,
-        # escaped using a backslash. Special characters in field paths that
-        # must be quoted include: `*`, `.`,
-        # ``` (backtick), `[`, `]`, as well as any ascii symbolic characters.
-        # Examples:
-        # (Note: Comments here are written in markdown syntax, so there is an
-        # additional layer of backticks to represent a code block)
-        # `\`address.city\`` represents a field named `address.city`, not the map key
-        # `city` in the field `address`.
-        # `\`*\`` represents a field named `*`, not any field.
-        # A special `Field` contains the default indexing settings for all fields.
-        # This field's resource name is:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/__default__/
-        # fields/*`
+        # A field name of the form `projects/`project_id`/databases/`database_id`/
+        # collectionGroups/`collection_id`/fields/`field_path`` A field path may be a
+        # simple field name, e.g. `address` or a path to fields within map_value , e.g. `
+        # address.city`, or a special field path. The only valid special field is `*`,
+        # which represents any field. Field paths may be quoted using ` (backtick). The
+        # only character that needs to be escaped within a quoted field path is the
+        # backtick character itself, escaped using a backslash. Special characters in
+        # field paths that must be quoted include: `*`, `.`, ``` (backtick), `[`, `]`,
+        # as well as any ascii symbolic characters. Examples: (Note: Comments here are
+        # written in markdown syntax, so there is an additional layer of backticks to
+        # represent a code block) `\`address.city\`` represents a field named `address.
+        # city`, not the map key `city` in the field `address`. `\`*\`` represents a
+        # field named `*`, not any field. A special `Field` contains the default
+        # indexing settings for all fields. This field's resource name is: `projects/`
+        # project_id`/databases/`database_id`/collectionGroups/__default__/fields/*`
         # Indexes defined on this `Field` will be applied to all fields which do not
         # have their own `Field` index configuration.
         # Corresponds to the JSON property `name`
@@ -965,8 +929,8 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.UpdateField.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # UpdateField.
       class GoogleFirestoreAdminV1FieldOperationMetadata
         include Google::Apis::Core::Hashable
       
@@ -976,29 +940,26 @@ module Google
         # @return [String]
         attr_accessor :end_time
       
-        # The field resource that this operation is acting on. For example:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /fields/`field_path``
+        # The field resource that this operation is acting on. For example: `projects/`
+        # project_id`/databases/`database_id`/collectionGroups/`collection_id`/fields/`
+        # field_path``
         # Corresponds to the JSON property `field`
         # @return [String]
         attr_accessor :field
       
-        # A list of IndexConfigDelta, which describe the intent of this
-        # operation.
+        # A list of IndexConfigDelta, which describe the intent of this operation.
         # Corresponds to the JSON property `indexConfigDeltas`
         # @return [Array<Google::Apis::FirestoreV1::GoogleFirestoreAdminV1IndexConfigDelta>]
         attr_accessor :index_config_deltas
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressBytes`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_bytes
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressDocuments`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_documents
@@ -1029,8 +990,8 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.ImportDocuments.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # ImportDocuments.
       class GoogleFirestoreAdminV1ImportDocumentsMetadata
         include Google::Apis::Core::Hashable
       
@@ -1055,16 +1016,14 @@ module Google
         # @return [String]
         attr_accessor :operation_state
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressBytes`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_bytes
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressDocuments`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_documents
@@ -1094,16 +1053,14 @@ module Google
       class GoogleFirestoreAdminV1ImportDocumentsRequest
         include Google::Apis::Core::Hashable
       
-        # Which collection ids to import. Unspecified means all collections included
-        # in the import.
+        # Which collection ids to import. Unspecified means all collections included in
+        # the import.
         # Corresponds to the JSON property `collectionIds`
         # @return [Array<String>]
         attr_accessor :collection_ids
       
-        # Location of the exported files.
-        # This must match the output_uri_prefix of an ExportDocumentsResponse from
-        # an export that has completed successfully.
-        # See:
+        # Location of the exported files. This must match the output_uri_prefix of an
+        # ExportDocumentsResponse from an export that has completed successfully. See:
         # google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.
         # Corresponds to the JSON property `inputUriPrefix`
         # @return [String]
@@ -1120,39 +1077,37 @@ module Google
         end
       end
       
-      # Cloud Firestore indexes enable simple and complex queries against
-      # documents in a database.
+      # Cloud Firestore indexes enable simple and complex queries against documents in
+      # a database.
       class GoogleFirestoreAdminV1Index
         include Google::Apis::Core::Hashable
       
-        # The fields supported by this index.
-        # For composite indexes, this is always 2 or more fields.
-        # The last field entry is always for the field path `__name__`. If, on
-        # creation, `__name__` was not specified as the last field, it will be added
+        # The fields supported by this index. For composite indexes, this is always 2 or
+        # more fields. The last field entry is always for the field path `__name__`. If,
+        # on creation, `__name__` was not specified as the last field, it will be added
         # automatically with the same direction as that of the last field defined. If
-        # the final field in a composite index is not directional, the `__name__`
-        # will be ordered ASCENDING (unless explicitly specified).
-        # For single field indexes, this will always be exactly one entry with a
-        # field path equal to the field path of the associated field.
+        # the final field in a composite index is not directional, the `__name__` will
+        # be ordered ASCENDING (unless explicitly specified). For single field indexes,
+        # this will always be exactly one entry with a field path equal to the field
+        # path of the associated field.
         # Corresponds to the JSON property `fields`
         # @return [Array<Google::Apis::FirestoreV1::GoogleFirestoreAdminV1IndexField>]
         attr_accessor :fields
       
-        # Output only. A server defined name for this index.
-        # The form of this name for composite indexes will be:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /indexes/`composite_index_id``
-        # For single field indexes, this field will be empty.
+        # Output only. A server defined name for this index. The form of this name for
+        # composite indexes will be: `projects/`project_id`/databases/`database_id`/
+        # collectionGroups/`collection_id`/indexes/`composite_index_id`` For single
+        # field indexes, this field will be empty.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Indexes with a collection query scope specified allow queries
-        # against a collection that is the child of a specific document, specified at
-        # query time, and that has the same collection id.
-        # Indexes with a collection group query scope specified allow queries against
-        # all collections descended from a specific document, specified at query
-        # time, and that have the same collection id as this index.
+        # Indexes with a collection query scope specified allow queries against a
+        # collection that is the child of a specific document, specified at query time,
+        # and that has the same collection id. Indexes with a collection group query
+        # scope specified allow queries against all collections descended from a
+        # specific document, specified at query time, and that have the same collection
+        # id as this index.
         # Corresponds to the JSON property `queryScope`
         # @return [String]
         attr_accessor :query_scope
@@ -1180,10 +1135,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Output only. Specifies the resource name of the `Field` from which this field'
-        # s
-        # index configuration is set (when `uses_ancestor_config` is true),
-        # or from which it *would* be set if this field had no index configuration
-        # (when `uses_ancestor_config` is false).
+        # s index configuration is set (when `uses_ancestor_config` is true), or from
+        # which it *would* be set if this field had no index configuration (when `
+        # uses_ancestor_config` is false).
         # Corresponds to the JSON property `ancestorField`
         # @return [String]
         attr_accessor :ancestor_field
@@ -1193,19 +1147,18 @@ module Google
         # @return [Array<Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Index>]
         attr_accessor :indexes
       
-        # Output only
-        # When true, the `Field`'s index configuration is in the process of being
-        # reverted. Once complete, the index config will transition to the same
-        # state as the field specified by `ancestor_field`, at which point
-        # `uses_ancestor_config` will be `true` and `reverting` will be `false`.
+        # Output only When true, the `Field`'s index configuration is in the process of
+        # being reverted. Once complete, the index config will transition to the same
+        # state as the field specified by `ancestor_field`, at which point `
+        # uses_ancestor_config` will be `true` and `reverting` will be `false`.
         # Corresponds to the JSON property `reverting`
         # @return [Boolean]
         attr_accessor :reverting
         alias_method :reverting?, :reverting
       
         # Output only. When true, the `Field`'s index configuration is set from the
-        # configuration specified by the `ancestor_field`.
-        # When false, the `Field`'s index configuration is defined explicitly.
+        # configuration specified by the `ancestor_field`. When false, the `Field`'s
+        # index configuration is defined explicitly.
         # Corresponds to the JSON property `usesAncestorConfig`
         # @return [Boolean]
         attr_accessor :uses_ancestor_config
@@ -1233,8 +1186,8 @@ module Google
         # @return [String]
         attr_accessor :change_type
       
-        # Cloud Firestore indexes enable simple and complex queries against
-        # documents in a database.
+        # Cloud Firestore indexes enable simple and complex queries against documents in
+        # a database.
         # Corresponds to the JSON property `index`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Index]
         attr_accessor :index
@@ -1250,9 +1203,8 @@ module Google
         end
       end
       
-      # A field in an index.
-      # The field_path describes which field is indexed, the value_mode describes
-      # how the field value is indexed.
+      # A field in an index. The field_path describes which field is indexed, the
+      # value_mode describes how the field value is indexed.
       class GoogleFirestoreAdminV1IndexField
         include Google::Apis::Core::Hashable
       
@@ -1261,9 +1213,8 @@ module Google
         # @return [String]
         attr_accessor :array_config
       
-        # Can be __name__.
-        # For single field indexes, this must match the name of the field or may
-        # be omitted.
+        # Can be __name__. For single field indexes, this must match the name of the
+        # field or may be omitted.
         # Corresponds to the JSON property `fieldPath`
         # @return [String]
         attr_accessor :field_path
@@ -1286,8 +1237,8 @@ module Google
         end
       end
       
-      # Metadata for google.longrunning.Operation results from
-      # FirestoreAdmin.CreateIndex.
+      # Metadata for google.longrunning.Operation results from FirestoreAdmin.
+      # CreateIndex.
       class GoogleFirestoreAdminV1IndexOperationMetadata
         include Google::Apis::Core::Hashable
       
@@ -1297,23 +1248,21 @@ module Google
         # @return [String]
         attr_accessor :end_time
       
-        # The index resource that this operation is acting on. For example:
-        # `projects/`project_id`/databases/`database_id`/collectionGroups/`collection_id`
-        # /indexes/`index_id``
+        # The index resource that this operation is acting on. For example: `projects/`
+        # project_id`/databases/`database_id`/collectionGroups/`collection_id`/indexes/`
+        # index_id``
         # Corresponds to the JSON property `index`
         # @return [String]
         attr_accessor :index
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressBytes`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_bytes
       
-        # Describes the progress of the operation.
-        # Unit of work is generic and must be interpreted based on where Progress
-        # is used.
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
         # Corresponds to the JSON property `progressDocuments`
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
         attr_accessor :progress_documents
@@ -1408,9 +1357,8 @@ module Google
         end
       end
       
-      # Describes the progress of the operation.
-      # Unit of work is generic and must be interpreted based on where Progress
-      # is used.
+      # Describes the progress of the operation. Unit of work is generic and must be
+      # interpreted based on where Progress is used.
       class GoogleFirestoreAdminV1Progress
         include Google::Apis::Core::Hashable
       
@@ -1478,47 +1426,45 @@ module Google
       class GoogleLongrunningOperation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::FirestoreV1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -1539,9 +1485,8 @@ module Google
       
       # An object representing a latitude/longitude pair. This is expressed as a pair
       # of doubles representing degrees latitude and degrees longitude. Unless
-      # specified otherwise, this must conform to the
-      # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-      # standard</a>. Values must be within normalized ranges.
+      # specified otherwise, this must conform to the WGS84 standard. Values must be
+      # within normalized ranges.
       class LatLng
         include Google::Apis::Core::Hashable
       
@@ -1575,8 +1520,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # A page token. Must be a value from
-        # ListCollectionIdsResponse.
+        # A page token. Must be a value from ListCollectionIdsResponse.
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
@@ -1702,30 +1646,27 @@ module Google
       class ListenResponse
         include Google::Apis::Core::Hashable
       
-        # A Document has changed.
-        # May be the result of multiple writes, including deletes, that
-        # ultimately resulted in a new value for the Document.
-        # Multiple DocumentChange messages may be returned for the same logical
-        # change, if multiple targets are affected.
+        # A Document has changed. May be the result of multiple writes, including
+        # deletes, that ultimately resulted in a new value for the Document. Multiple
+        # DocumentChange messages may be returned for the same logical change, if
+        # multiple targets are affected.
         # Corresponds to the JSON property `documentChange`
         # @return [Google::Apis::FirestoreV1::DocumentChange]
         attr_accessor :document_change
       
-        # A Document has been deleted.
-        # May be the result of multiple writes, including updates, the
-        # last of which deleted the Document.
-        # Multiple DocumentDelete messages may be returned for the same logical
-        # delete, if multiple targets are affected.
+        # A Document has been deleted. May be the result of multiple writes, including
+        # updates, the last of which deleted the Document. Multiple DocumentDelete
+        # messages may be returned for the same logical delete, if multiple targets are
+        # affected.
         # Corresponds to the JSON property `documentDelete`
         # @return [Google::Apis::FirestoreV1::DocumentDelete]
         attr_accessor :document_delete
       
-        # A Document has been removed from the view of the targets.
-        # Sent if the document is no longer relevant to a target and is out of view.
-        # Can be sent instead of a DocumentDelete or a DocumentChange if the server
-        # can not send the new value of the document.
-        # Multiple DocumentRemove messages may be returned for the same logical
-        # write or delete, if multiple targets are affected.
+        # A Document has been removed from the view of the targets. Sent if the document
+        # is no longer relevant to a target and is out of view. Can be sent instead of a
+        # DocumentDelete or a DocumentChange if the server can not send the new value of
+        # the document. Multiple DocumentRemove messages may be returned for the same
+        # logical write or delete, if multiple targets are affected.
         # Corresponds to the JSON property `documentRemove`
         # @return [Google::Apis::FirestoreV1::DocumentRemove]
         attr_accessor :document_remove
@@ -1758,14 +1699,14 @@ module Google
       class Location
         include Google::Apis::Core::Hashable
       
-        # The friendly name for this location, typically a nearby city name.
-        # For example, "Tokyo".
+        # The friendly name for this location, typically a nearby city name. For example,
+        # "Tokyo".
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Cross-service attributes for the location. For example
-        # `"cloud.googleapis.com/region": "us-east1"`
+        # Cross-service attributes for the location. For example `"cloud.googleapis.com/
+        # region": "us-east1"`
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1781,8 +1722,8 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
-        # Resource name for the location, which may vary between implementations.
-        # For example: `"projects/example-project/locations/us-east1"`
+        # Resource name for the location, which may vary between implementations. For
+        # example: `"projects/example-project/locations/us-east1"`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1805,11 +1746,10 @@ module Google
       class MapValue
         include Google::Apis::Core::Hashable
       
-        # The map's fields.
-        # The map keys represent field names. Field names matching the regular
-        # expression `__.*__` are reserved. Reserved field names are forbidden except
-        # in certain documented contexts. The map keys, represented as UTF-8, must
-        # not exceed 1,500 bytes and cannot be empty.
+        # The map's fields. The map keys represent field names. Field names matching the
+        # regular expression `__.*__` are reserved. Reserved field names are forbidden
+        # except in certain documented contexts. The map keys, represented as UTF-8,
+        # must not exceed 1,500 bytes and cannot be empty.
         # Corresponds to the JSON property `fields`
         # @return [Hash<String,Google::Apis::FirestoreV1::Value>]
         attr_accessor :fields
@@ -1853,37 +1793,34 @@ module Google
       class PartitionQueryRequest
         include Google::Apis::Core::Hashable
       
-        # The maximum number of partitions to return in this call, subject to
-        # `partition_count`.
-        # For example, if `partition_count` = 10 and `page_size` = 8, the first call
-        # to PartitionQuery will return up to 8 partitions and a `next_page_token`
-        # if more results exist. A second call to PartitionQuery will return up to
-        # 2 partitions, to complete the total of 10 specified in `partition_count`.
+        # The maximum number of partitions to return in this call, subject to `
+        # partition_count`. For example, if `partition_count` = 10 and `page_size` = 8,
+        # the first call to PartitionQuery will return up to 8 partitions and a `
+        # next_page_token` if more results exist. A second call to PartitionQuery will
+        # return up to 2 partitions, to complete the total of 10 specified in `
+        # partition_count`.
         # Corresponds to the JSON property `pageSize`
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # The `next_page_token` value returned from a previous call to
-        # PartitionQuery that may be used to get an additional set of results.
-        # There are no ordering guarantees between sets of results. Thus, using
-        # multiple sets of results will require merging the different result sets.
-        # For example, two subsequent calls using a page_token may return:
-        # * cursor B, cursor M, cursor Q
-        # * cursor A, cursor U, cursor W
-        # To obtain a complete result set ordered with respect to the results of the
-        # query supplied to PartitionQuery, the results sets should be merged:
-        # cursor A, cursor B, cursor M, cursor Q, cursor U, cursor W
+        # The `next_page_token` value returned from a previous call to PartitionQuery
+        # that may be used to get an additional set of results. There are no ordering
+        # guarantees between sets of results. Thus, using multiple sets of results will
+        # require merging the different result sets. For example, two subsequent calls
+        # using a page_token may return: * cursor B, cursor M, cursor Q * cursor A,
+        # cursor U, cursor W To obtain a complete result set ordered with respect to the
+        # results of the query supplied to PartitionQuery, the results sets should be
+        # merged: cursor A, cursor B, cursor M, cursor Q, cursor U, cursor W
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
       
-        # The desired maximum number of partition points.
-        # The partitions may be returned across multiple pages of results.
-        # The number must be strictly positive. The actual number of partitions
-        # returned may be fewer.
-        # For example, this may be set to one fewer than the number of parallel
-        # queries to be run, or in running a data pipeline job, one fewer than the
-        # number of workers or compute instances available.
+        # The desired maximum number of partition points. The partitions may be returned
+        # across multiple pages of results. The number must be positive. The actual
+        # number of partitions returned may be fewer. For example, this may be set to
+        # one fewer than the number of parallel queries to be run, or in running a data
+        # pipeline job, one fewer than the number of workers or compute instances
+        # available.
         # Corresponds to the JSON property `partitionCount`
         # @return [Fixnum]
         attr_accessor :partition_count
@@ -1910,25 +1847,22 @@ module Google
       class PartitionQueryResponse
         include Google::Apis::Core::Hashable
       
-        # A page token that may be used to request an additional set of results, up
-        # to the number specified by `partition_count` in the PartitionQuery request.
-        # If blank, there are no more results.
+        # A page token that may be used to request an additional set of results, up to
+        # the number specified by `partition_count` in the PartitionQuery request. If
+        # blank, there are no more results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # Partition results.
-        # Each partition is a split point that can be used by RunQuery as a starting
-        # or end point for the query results. The RunQuery requests must be made with
-        # the same query supplied to this PartitionQuery request. The partition
-        # cursors will be ordered according to same ordering as the results of the
-        # query supplied to PartitionQuery.
-        # For example, if a PartitionQuery request returns partition cursors A and B,
-        # running the following three queries will return the entire result set of
-        # the original query:
-        # * query, end_at A
-        # * query, start_at A, end_at B
-        # * query, start_at B
+        # Partition results. Each partition is a split point that can be used by
+        # RunQuery as a starting or end point for the query results. The RunQuery
+        # requests must be made with the same query supplied to this PartitionQuery
+        # request. The partition cursors will be ordered according to same ordering as
+        # the results of the query supplied to PartitionQuery. For example, if a
+        # PartitionQuery request returns partition cursors A and B, running the
+        # following three queries will return the entire result set of the original
+        # query: * query, end_at A * query, start_at A, end_at B * query, start_at B An
+        # empty result may indicate that the query has too few results to be partitioned.
         # Corresponds to the JSON property `partitions`
         # @return [Array<Google::Apis::FirestoreV1::Cursor>]
         attr_accessor :partitions
@@ -1948,15 +1882,15 @@ module Google
       class Precondition
         include Google::Apis::Core::Hashable
       
-        # When set to `true`, the target document must exist.
-        # When set to `false`, the target document must not exist.
+        # When set to `true`, the target document must exist. When set to `false`, the
+        # target document must not exist.
         # Corresponds to the JSON property `exists`
         # @return [Boolean]
         attr_accessor :exists
         alias_method :exists?, :exists
       
-        # When set, the target document must exist and have been last updated at
-        # that time.
+        # When set, the target document must exist and have been last updated at that
+        # time.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -1976,9 +1910,8 @@ module Google
       class Projection
         include Google::Apis::Core::Hashable
       
-        # The fields to return.
-        # If empty, all fields are returned. To only return the name
-        # of the document, use `['__name__']`.
+        # The fields to return. If empty, all fields are returned. To only return the
+        # name of the document, use `['__name__']`.
         # Corresponds to the JSON property `fields`
         # @return [Array<Google::Apis::FirestoreV1::FieldReference>]
         attr_accessor :fields
@@ -1997,12 +1930,11 @@ module Google
       class QueryTarget
         include Google::Apis::Core::Hashable
       
-        # 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`
+        # 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`
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
@@ -2027,8 +1959,7 @@ module Google
       class ReadOnly
         include Google::Apis::Core::Hashable
       
-        # Reads documents at the given time.
-        # This may not be older than 60 seconds.
+        # Reads documents at the given time. This may not be older than 60 seconds.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
@@ -2092,8 +2023,8 @@ module Google
         # @return [Google::Apis::FirestoreV1::TransactionOptions]
         attr_accessor :new_transaction
       
-        # Reads documents as they were at the given time.
-        # This may not be older than 270 seconds.
+        # Reads documents as they were at the given time. This may not be older than 270
+        # seconds.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
@@ -2126,32 +2057,29 @@ module Google
       class RunQueryResponse
         include Google::Apis::Core::Hashable
       
-        # A Firestore document.
-        # Must not exceed 1 MiB - 4 bytes.
+        # A Firestore document. Must not exceed 1 MiB - 4 bytes.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::FirestoreV1::Document]
         attr_accessor :document
       
-        # The time at which the document was read. This may be monotonically
-        # increasing; in this case, the previous documents in the result stream are
-        # guaranteed not to have changed between their `read_time` and this one.
-        # If the query returns no results, a response with `read_time` and no
-        # `document` will be sent, and this represents the time at which the query
-        # was run.
+        # The time at which the document was read. This may be monotonically increasing;
+        # in this case, the previous documents in the result stream are guaranteed not
+        # to have changed between their `read_time` and this one. If the query returns
+        # no results, a response with `read_time` and no `document` will be sent, and
+        # this represents the time at which the query was run.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
       
-        # The number of results that have been skipped due to an offset between
-        # the last response and the current response.
+        # The number of results that have been skipped due to an offset between the last
+        # response and the current response.
         # Corresponds to the JSON property `skippedResults`
         # @return [Fixnum]
         attr_accessor :skipped_results
       
-        # The transaction that was started as part of this request.
-        # Can only be set in the first response, and only if
-        # RunQueryRequest.new_transaction was set in the request.
-        # If set, no other fields will be set in this response.
+        # The transaction that was started as part of this request. Can only be set in
+        # the first response, and only if RunQueryRequest.new_transaction was set in the
+        # request. If set, no other fields will be set in this response.
         # Corresponds to the JSON property `transaction`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -2170,12 +2098,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -2184,15 +2112,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -2223,34 +2151,28 @@ module Google
         # @return [Array<Google::Apis::FirestoreV1::CollectionSelector>]
         attr_accessor :from
       
-        # The maximum number of results to return.
-        # Applies after all other constraints.
+        # The maximum number of results to return. Applies after all other constraints.
         # Must be >= 0 if specified.
         # Corresponds to the JSON property `limit`
         # @return [Fixnum]
         attr_accessor :limit
       
-        # The number of results to skip.
-        # Applies before limit, but after all other constraints. Must be >= 0 if
-        # specified.
+        # The number of results to skip. Applies before limit, but after all other
+        # constraints. Must be >= 0 if specified.
         # Corresponds to the JSON property `offset`
         # @return [Fixnum]
         attr_accessor :offset
       
-        # The order to apply to the query results.
-        # Firestore guarantees a stable ordering through the following rules:
-        # * Any field required to appear in `order_by`, that is not already
-        # specified in `order_by`, is appended to the order in field name order
-        # by default.
-        # * If an order on `__name__` is not specified, it is appended by default.
-        # Fields are appended with the same sort direction as the last order
-        # specified, or 'ASCENDING' if no order was specified. For example:
-        # * `SELECT * FROM Foo ORDER BY A` becomes
-        # `SELECT * FROM Foo ORDER BY A, __name__`
-        # * `SELECT * FROM Foo ORDER BY A DESC` becomes
-        # `SELECT * FROM Foo ORDER BY A DESC, __name__ DESC`
-        # * `SELECT * FROM Foo WHERE A > 1` becomes
-        # `SELECT * FROM Foo WHERE A > 1 ORDER BY A, __name__`
+        # The order to apply to the query results. Firestore guarantees a stable
+        # ordering through the following rules: * Any field required to appear in `
+        # order_by`, that is not already specified in `order_by`, is appended to the
+        # order in field name order by default. * If an order on `__name__` is not
+        # specified, it is appended by default. Fields are appended with the same sort
+        # direction as the last order specified, or 'ASCENDING' if no order was
+        # specified. For example: * `SELECT * FROM Foo ORDER BY A` becomes `SELECT *
+        # FROM Foo ORDER BY A, __name__` * `SELECT * FROM Foo ORDER BY A DESC` becomes `
+        # SELECT * FROM Foo ORDER BY A DESC, __name__ DESC` * `SELECT * FROM Foo WHERE A
+        # > 1` becomes `SELECT * FROM Foo WHERE A > 1 ORDER BY A, __name__`
         # Corresponds to the JSON property `orderBy`
         # @return [Array<Google::Apis::FirestoreV1::Order>]
         attr_accessor :order_by
@@ -2307,14 +2229,14 @@ module Google
         # @return [Google::Apis::FirestoreV1::QueryTarget]
         attr_accessor :query
       
-        # Start listening after a specific `read_time`.
-        # The client must know the state of matching documents at this time.
+        # Start listening after a specific `read_time`. The client must know the state
+        # of matching documents at this time.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
       
-        # A resume token from a prior TargetChange for an identical target.
-        # Using a resume token with a different target is unsupported and may fail.
+        # A resume token from a prior TargetChange for an identical target. Using a
+        # resume token with a different target is unsupported and may fail.
         # Corresponds to the JSON property `resumeToken`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -2345,31 +2267,29 @@ module Google
       class TargetChange
         include Google::Apis::Core::Hashable
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `cause`
         # @return [Google::Apis::FirestoreV1::Status]
         attr_accessor :cause
       
         # The consistent `read_time` for the given `target_ids` (omitted when the
-        # target_ids are not at a consistent snapshot).
-        # The stream is guaranteed to send a `read_time` with `target_ids` empty
-        # whenever the entire stream reaches a new consistent snapshot. ADD,
-        # CURRENT, and RESET messages are guaranteed to (eventually) result in a
-        # new consistent snapshot (while NO_CHANGE and REMOVE messages are not).
-        # For a given stream, `read_time` is guaranteed to be monotonically
-        # increasing.
+        # target_ids are not at a consistent snapshot). The stream is guaranteed to send
+        # a `read_time` with `target_ids` empty whenever the entire stream reaches a new
+        # consistent snapshot. ADD, CURRENT, and RESET messages are guaranteed to (
+        # eventually) result in a new consistent snapshot (while NO_CHANGE and REMOVE
+        # messages are not). For a given stream, `read_time` is guaranteed to be
+        # monotonically increasing.
         # Corresponds to the JSON property `readTime`
         # @return [String]
         attr_accessor :read_time
       
-        # A token that can be used to resume the stream for the given `target_ids`,
-        # or all targets if `target_ids` is empty.
-        # Not set on every target change.
+        # A token that can be used to resume the stream for the given `target_ids`, or
+        # all targets if `target_ids` is empty. Not set on every target change.
         # Corresponds to the JSON property `resumeToken`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -2380,9 +2300,8 @@ module Google
         # @return [String]
         attr_accessor :target_change_type
       
-        # The target IDs of targets that have changed.
-        # If empty, the change applies to all targets.
-        # The order of the target IDs is not defined.
+        # The target IDs of targets that have changed. If empty, the change applies to
+        # all targets. The order of the target IDs is not defined.
         # Corresponds to the JSON property `targetIds`
         # @return [Array<Fixnum>]
         attr_accessor :target_ids
@@ -2466,9 +2385,8 @@ module Google
         attr_accessor :boolean_value
         alias_method :boolean_value?, :boolean_value
       
-        # A bytes value.
-        # Must not exceed 1 MiB - 89 bytes.
-        # Only the first 1,500 bytes are considered by queries.
+        # A bytes value. Must not exceed 1 MiB - 89 bytes. Only the first 1,500 bytes
+        # are considered by queries.
         # Corresponds to the JSON property `bytesValue`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -2481,9 +2399,8 @@ module Google
       
         # An object representing a latitude/longitude pair. This is expressed as a pair
         # of doubles representing degrees latitude and degrees longitude. Unless
-        # specified otherwise, this must conform to the
-        # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-        # standard</a>. Values must be within normalized ranges.
+        # specified otherwise, this must conform to the WGS84 standard. Values must be
+        # within normalized ranges.
         # Corresponds to the JSON property `geoPointValue`
         # @return [Google::Apis::FirestoreV1::LatLng]
         attr_accessor :geo_point_value
@@ -2503,23 +2420,21 @@ module Google
         # @return [String]
         attr_accessor :null_value
       
-        # A reference to a document. For example:
-        # `projects/`project_id`/databases/`database_id`/documents/`document_path``.
+        # A reference to a document. For example: `projects/`project_id`/databases/`
+        # database_id`/documents/`document_path``.
         # Corresponds to the JSON property `referenceValue`
         # @return [String]
         attr_accessor :reference_value
       
-        # A string value.
-        # The string, represented as UTF-8, must not exceed 1 MiB - 89 bytes.
-        # Only the first 1,500 bytes of the UTF-8 representation are considered by
-        # queries.
+        # A string value. The string, represented as UTF-8, must not exceed 1 MiB - 89
+        # bytes. Only the first 1,500 bytes of the UTF-8 representation are considered
+        # by queries.
         # Corresponds to the JSON property `stringValue`
         # @return [String]
         attr_accessor :string_value
       
-        # A timestamp value.
-        # Precise only to microseconds. When stored, any additional precision is
-        # rounded down.
+        # A timestamp value. Precise only to microseconds. When stored, any additional
+        # precision is rounded down.
         # Corresponds to the JSON property `timestampValue`
         # @return [String]
         attr_accessor :timestamp_value
@@ -2553,8 +2468,8 @@ module Google
         # @return [Google::Apis::FirestoreV1::Precondition]
         attr_accessor :current_document
       
-        # A document name to delete. In the format:
-        # `projects/`project_id`/databases/`database_id`/documents/`document_path``.
+        # A document name to delete. In the format: `projects/`project_id`/databases/`
+        # database_id`/documents/`document_path``.
         # Corresponds to the JSON property `delete`
         # @return [String]
         attr_accessor :delete
@@ -2564,25 +2479,22 @@ module Google
         # @return [Google::Apis::FirestoreV1::DocumentTransform]
         attr_accessor :transform
       
-        # A Firestore document.
-        # Must not exceed 1 MiB - 4 bytes.
+        # A Firestore document. Must not exceed 1 MiB - 4 bytes.
         # Corresponds to the JSON property `update`
         # @return [Google::Apis::FirestoreV1::Document]
         attr_accessor :update
       
-        # A set of field paths on a document.
-        # Used to restrict a get or update operation on a document to a subset of its
-        # fields.
-        # This is different from standard field masks, as this is always scoped to a
-        # Document, and takes in account the dynamic nature of Value.
+        # A set of field paths on a document. Used to restrict a get or update operation
+        # on a document to a subset of its fields. This is different from standard field
+        # masks, as this is always scoped to a Document, and takes in account the
+        # dynamic nature of Value.
         # Corresponds to the JSON property `updateMask`
         # @return [Google::Apis::FirestoreV1::DocumentMask]
         attr_accessor :update_mask
       
-        # The transforms to perform after update.
-        # This field can be set only when the operation is `update`. If present, this
-        # write is equivalent to performing `update` and `transform` to the same
-        # document atomically and in order.
+        # The transforms to perform after update. This field can be set only when the
+        # operation is `update`. If present, this write is equivalent to performing `
+        # update` and `transform` to the same document atomically and in order.
         # Corresponds to the JSON property `updateTransforms`
         # @return [Array<Google::Apis::FirestoreV1::FieldTransform>]
         attr_accessor :update_transforms
@@ -2602,13 +2514,12 @@ module Google
         end
       end
       
-      # The request for Firestore.Write.
-      # The first request creates a stream, or resumes an existing one from a token.
-      # When creating a new stream, the server replies with a response containing
-      # only an ID and a token, to use in the next request.
-      # When resuming a stream, the server first streams any responses later than the
-      # given token, then a response containing only an up-to-date token, to use in
-      # the next request.
+      # The request for Firestore.Write. The first request creates a stream, or
+      # resumes an existing one from a token. When creating a new stream, the server
+      # replies with a response containing only an ID and a token, to use in the next
+      # request. When resuming a stream, the server first streams any responses later
+      # than the given token, then a response containing only an up-to-date token, to
+      # use in the next request.
       class WriteRequest
         include Google::Apis::Core::Hashable
       
@@ -2617,33 +2528,28 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The ID of the write stream to resume.
-        # This may only be set in the first message. When left empty, a new write
-        # stream will be created.
+        # The ID of the write stream to resume. This may only be set in the first
+        # message. When left empty, a new write stream will be created.
         # Corresponds to the JSON property `streamId`
         # @return [String]
         attr_accessor :stream_id
       
-        # A stream token that was previously sent by the server.
-        # The client should set this field to the token from the most recent
-        # WriteResponse it has received. This acknowledges that the client has
-        # received responses up to this token. After sending this token, earlier
-        # tokens may not be used anymore.
-        # The server may close the stream if there are too many unacknowledged
-        # responses.
-        # Leave this field unset when creating a new stream. To resume a stream at
-        # a specific point, set this field and the `stream_id` field.
-        # Leave this field unset when creating a new stream.
+        # A stream token that was previously sent by the server. The client should set
+        # this field to the token from the most recent WriteResponse it has received.
+        # This acknowledges that the client has received responses up to this token.
+        # After sending this token, earlier tokens may not be used anymore. The server
+        # may close the stream if there are too many unacknowledged responses. Leave
+        # this field unset when creating a new stream. To resume a stream at a specific
+        # point, set this field and the `stream_id` field. Leave this field unset when
+        # creating a new stream.
         # Corresponds to the JSON property `streamToken`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :stream_token
       
-        # The writes to apply.
-        # Always executed atomically and in order.
-        # This must be empty on the first request.
-        # This may be empty on the last request.
-        # This must not be empty on all other requests.
+        # The writes to apply. Always executed atomically and in order. This must be
+        # empty on the first request. This may be empty on the last request. This must
+        # not be empty on all other requests.
         # Corresponds to the JSON property `writes`
         # @return [Array<Google::Apis::FirestoreV1::Write>]
         attr_accessor :writes
@@ -2665,29 +2571,28 @@ module Google
       class WriteResponse
         include Google::Apis::Core::Hashable
       
-        # The time at which the commit occurred. Any read with an equal or greater
-        # `read_time` is guaranteed to see the effects of the write.
+        # The time at which the commit occurred. Any read with an equal or greater `
+        # read_time` is guaranteed to see the effects of the write.
         # Corresponds to the JSON property `commitTime`
         # @return [String]
         attr_accessor :commit_time
       
-        # The ID of the stream.
-        # Only set on the first message, when a new stream was created.
+        # The ID of the stream. Only set on the first message, when a new stream was
+        # created.
         # Corresponds to the JSON property `streamId`
         # @return [String]
         attr_accessor :stream_id
       
-        # A token that represents the position of this response in the stream.
-        # This can be used by a client to resume the stream at this point.
-        # This field is always set.
+        # A token that represents the position of this response in the stream. This can
+        # be used by a client to resume the stream at this point. This field is always
+        # set.
         # Corresponds to the JSON property `streamToken`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :stream_token
       
-        # The result of applying the writes.
-        # This i-th write result corresponds to the i-th write in the
-        # request.
+        # The result of applying the writes. This i-th write result corresponds to the i-
+        # th write in the request.
         # Corresponds to the JSON property `writeResults`
         # @return [Array<Google::Apis::FirestoreV1::WriteResult>]
         attr_accessor :write_results
@@ -2709,15 +2614,14 @@ module Google
       class WriteResult
         include Google::Apis::Core::Hashable
       
-        # The results of applying each DocumentTransform.FieldTransform, in the
-        # same order.
+        # The results of applying each DocumentTransform.FieldTransform, in the same
+        # order.
         # Corresponds to the JSON property `transformResults`
         # @return [Array<Google::Apis::FirestoreV1::Value>]
         attr_accessor :transform_results
       
-        # The last update time of the document after applying the write. Not set
-        # after a `delete`.
-        # If the write did not actually change the document, this will be the
+        # The last update time of the document after applying the write. Not set after a
+        # `delete`. If the write did not actually change the document, this will be the
         # previous update_time.
         # Corresponds to the JSON property `updateTime`
         # @return [String]