docs: Update property requirement specifications (#1169)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 557861399

Source-Link: https://togithub.com/googleapis/googleapis/commit/3303b93dc165b6a5b8efdaf30db292e9ed1f28e5

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/fb0d0a45385eb0be5842111af79af5d719d32168
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZmIwZDBhNDUzODVlYjBiZTU4NDIxMTFhZjc5YWY1ZDcxOWQzMjE2OCJ9

proto-google-cloud-datastore-v1/src/main/java/com/google/datastore/v1/PropertyReference.java

@@ -70,8 +70,13 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * <pre>
-   * The name of the property.
-   * If name includes "."s, it may be interpreted as a property name path.
+   * A reference to a property.
+   *
+   * Requires:
+   *
+   * * MUST be a dot-delimited (`.`) string of segments, where each segment
+   * conforms to [entity property name][google.datastore.v1.Entity.properties]
+   * limitations.
    * </pre>
    *
    * <code>string name = 2;</code>
@@ -94,8 +99,13 @@ public java.lang.String getName() {
    *
    *
    * <pre>
-   * The name of the property.
-   * If name includes "."s, it may be interpreted as a property name path.
+   * A reference to a property.
+   *
+   * Requires:
+   *
+   * * MUST be a dot-delimited (`.`) string of segments, where each segment
+   * conforms to [entity property name][google.datastore.v1.Entity.properties]
+   * limitations.
    * </pre>
    *
    * <code>string name = 2;</code>
@@ -461,8 +471,13 @@ public Builder mergeFrom(
      *
      *
      * <pre>
-     * The name of the property.
-     * If name includes "."s, it may be interpreted as a property name path.
+     * A reference to a property.
+     *
+     * Requires:
+     *
+     * * MUST be a dot-delimited (`.`) string of segments, where each segment
+     * conforms to [entity property name][google.datastore.v1.Entity.properties]
+     * limitations.
      * </pre>
      *
      * <code>string name = 2;</code>
@@ -484,8 +499,13 @@ public java.lang.String getName() {
      *
      *
      * <pre>
-     * The name of the property.
-     * If name includes "."s, it may be interpreted as a property name path.
+     * A reference to a property.
+     *
+     * Requires:
+     *
+     * * MUST be a dot-delimited (`.`) string of segments, where each segment
+     * conforms to [entity property name][google.datastore.v1.Entity.properties]
+     * limitations.
      * </pre>
      *
      * <code>string name = 2;</code>
@@ -507,8 +527,13 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * <pre>
-     * The name of the property.
-     * If name includes "."s, it may be interpreted as a property name path.
+     * A reference to a property.
+     *
+     * Requires:
+     *
+     * * MUST be a dot-delimited (`.`) string of segments, where each segment
+     * conforms to [entity property name][google.datastore.v1.Entity.properties]
+     * limitations.
      * </pre>
      *
      * <code>string name = 2;</code>
@@ -529,8 +554,13 @@ public Builder setName(java.lang.String value) {
      *
      *
      * <pre>
-     * The name of the property.
-     * If name includes "."s, it may be interpreted as a property name path.
+     * A reference to a property.
+     *
+     * Requires:
+     *
+     * * MUST be a dot-delimited (`.`) string of segments, where each segment
+     * conforms to [entity property name][google.datastore.v1.Entity.properties]
+     * limitations.
      * </pre>
      *
      * <code>string name = 2;</code>
@@ -547,8 +577,13 @@ public Builder clearName() {
      *
      *
      * <pre>
-     * The name of the property.
-     * If name includes "."s, it may be interpreted as a property name path.
+     * A reference to a property.
+     *
+     * Requires:
+     *
+     * * MUST be a dot-delimited (`.`) string of segments, where each segment
+     * conforms to [entity property name][google.datastore.v1.Entity.properties]
+     * limitations.
      * </pre>
      *
      * <code>string name = 2;</code>

proto-google-cloud-datastore-v1/src/main/java/com/google/datastore/v1/PropertyReferenceOrBuilder.java

@@ -27,8 +27,13 @@ public interface PropertyReferenceOrBuilder
    *
    *
    * <pre>
-   * The name of the property.
-   * If name includes "."s, it may be interpreted as a property name path.
+   * A reference to a property.
+   *
+   * Requires:
+   *
+   * * MUST be a dot-delimited (`.`) string of segments, where each segment
+   * conforms to [entity property name][google.datastore.v1.Entity.properties]
+   * limitations.
    * </pre>
    *
    * <code>string name = 2;</code>
@@ -40,8 +45,13 @@ public interface PropertyReferenceOrBuilder
    *
    *
    * <pre>
-   * The name of the property.
-   * If name includes "."s, it may be interpreted as a property name path.
+   * A reference to a property.
+   *
+   * Requires:
+   *
+   * * MUST be a dot-delimited (`.`) string of segments, where each segment
+   * conforms to [entity property name][google.datastore.v1.Entity.properties]
+   * limitations.
    * </pre>
    *
    * <code>string name = 2;</code>

proto-google-cloud-datastore-v1/src/main/proto/google/datastore/v1/query.proto

@@ -279,8 +279,13 @@ message KindExpression {
 
 // A reference to a property relative to the kind expressions.
 message PropertyReference {
-  // The name of the property.
-  // If name includes "."s, it may be interpreted as a property name path.
+  // A reference to a property.
+  //
+  // Requires:
+  //
+  // * MUST be a dot-delimited (`.`) string of segments, where each segment
+  // conforms to [entity property name][google.datastore.v1.Entity.properties]
+  // limitations.
   string name = 2;
 }