docs: Add a link to Pub/Sub filtering language public documentation t…

…o pubsub.proto PiperOrigin-RevId: 315930680 Source-Author: Google APIs <noreply@google.com> Source-Date: Thu Jun 11 10:43:34 2020 -0700 Source-Repo: googleapis/googleapis Source-Sha: a19b46e54cc5195557f70ff68f1696d1e3b4702e Source-Link: googleapis/googleapis@a19b46e
googleapis · Jun 11, 2020 · e4569fc · e4569fc
1 parent 12dc146
commit e4569fc
Show file tree

Hide file tree

Showing 6 changed files with 56 additions and 29 deletions.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java
@@ -223,7 +223,8 @@ public int getAttributesCount() {
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -246,7 +247,8 @@ public java.util.Map<java.lang.String, java.lang.String> getAttributes() {
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -260,7 +262,8 @@ public java.util.Map<java.lang.String, java.lang.String> getAttributesMap() {
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -279,7 +282,8 @@ public java.lang.String getAttributesOrDefault(
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -982,7 +986,8 @@ public int getAttributesCount() {
      *
      * <pre>
      * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data.
+     * contain non-empty data. This can be used to filter messages on the
+     * subscription.
      * </pre>
      *
      * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -1005,7 +1010,8 @@ public java.util.Map<java.lang.String, java.lang.String> getAttributes() {
      *
      * <pre>
      * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data.
+     * contain non-empty data. This can be used to filter messages on the
+     * subscription.
      * </pre>
      *
      * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -1019,7 +1025,8 @@ public java.util.Map<java.lang.String, java.lang.String> getAttributesMap() {
      *
      * <pre>
      * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data.
+     * contain non-empty data. This can be used to filter messages on the
+     * subscription.
      * </pre>
      *
      * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -1038,7 +1045,8 @@ public java.lang.String getAttributesOrDefault(
      *
      * <pre>
      * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data.
+     * contain non-empty data. This can be used to filter messages on the
+     * subscription.
      * </pre>
      *
      * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -1064,7 +1072,8 @@ public Builder clearAttributes() {
      *
      * <pre>
      * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data.
+     * contain non-empty data. This can be used to filter messages on the
+     * subscription.
      * </pre>
      *
      * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -1086,7 +1095,8 @@ public java.util.Map<java.lang.String, java.lang.String> getMutableAttributes()
      *
      * <pre>
      * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data.
+     * contain non-empty data. This can be used to filter messages on the
+     * subscription.
      * </pre>
      *
      * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -1106,7 +1116,8 @@ public Builder putAttributes(java.lang.String key, java.lang.String value) {
      *
      * <pre>
      * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data.
+     * contain non-empty data. This can be used to filter messages on the
+     * subscription.
      * </pre>
      *
      * <code>map&lt;string, string&gt; attributes = 2;</code>

diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java
@@ -42,7 +42,8 @@ public interface PubsubMessageOrBuilder
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -53,7 +54,8 @@ public interface PubsubMessageOrBuilder
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -67,7 +69,8 @@ public interface PubsubMessageOrBuilder
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -78,7 +81,8 @@ public interface PubsubMessageOrBuilder
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>
@@ -89,7 +93,8 @@ public interface PubsubMessageOrBuilder
    *
    * <pre>
    * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data.
+   * contain non-empty data. This can be used to filter messages on the
+   * subscription.
    * </pre>
    *
    * <code>map&lt;string, string&gt; attributes = 2;</code>

diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
@@ -733,7 +733,8 @@ public com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuild
    *
    *
    * <pre>
-   * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+   * An expression written in the Pub/Sub [filter
+   * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.
@@ -759,7 +760,8 @@ public java.lang.String getFilter() {
    *
    *
    * <pre>
-   * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+   * An expression written in the Pub/Sub [filter
+   * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.
@@ -2855,7 +2857,8 @@ public com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuild
      *
      *
      * <pre>
-     * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+     * An expression written in the Pub/Sub [filter
+     * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
@@ -2880,7 +2883,8 @@ public java.lang.String getFilter() {
      *
      *
      * <pre>
-     * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+     * An expression written in the Pub/Sub [filter
+     * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
@@ -2905,7 +2909,8 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *
      *
      * <pre>
-     * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+     * An expression written in the Pub/Sub [filter
+     * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
@@ -2929,7 +2934,8 @@ public Builder setFilter(java.lang.String value) {
      *
      *
      * <pre>
-     * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+     * An expression written in the Pub/Sub [filter
+     * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
@@ -2949,7 +2955,8 @@ public Builder clearFilter() {
      *
      *
      * <pre>
-     * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+     * An expression written in the Pub/Sub [filter
+     * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.

diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
@@ -362,7 +362,8 @@ public interface SubscriptionOrBuilder
    *
    *
    * <pre>
-   * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+   * An expression written in the Pub/Sub [filter
+   * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.
@@ -377,7 +378,8 @@ public interface SubscriptionOrBuilder
    *
    *
    * <pre>
-   * An expression written in the Cloud Pub/Sub filter language. If non-empty,
+   * An expression written in the Pub/Sub [filter
+   * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.

diff --git a/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto b/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
@@ -191,7 +191,8 @@ message PubsubMessage {
   bytes data = 1;
 
   // Attributes for this message. If this field is empty, the message must
-  // contain non-empty data.
+  // contain non-empty data. This can be used to filter messages on the
+  // subscription.
   map<string, string> attributes = 2;
 
   // ID of this message, assigned by the server when the message is published.
@@ -700,7 +701,8 @@ message Subscription {
   // value for `expiration_policy.ttl` is 1 day.
   ExpirationPolicy expiration_policy = 11;
 
-  // An expression written in the Cloud Pub/Sub filter language. If non-empty,
+  // An expression written in the Pub/Sub [filter
+  // language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
   // then only `PubsubMessage`s whose `attributes` field matches the filter are
   // delivered on this subscription. If empty, then no messages are filtered
   // out.

diff --git a/synth.metadata b/synth.metadata
@@ -11,8 +11,8 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "86285bbd54fbf9708838219e3422aa47fb8fc0b0",
-        "internalRef": "314795690"
+        "sha": "a19b46e54cc5195557f70ff68f1696d1e3b4702e",
+        "internalRef": "315930680"
       }
     },
     {