docs: Update property requirement specifications (#1169)

gcf-owl-bot[bot] · web-flow · commit c908837ea953 · 2023-08-17T19:06:14.000Z
- [ ] 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
diff --git a/proto-google-cloud-datastore-v1/src/main/java/com/google/datastore/v1/PropertyReference.java b/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>
diff --git a/proto-google-cloud-datastore-v1/src/main/java/com/google/datastore/v1/PropertyReferenceOrBuilder.java b/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>
diff --git a/proto-google-cloud-datastore-v1/src/main/proto/google/datastore/v1/query.proto b/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;
 }
 

Original file line number	Diff line number	Diff line change
`@@ -70,8 +70,13 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {`
`70`	`70`	`*`
`71`	`71`	`*`
`72`	`72`	`* <pre>`
`73`		`- * The name of the property.`
`74`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`73`	`+ * A reference to a property.`
	`74`	`+ *`
	`75`	`+ * Requires:`
	`76`	`+ *`
	`77`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`78`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`79`	`+ * limitations.`
`75`	`80`	`* </pre>`
`76`	`81`	`*`
`77`	`82`	`* <code>string name = 2;</code>`
`@@ -94,8 +99,13 @@ public java.lang.String getName() {`
`94`	`99`	`*`
`95`	`100`	`*`
`96`	`101`	`* <pre>`
`97`		`- * The name of the property.`
`98`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`102`	`+ * A reference to a property.`
	`103`	`+ *`
	`104`	`+ * Requires:`
	`105`	`+ *`
	`106`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`107`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`108`	`+ * limitations.`
`99`	`109`	`* </pre>`
`100`	`110`	`*`
`101`	`111`	`* <code>string name = 2;</code>`
`@@ -461,8 +471,13 @@ public Builder mergeFrom(`
`461`	`471`	`*`
`462`	`472`	`*`
`463`	`473`	`* <pre>`
`464`		`- * The name of the property.`
`465`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`474`	`+ * A reference to a property.`
	`475`	`+ *`
	`476`	`+ * Requires:`
	`477`	`+ *`
	`478`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`479`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`480`	`+ * limitations.`
`466`	`481`	`* </pre>`
`467`	`482`	`*`
`468`	`483`	`* <code>string name = 2;</code>`
`@@ -484,8 +499,13 @@ public java.lang.String getName() {`
`484`	`499`	`*`
`485`	`500`	`*`
`486`	`501`	`* <pre>`
`487`		`- * The name of the property.`
`488`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`502`	`+ * A reference to a property.`
	`503`	`+ *`
	`504`	`+ * Requires:`
	`505`	`+ *`
	`506`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`507`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`508`	`+ * limitations.`
`489`	`509`	`* </pre>`
`490`	`510`	`*`
`491`	`511`	`* <code>string name = 2;</code>`
`@@ -507,8 +527,13 @@ public com.google.protobuf.ByteString getNameBytes() {`
`507`	`527`	`*`
`508`	`528`	`*`
`509`	`529`	`* <pre>`
`510`		`- * The name of the property.`
`511`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`530`	`+ * A reference to a property.`
	`531`	`+ *`
	`532`	`+ * Requires:`
	`533`	`+ *`
	`534`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`535`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`536`	`+ * limitations.`
`512`	`537`	`* </pre>`
`513`	`538`	`*`
`514`	`539`	`* <code>string name = 2;</code>`
`@@ -529,8 +554,13 @@ public Builder setName(java.lang.String value) {`
`529`	`554`	`*`
`530`	`555`	`*`
`531`	`556`	`* <pre>`
`532`		`- * The name of the property.`
`533`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`557`	`+ * A reference to a property.`
	`558`	`+ *`
	`559`	`+ * Requires:`
	`560`	`+ *`
	`561`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`562`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`563`	`+ * limitations.`
`534`	`564`	`* </pre>`
`535`	`565`	`*`
`536`	`566`	`* <code>string name = 2;</code>`
`@@ -547,8 +577,13 @@ public Builder clearName() {`
`547`	`577`	`*`
`548`	`578`	`*`
`549`	`579`	`* <pre>`
`550`		`- * The name of the property.`
`551`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`580`	`+ * A reference to a property.`
	`581`	`+ *`
	`582`	`+ * Requires:`
	`583`	`+ *`
	`584`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`585`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`586`	`+ * limitations.`
`552`	`587`	`* </pre>`
`553`	`588`	`*`
`554`	`589`	`* <code>string name = 2;</code>`
Original file line number	Diff line number	Diff line change
`@@ -27,8 +27,13 @@ public interface PropertyReferenceOrBuilder`
`27`	`27`	`*`
`28`	`28`	`*`
`29`	`29`	`* <pre>`
`30`		`- * The name of the property.`
`31`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`30`	`+ * A reference to a property.`
	`31`	`+ *`
	`32`	`+ * Requires:`
	`33`	`+ *`
	`34`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`35`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`36`	`+ * limitations.`
`32`	`37`	`* </pre>`
`33`	`38`	`*`
`34`	`39`	`* <code>string name = 2;</code>`
`@@ -40,8 +45,13 @@ public interface PropertyReferenceOrBuilder`
`40`	`45`	`*`
`41`	`46`	`*`
`42`	`47`	`* <pre>`
`43`		`- * The name of the property.`
`44`		`- * If name includes "."s, it may be interpreted as a property name path.`
	`48`	`+ * A reference to a property.`
	`49`	`+ *`
	`50`	`+ * Requires:`
	`51`	`+ *`
	`52`	+ * * MUST be a dot-delimited (`.`) string of segments, where each segment
	`53`	`+ * conforms to [entity property name][google.datastore.v1.Entity.properties]`
	`54`	`+ * limitations.`
`45`	`55`	`* </pre>`
`46`	`56`	`*`
`47`	`57`	`* <code>string name = 2;</code>`