From d17febb44fabc6b56c14cfd61238d157925c4a4a Mon Sep 17 00:00:00 2001
From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com>
Date: Fri, 4 Mar 2022 16:55:09 -0500
Subject: [PATCH] docs: clarify docstring in RunQueryRequest/RunQueryResponse
 (#544)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: change REST binding for ListDocuments to support root collection

PiperOrigin-RevId: 432504691

Source-Link: https://github.com/googleapis/googleapis/commit/3db30873719f8246b1396018e36185c364081e59

Source-Link: https://github.com/googleapis/googleapis-gen/commit/80f0375a1a82460532422e504a41ef2a3e2f72e1
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiODBmMDM3NWExYTgyNDYwNTMyNDIyZTUwNGE0MWVmMmEzZTJmNzJlMSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
---
 google/cloud/firestore_v1/types/common.py    | 3 ++-
 google/cloud/firestore_v1/types/firestore.py | 9 ++++++---
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/google/cloud/firestore_v1/types/common.py b/google/cloud/firestore_v1/types/common.py
index 815e8bb5a7..63356bcf1e 100644
--- a/google/cloud/firestore_v1/types/common.py
+++ b/google/cloud/firestore_v1/types/common.py
@@ -60,7 +60,8 @@ class Precondition(proto.Message):
             This field is a member of `oneof`_ ``condition_type``.
         update_time (google.protobuf.timestamp_pb2.Timestamp):
             When set, the target document must exist and
-            have been last updated at that time.
+            have been last updated at that time. Timestamp
+            must be microsecond aligned.
 
             This field is a member of `oneof`_ ``condition_type``.
     """
diff --git a/google/cloud/firestore_v1/types/firestore.py b/google/cloud/firestore_v1/types/firestore.py
index 00448f0a73..62cf58ffdb 100644
--- a/google/cloud/firestore_v1/types/firestore.py
+++ b/google/cloud/firestore_v1/types/firestore.py
@@ -511,7 +511,10 @@ class RunQueryRequest(proto.Message):
 
             This field is a member of `oneof`_ ``query_type``.
         transaction (bytes):
-            Reads documents in a transaction.
+            Run the query within an already active
+            transaction.
+            The value here is the opaque transaction ID to
+            execute the query in.
 
             This field is a member of `oneof`_ ``consistency_selector``.
         new_transaction (google.cloud.firestore_v1.types.TransactionOptions):
@@ -559,8 +562,8 @@ class RunQueryResponse(proto.Message):
             was set in the request. If set, no other fields will be set
             in this response.
         document (google.cloud.firestore_v1.types.Document):
-            A query result.
-            Not set when reporting partial progress.
+            A query result, not set when reporting
+            partial progress.
         read_time (google.protobuf.timestamp_pb2.Timestamp):
             The time at which the document was read. This may be
             monotonically increasing; in this case, the previous