chore: Add FindNearest API to the preview branch

gcf-owl-bot[bot] · amanda-tarafa · commit 91ef4a354074 · 2024-01-18T15:13:37.000-08:00
docs: Improve the documentation on Document.fields PiperOrigin-RevId: 599602467 Source-Link: googleapis/googleapis@d32bd97 Source-Link: googleapis/googleapis-gen@0545ffc Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuRmlyZXN0b3JlLlYxLy5Pd2xCb3QueWFtbCIsImgiOiIwNTQ1ZmZjNDg4YjgyZDNhNDc3MTExOGM5MjNkNjRjZDBiNzU5OTUzIn0=
diff --git a/apis/Google.Cloud.Firestore.V1/Google.Cloud.Firestore.V1/Document.g.cs b/apis/Google.Cloud.Firestore.V1/Google.Cloud.Firestore.V1/Document.g.cs
@@ -143,23 +143,23 @@ public string Name {
     ///
     /// 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
+    /// field names are forbidden except in certain documented contexts. The field
+    /// names, 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&amp;y" : { string_value: "hello" }}}` would be
-    /// represented by the field path `foo.x&amp;y`.
+    /// defined here. For `map_value`, the field path is represented by a
+    /// dot-delimited (`.`) string of segments. Each segment is either a simple
+    /// field name (defined below) or a quoted field name. For example, the
+    /// structured field `"foo" : { map_value: { "x&amp;y" : { string_value: "hello"
+    /// }}}` would be represented by the field path `` foo.`x&amp;y` ``.
+    ///
+    /// 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`.
     ///
-    /// Within a field path, a quoted field name starts and ends with `` ` `` and
+    /// A quoted field name starts and ends with `` ` `` and
     /// may contain any character. Some characters, including `` ` ``, must be
     /// escaped using a `\`. For example, `` `x&amp;y` `` represents `x&amp;y` and
     /// `` `bak\`tik` `` represents `` bak`tik ``.
diff --git a/apis/Google.Cloud.Firestore.V1/Google.Cloud.Firestore.V1/Query.g.cs b/apis/Google.Cloud.Firestore.V1/Google.Cloud.Firestore.V1/Query.g.cs
@@ -117,6 +117,14 @@ static QueryReflection() {
   #region Messages
   /// <summary>
   /// A Firestore query.
+  ///
+  /// The query stages are executed in the following order:
+  /// 1. from
+  /// 2. where
+  /// 3. select
+  /// 4. order_by + start_at + end_at
+  /// 5. offset
+  /// 6. limit
   /// </summary>
   public sealed partial class StructuredQuery : pb::IMessage<StructuredQuery>
   #if !GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE
