From 3fa516496315b882da7ffbbc230a3e69acf08a48 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Fri, 31 Jul 2020 16:04:14 -0700 Subject: [PATCH] docs: remove experimental warning for ordering keys properties. (#297) This PR was generated using Autosynth. :rainbow: Synth log will be available here: https://source.cloud.google.com/results/invocations/6d3f7836-3a4c-492a-9e6c-360f4c2d6fc1/targets - [ ] To automatically regenerate this PR, check this box. PiperOrigin-RevId: 323803770 Source-Link: https://github.com/googleapis/googleapis/commit/706053bbfb3f16ef752e513c2898a1f26cdd8e41 --- .../pubsub/v1/SubscriptionAdminClient.java | 284 +++++++++--------- .../cloud/pubsub/v1/TopicAdminClient.java | 60 ++-- .../com/google/pubsub/v1/PublisherGrpc.java | 56 ++-- .../com/google/pubsub/v1/SubscriberGrpc.java | 260 +++++++--------- .../com/google/pubsub/v1/PubsubMessage.java | 41 +-- .../pubsub/v1/PubsubMessageOrBuilder.java | 6 - .../java/com/google/pubsub/v1/Snapshot.java | 62 ++-- .../google/pubsub/v1/SnapshotOrBuilder.java | 20 +- .../com/google/pubsub/v1/Subscription.java | 36 +-- .../pubsub/v1/SubscriptionOrBuilder.java | 9 +- .../main/java/com/google/pubsub/v1/Topic.java | 44 +-- .../com/google/pubsub/v1/TopicOrBuilder.java | 20 +- .../main/proto/google/pubsub/v1/pubsub.proto | 118 +++----- synth.metadata | 6 +- 14 files changed, 451 insertions(+), 571 deletions(-) diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 2fbd6ff96..b53ef596d 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -197,16 +197,16 @@ public SubscriberStub getStub() { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *

If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *

Sample code: * @@ -265,16 +265,16 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *

If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *

Sample code: * @@ -330,16 +330,16 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *

If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *

Sample code: * @@ -434,16 +434,16 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *

If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *

Sample code: * @@ -1525,10 +1525,10 @@ public final UnaryCallable modifyPushConfigCalla // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the existing snapshots. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -1555,10 +1555,10 @@ public final ListSnapshotsPagedResponse listSnapshots(ProjectName project) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the existing snapshots. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -1582,10 +1582,10 @@ public final ListSnapshotsPagedResponse listSnapshots(String project) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the existing snapshots. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -1610,10 +1610,10 @@ public final ListSnapshotsPagedResponse listSnapshots(ListSnapshotsRequest reque // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the existing snapshots. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -1638,10 +1638,10 @@ public final ListSnapshotsPagedResponse listSnapshots(ListSnapshotsRequest reque // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the existing snapshots. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -1672,19 +1672,18 @@ public final UnaryCallable listSnap // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a snapshot from the requested subscription. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. - * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested - * subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old - * -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is - * returned. See also the `Snapshot.expire_time` field. If the name is not provided in the - * request, the server will assign a random name for this snapshot on the same project as the - * subscription, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Snapshot object. Note that for REST API requests, you must specify a - * name in the request. + * Creates a snapshot from the requested subscription. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. If the snapshot + * already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns + * `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would + * expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the + * `Snapshot.expire_time` field. If the name is not provided in the request, the server will + * assign a random name for this snapshot on the same project as the subscription, conforming to + * the [resource name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The + * generated name is populated in the returned Snapshot object. Note that for REST API requests, + * you must specify a name in the request. * *

Sample code: * @@ -1722,19 +1721,18 @@ public final Snapshot createSnapshot( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a snapshot from the requested subscription. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. - * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested - * subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old - * -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is - * returned. See also the `Snapshot.expire_time` field. If the name is not provided in the - * request, the server will assign a random name for this snapshot on the same project as the - * subscription, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Snapshot object. Note that for REST API requests, you must specify a - * name in the request. + * Creates a snapshot from the requested subscription. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. If the snapshot + * already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns + * `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would + * expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the + * `Snapshot.expire_time` field. If the name is not provided in the request, the server will + * assign a random name for this snapshot on the same project as the subscription, conforming to + * the [resource name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The + * generated name is populated in the returned Snapshot object. Note that for REST API requests, + * you must specify a name in the request. * *

Sample code: * @@ -1768,19 +1766,18 @@ public final Snapshot createSnapshot(String name, String subscription) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a snapshot from the requested subscription. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. - * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested - * subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old - * -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is - * returned. See also the `Snapshot.expire_time` field. If the name is not provided in the - * request, the server will assign a random name for this snapshot on the same project as the - * subscription, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Snapshot object. Note that for REST API requests, you must specify a - * name in the request. + * Creates a snapshot from the requested subscription. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. If the snapshot + * already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns + * `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would + * expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the + * `Snapshot.expire_time` field. If the name is not provided in the request, the server will + * assign a random name for this snapshot on the same project as the subscription, conforming to + * the [resource name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The + * generated name is populated in the returned Snapshot object. Note that for REST API requests, + * you must specify a name in the request. * *

Sample code: * @@ -1805,19 +1802,18 @@ public final Snapshot createSnapshot(CreateSnapshotRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a snapshot from the requested subscription. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. - * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested - * subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old - * -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is - * returned. See also the `Snapshot.expire_time` field. If the name is not provided in the - * request, the server will assign a random name for this snapshot on the same project as the - * subscription, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Snapshot object. Note that for REST API requests, you must specify a - * name in the request. + * Creates a snapshot from the requested subscription. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. If the snapshot + * already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns + * `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would + * expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the + * `Snapshot.expire_time` field. If the name is not provided in the request, the server will + * assign a random name for this snapshot on the same project as the subscription, conforming to + * the [resource name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The + * generated name is populated in the returned Snapshot object. Note that for REST API requests, + * you must specify a name in the request. * *

Sample code: * @@ -1916,14 +1912,13 @@ public final UnaryCallable updateSnapshotCallab // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Removes an existing snapshot. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a - * snapshot.<br><br> When the snapshot is deleted, all messages retained in the - * snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with - * the same name, but the new one has no association with the old snapshot or its subscription, - * unless the same subscription is specified. + * Removes an existing snapshot. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all + * messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new + * one may be created with the same name, but the new one has no association with the old snapshot + * or its subscription, unless the same subscription is specified. * *

Sample code: * @@ -1948,14 +1943,13 @@ public final void deleteSnapshot(ProjectSnapshotName snapshot) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Removes an existing snapshot. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a - * snapshot.<br><br> When the snapshot is deleted, all messages retained in the - * snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with - * the same name, but the new one has no association with the old snapshot or its subscription, - * unless the same subscription is specified. + * Removes an existing snapshot. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all + * messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new + * one may be created with the same name, but the new one has no association with the old snapshot + * or its subscription, unless the same subscription is specified. * *

Sample code: * @@ -1978,14 +1972,13 @@ public final void deleteSnapshot(String snapshot) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Removes an existing snapshot. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a - * snapshot.<br><br> When the snapshot is deleted, all messages retained in the - * snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with - * the same name, but the new one has no association with the old snapshot or its subscription, - * unless the same subscription is specified. + * Removes an existing snapshot. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all + * messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new + * one may be created with the same name, but the new one has no association with the old snapshot + * or its subscription, unless the same subscription is specified. * *

Sample code: * @@ -2008,14 +2001,13 @@ public final void deleteSnapshot(DeleteSnapshotRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Removes an existing snapshot. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a - * snapshot.<br><br> When the snapshot is deleted, all messages retained in the - * snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with - * the same name, but the new one has no association with the old snapshot or its subscription, - * unless the same subscription is specified. + * Removes an existing snapshot. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all + * messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new + * one may be created with the same name, but the new one has no association with the old snapshot + * or its subscription, unless the same subscription is specified. * *

Sample code: * @@ -2038,11 +2030,11 @@ public final UnaryCallable deleteSnapshotCallable( // AUTO-GENERATED DOCUMENTATION AND METHOD /** * Seeks an existing subscription to a point in time or to a given snapshot, whichever is provided - * in the request. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. Note that - * both the subscription and the snapshot must be on the same topic. + * in the request. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. Note that both the subscription + * and the snapshot must be on the same topic. * *

Sample code: * @@ -2066,11 +2058,11 @@ public final SeekResponse seek(SeekRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** * Seeks an existing subscription to a point in time or to a given snapshot, whichever is provided - * in the request. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. Note that - * both the subscription and the snapshot must be on the same topic. + * in the request. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage + * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in + * an existing subscription to the state captured by a snapshot. Note that both the subscription + * and the snapshot must be on the same topic. * *

Sample code: * diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java index 1d1096550..482969622 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -182,9 +182,8 @@ public PublisherStub getStub() { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates the given topic with the given name. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. + * Creates the given topic with the given name. See the [resource name rules]( + * https://cloud.google.com/pubsub/docs/admin#resource_names). * *

Sample code: * @@ -209,9 +208,8 @@ public final Topic createTopic(TopicName name) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates the given topic with the given name. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. + * Creates the given topic with the given name. See the [resource name rules]( + * https://cloud.google.com/pubsub/docs/admin#resource_names). * *

Sample code: * @@ -264,9 +262,8 @@ public final Topic createTopic(ProjectTopicName name) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates the given topic with the given name. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. + * Creates the given topic with the given name. See the [resource name rules]( + * https://cloud.google.com/pubsub/docs/admin#resource_names). * *

Sample code: * @@ -289,9 +286,8 @@ public final Topic createTopic(Topic request) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates the given topic with the given name. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. + * Creates the given topic with the given name. See the [resource name rules]( + * https://cloud.google.com/pubsub/docs/admin#resource_names). * *

Sample code: * @@ -889,10 +885,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the names of the snapshots on this topic. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -919,10 +915,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the names of the snapshots on this topic. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -947,10 +943,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the names of the snapshots on this topic. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -976,10 +972,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the names of the snapshots on this topic. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: * @@ -1005,10 +1001,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Lists the names of the snapshots on this topic. Snapshots are used in <a - * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment - * state of messages in an existing subscription to the state captured by a snapshot. + * Lists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to + * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: * diff --git a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java index 8ddccd07f..d1e85d8f4 100644 --- a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java +++ b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java @@ -468,9 +468,8 @@ public abstract static class PublisherImplBase implements io.grpc.BindableServic * * * 

-     * Creates the given topic with the given name. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates the given topic with the given name. See the [resource name rules](
+     * https://cloud.google.com/pubsub/docs/admin#resource_names).
      *
*/ public void createTopic( @@ -552,11 +551,10 @@ public void listTopicSubscriptions( * * 
      * Lists the names of the snapshots on this topic. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
+     * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+     * which allow you to manage message acknowledgments in bulk. That is, you can
+     * set the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      *
*/ public void listTopicSnapshots( @@ -685,9 +683,8 @@ protected PublisherStub build(io.grpc.Channel channel, io.grpc.CallOptions callO * * * 
-     * Creates the given topic with the given name. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates the given topic with the given name. See the [resource name rules](
+     * https://cloud.google.com/pubsub/docs/admin#resource_names).
      *
*/ public void createTopic( @@ -781,11 +778,10 @@ public void listTopicSubscriptions( * * 
      * Lists the names of the snapshots on this topic. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
+     * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+     * which allow you to manage message acknowledgments in bulk. That is, you can
+     * set the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      *
*/ public void listTopicSnapshots( @@ -863,9 +859,8 @@ protected PublisherBlockingStub build( * * * 
-     * Creates the given topic with the given name. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates the given topic with the given name. See the [resource name rules](
+     * https://cloud.google.com/pubsub/docs/admin#resource_names).
      *
*/ public com.google.pubsub.v1.Topic createTopic(com.google.pubsub.v1.Topic request) { @@ -938,11 +933,10 @@ public com.google.pubsub.v1.ListTopicSubscriptionsResponse listTopicSubscription * * 
      * Lists the names of the snapshots on this topic. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
+     * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+     * which allow you to manage message acknowledgments in bulk. That is, you can
+     * set the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      *
*/ public com.google.pubsub.v1.ListTopicSnapshotsResponse listTopicSnapshots( @@ -1006,9 +1000,8 @@ protected PublisherFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions * * * 
-     * Creates the given topic with the given name. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates the given topic with the given name. See the [resource name rules](
+     * https://cloud.google.com/pubsub/docs/admin#resource_names).
      *
*/ public com.google.common.util.concurrent.ListenableFuture @@ -1089,11 +1082,10 @@ public com.google.common.util.concurrent.ListenableFuture * Lists the names of the snapshots on this topic. Snapshots are used in - * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> - * operations, which allow - * you to manage message acknowledgments in bulk. That is, you can set the - * acknowledgment state of messages in an existing subscription to the state - * captured by a snapshot. + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + * which allow you to manage message acknowledgments in bulk. That is, you can + * set the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. * */ public com.google.common.util.concurrent.ListenableFuture< diff --git a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java index 6983f25d6..37ba4c003 100644 --- a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java +++ b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java @@ -748,18 +748,16 @@ public abstract static class SubscriberImplBase implements io.grpc.BindableServi * * * 
-     * Creates a subscription to a given topic. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates a subscription to a given topic. See the [resource name rules]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names).
      * If the subscription already exists, returns `ALREADY_EXISTS`.
      * If the corresponding topic doesn't exist, returns `NOT_FOUND`.
      * If the name is not provided in the request, the server will assign a random
      * name for this subscription on the same project as the topic, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
-     * generated name is populated in the returned Subscription object. Note that
-     * for REST API requests, you must specify a name in the request.
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+     * name is populated in the returned Subscription object. Note that for REST
+     * API requests, you must specify a name in the request.
      *
*/ public void createSubscription( @@ -932,12 +930,11 @@ public void getSnapshot( * * * 
-     * Lists the existing snapshots. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
+     * Lists the existing snapshots. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      *
*/ public void listSnapshots( @@ -951,21 +948,19 @@ public void listSnapshots( * * 
      * Creates a snapshot from the requested subscription. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
-     * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+     * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+     * which allow you to manage message acknowledgments in bulk. That is, you can
+     * set the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
+     * If the snapshot already exists, returns `ALREADY_EXISTS`.
      * If the requested subscription doesn't exist, returns `NOT_FOUND`.
      * If the backlog in the subscription is too old -- and the resulting snapshot
      * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
      * See also the `Snapshot.expire_time` field. If the name is not provided in
      * the request, the server will assign a random
      * name for this snapshot on the same project as the subscription, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
      * generated name is populated in the returned Snapshot object. Note that for
      * REST API requests, you must specify a name in the request.
      *
@@ -998,12 +993,11 @@ public void updateSnapshot( * * * 
-     * Removes an existing snapshot. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.<br><br>
+     * Removes an existing snapshot. Snapshots are used in [Seek]
+     * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      * When the snapshot is deleted, all messages retained in the snapshot
      * are immediately dropped. After a snapshot is deleted, a new one may be
      * created with the same name, but the new one has no association with the old
@@ -1021,13 +1015,12 @@ public void deleteSnapshot(
      *
      * 
      * Seeks an existing subscription to a point in time or to a given snapshot,
-     * whichever is provided in the request. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot. Note that both the subscription and the snapshot
-     * must be on the same topic.
+     * whichever is provided in the request. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot. Note that both the subscription and the
+     * snapshot must be on the same topic.
      * 

      */
     public void seek(
@@ -1163,18 +1156,16 @@ protected SubscriberStub build(io.grpc.Channel channel, io.grpc.CallOptions call
      *
      *
      * 
-     * Creates a subscription to a given topic. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates a subscription to a given topic. See the [resource name rules]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names).
      * If the subscription already exists, returns `ALREADY_EXISTS`.
      * If the corresponding topic doesn't exist, returns `NOT_FOUND`.
      * If the name is not provided in the request, the server will assign a random
      * name for this subscription on the same project as the topic, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
-     * generated name is populated in the returned Subscription object. Note that
-     * for REST API requests, you must specify a name in the request.
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+     * name is populated in the returned Subscription object. Note that for REST
+     * API requests, you must specify a name in the request.
      * 

      */
     public void createSubscription(
@@ -1376,12 +1367,11 @@ public void getSnapshot(
      *
      *
      * 
-     * Lists the existing snapshots. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
+     * Lists the existing snapshots. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      * 

      */
     public void listSnapshots(
@@ -1398,21 +1388,19 @@ public void listSnapshots(
      *
      * 
      * Creates a snapshot from the requested subscription. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
-     * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+     * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+     * which allow you to manage message acknowledgments in bulk. That is, you can
+     * set the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
+     * If the snapshot already exists, returns `ALREADY_EXISTS`.
      * If the requested subscription doesn't exist, returns `NOT_FOUND`.
      * If the backlog in the subscription is too old -- and the resulting snapshot
      * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
      * See also the `Snapshot.expire_time` field. If the name is not provided in
      * the request, the server will assign a random
      * name for this snapshot on the same project as the subscription, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
      * generated name is populated in the returned Snapshot object. Note that for
      * REST API requests, you must specify a name in the request.
      * 

@@ -1451,12 +1439,11 @@ public void updateSnapshot(
      *
      *
      * 
-     * Removes an existing snapshot. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.<br><br>
+     * Removes an existing snapshot. Snapshots are used in [Seek]
+     * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      * When the snapshot is deleted, all messages retained in the snapshot
      * are immediately dropped. After a snapshot is deleted, a new one may be
      * created with the same name, but the new one has no association with the old
@@ -1477,13 +1464,12 @@ public void deleteSnapshot(
      *
      * 
      * Seeks an existing subscription to a point in time or to a given snapshot,
-     * whichever is provided in the request. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot. Note that both the subscription and the snapshot
-     * must be on the same topic.
+     * whichever is provided in the request. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot. Note that both the subscription and the
+     * snapshot must be on the same topic.
      * 

      */
     public void seek(
@@ -1519,18 +1505,16 @@ protected SubscriberBlockingStub build(
      *
      *
      * 
-     * Creates a subscription to a given topic. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates a subscription to a given topic. See the [resource name rules]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names).
      * If the subscription already exists, returns `ALREADY_EXISTS`.
      * If the corresponding topic doesn't exist, returns `NOT_FOUND`.
      * If the name is not provided in the request, the server will assign a random
      * name for this subscription on the same project as the topic, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
-     * generated name is populated in the returned Subscription object. Note that
-     * for REST API requests, you must specify a name in the request.
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+     * name is populated in the returned Subscription object. Note that for REST
+     * API requests, you must specify a name in the request.
      * 

      */
     public com.google.pubsub.v1.Subscription createSubscription(
@@ -1678,12 +1662,11 @@ public com.google.pubsub.v1.Snapshot getSnapshot(
      *
      *
      * 
-     * Lists the existing snapshots. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
+     * Lists the existing snapshots. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      * 

      */
     public com.google.pubsub.v1.ListSnapshotsResponse listSnapshots(
@@ -1696,21 +1679,19 @@ public com.google.pubsub.v1.ListSnapshotsResponse listSnapshots(
      *
      * 
      * Creates a snapshot from the requested subscription. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
-     * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+     * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+     * which allow you to manage message acknowledgments in bulk. That is, you can
+     * set the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
+     * If the snapshot already exists, returns `ALREADY_EXISTS`.
      * If the requested subscription doesn't exist, returns `NOT_FOUND`.
      * If the backlog in the subscription is too old -- and the resulting snapshot
      * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
      * See also the `Snapshot.expire_time` field. If the name is not provided in
      * the request, the server will assign a random
      * name for this snapshot on the same project as the subscription, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
      * generated name is populated in the returned Snapshot object. Note that for
      * REST API requests, you must specify a name in the request.
      * 

@@ -1741,12 +1722,11 @@ public com.google.pubsub.v1.Snapshot updateSnapshot(
      *
      *
      * 
-     * Removes an existing snapshot. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.<br><br>
+     * Removes an existing snapshot. Snapshots are used in [Seek]
+     * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      * When the snapshot is deleted, all messages retained in the snapshot
      * are immediately dropped. After a snapshot is deleted, a new one may be
      * created with the same name, but the new one has no association with the old
@@ -1763,13 +1743,12 @@ public com.google.protobuf.Empty deleteSnapshot(
      *
      * 
      * Seeks an existing subscription to a point in time or to a given snapshot,
-     * whichever is provided in the request. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot. Note that both the subscription and the snapshot
-     * must be on the same topic.
+     * whichever is provided in the request. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot. Note that both the subscription and the
+     * snapshot must be on the same topic.
      * 

      */
     public com.google.pubsub.v1.SeekResponse seek(com.google.pubsub.v1.SeekRequest request) {
@@ -1801,18 +1780,16 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
      *
      *
      * 
-     * Creates a subscription to a given topic. See the
-     * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-     * resource name rules</a>.
+     * Creates a subscription to a given topic. See the [resource name rules]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names).
      * If the subscription already exists, returns `ALREADY_EXISTS`.
      * If the corresponding topic doesn't exist, returns `NOT_FOUND`.
      * If the name is not provided in the request, the server will assign a random
      * name for this subscription on the same project as the topic, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
-     * generated name is populated in the returned Subscription object. Note that
-     * for REST API requests, you must specify a name in the request.
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+     * name is populated in the returned Subscription object. Note that for REST
+     * API requests, you must specify a name in the request.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1966,12 +1943,11 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
      *
      *
      * 
-     * Lists the existing snapshots. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
+     * Lists the existing snapshots. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -1986,21 +1962,19 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
      *
      * 
      * Creates a snapshot from the requested subscription. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.
-     * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+     * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+     * which allow you to manage message acknowledgments in bulk. That is, you can
+     * set the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
+     * If the snapshot already exists, returns `ALREADY_EXISTS`.
      * If the requested subscription doesn't exist, returns `NOT_FOUND`.
      * If the backlog in the subscription is too old -- and the resulting snapshot
      * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
      * See also the `Snapshot.expire_time` field. If the name is not provided in
      * the request, the server will assign a random
      * name for this snapshot on the same project as the subscription, conforming
-     * to the
-     * [resource name
-     * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+     * to the [resource name format]
+     * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
      * generated name is populated in the returned Snapshot object. Note that for
      * REST API requests, you must specify a name in the request.
      * 

@@ -2033,12 +2007,11 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
      *
      *
      * 
-     * Removes an existing snapshot. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot.<br><br>
+     * Removes an existing snapshot. Snapshots are used in [Seek]
+     * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot.
      * When the snapshot is deleted, all messages retained in the snapshot
      * are immediately dropped. After a snapshot is deleted, a new one may be
      * created with the same name, but the new one has no association with the old
@@ -2056,13 +2029,12 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
      *
      * 
      * Seeks an existing subscription to a point in time or to a given snapshot,
-     * whichever is provided in the request. Snapshots are used in
-     * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-     * operations, which allow
-     * you to manage message acknowledgments in bulk. That is, you can set the
-     * acknowledgment state of messages in an existing subscription to the state
-     * captured by a snapshot. Note that both the subscription and the snapshot
-     * must be on the same topic.
+     * whichever is provided in the request. Snapshots are used in [Seek](
+     * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+     * allow you to manage message acknowledgments in bulk. That is, you can set
+     * the acknowledgment state of messages in an existing subscription to the
+     * state captured by a snapshot. Note that both the subscription and the
+     * snapshot must be on the same topic.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
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
index 75f6b6f2e..297538098 100644
--- 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
@@ -25,11 +25,11 @@
  * A message that is published by publishers and consumed by subscribers. The
  * message must contain either a non-empty data field or at least one attribute.
  * Note that client libraries represent this object differently
- * depending on the language. See the corresponding
- * <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
- * library documentation</a> for more information. See
- * <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
- * for more information about message limits.
+ * depending on the language. See the corresponding [client library
+ * documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
+ * more information. See [quotas and limits]
+ * (https://cloud.google.com/pubsub/quotas) for more information about message
+ * limits.
  * 

  *
  * Protobuf type {@code google.pubsub.v1.PubsubMessage}
@@ -419,9 +419,6 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
    * delivered to subscribers in the order in which they are received by the
    * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
    * must specify the same `ordering_key` value.
-   * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
-   * API might be changed in backward-incompatible ways and is not recommended
-   * for production use. It is not subject to any SLA or deprecation policy.
    * 

    *
    * string ordering_key = 5;
@@ -450,9 +447,6 @@ public java.lang.String getOrderingKey() {
    * delivered to subscribers in the order in which they are received by the
    * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
    * must specify the same `ordering_key` value.
-   * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
-   * API might be changed in backward-incompatible ways and is not recommended
-   * for production use. It is not subject to any SLA or deprecation policy.
    * 

    *
    * string ordering_key = 5;
@@ -685,11 +679,11 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    * A message that is published by publishers and consumed by subscribers. The
    * message must contain either a non-empty data field or at least one attribute.
    * Note that client libraries represent this object differently
-   * depending on the language. See the corresponding
-   * <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
-   * library documentation</a> for more information. See
-   * <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
-   * for more information about message limits.
+   * depending on the language. See the corresponding [client library
+   * documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
+   * more information. See [quotas and limits]
+   * (https://cloud.google.com/pubsub/quotas) for more information about message
+   * limits.
    *
* * Protobuf type {@code google.pubsub.v1.PubsubMessage} @@ -1462,9 +1456,6 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() { * delivered to subscribers in the order in which they are received by the * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` * must specify the same `ordering_key` value. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * string ordering_key = 5; @@ -1492,9 +1483,6 @@ public java.lang.String getOrderingKey() { * delivered to subscribers in the order in which they are received by the * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` * must specify the same `ordering_key` value. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * string ordering_key = 5; @@ -1522,9 +1510,6 @@ public com.google.protobuf.ByteString getOrderingKeyBytes() { * delivered to subscribers in the order in which they are received by the * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` * must specify the same `ordering_key` value. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * string ordering_key = 5; @@ -1551,9 +1536,6 @@ public Builder setOrderingKey(java.lang.String value) { * delivered to subscribers in the order in which they are received by the * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` * must specify the same `ordering_key` value. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * string ordering_key = 5; @@ -1576,9 +1558,6 @@ public Builder clearOrderingKey() { * delivered to subscribers in the order in which they are received by the * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` * must specify the same `ordering_key` value. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * string ordering_key = 5; 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 index dfe2dcf0c..a81cdd8e2 100644 --- 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 @@ -183,9 +183,6 @@ public interface PubsubMessageOrBuilder * delivered to subscribers in the order in which they are received by the * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` * must specify the same `ordering_key` value. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * string ordering_key = 5; @@ -203,9 +200,6 @@ public interface PubsubMessageOrBuilder * delivered to subscribers in the order in which they are received by the * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` * must specify the same `ordering_key` value. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * string ordering_key = 5; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java index 6d6000105..7097a40b5 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java @@ -23,11 +23,10 @@ * * 
  * A snapshot resource. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+ * operations, which allow you to manage message acknowledgments in bulk. That
+ * is, you can set the acknowledgment state of messages in an existing
+ * subscription to the state captured by a snapshot.
  *
* * Protobuf type {@code google.pubsub.v1.Snapshot} @@ -362,8 +361,8 @@ public int getLabelsCount() { * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -385,8 +384,8 @@ public java.util.Map getLabels() { * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -399,8 +398,8 @@ public java.util.Map getLabelsMap() { * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -417,8 +416,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -637,11 +636,10 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * 
    * A snapshot resource. Snapshots are used in
-   * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-   * operations, which allow
-   * you to manage message acknowledgments in bulk. That is, you can set the
-   * acknowledgment state of messages in an existing subscription to the state
-   * captured by a snapshot.
+   * [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+   * operations, which allow you to manage message acknowledgments in bulk. That
+   * is, you can set the acknowledgment state of messages in an existing
+   * subscription to the state captured by a snapshot.
    *
* * Protobuf type {@code google.pubsub.v1.Snapshot} @@ -1343,8 +1341,8 @@ public int getLabelsCount() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 4; @@ -1366,8 +1364,8 @@ public java.util.Map getLabels() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 4; @@ -1380,8 +1378,8 @@ public java.util.Map getLabelsMap() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 4; @@ -1399,8 +1397,8 @@ public java.lang.String getLabelsOrDefault( * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 4; @@ -1425,8 +1423,8 @@ public Builder clearLabels() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 4; @@ -1447,8 +1445,8 @@ public java.util.Map getMutableLabels() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 4; @@ -1467,8 +1465,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 4; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java index 9ef1ef752..c8d3ed3ad 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java @@ -139,8 +139,8 @@ public interface SnapshotOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -150,8 +150,8 @@ public interface SnapshotOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -164,8 +164,8 @@ public interface SnapshotOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -175,8 +175,8 @@ public interface SnapshotOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; @@ -186,8 +186,8 @@ public interface SnapshotOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 4; 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 index 01a1c6fe5..3b1afd152 100644 --- 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 @@ -460,10 +460,8 @@ public int getAckDeadlineSeconds() { * Indicates whether to retain acknowledged messages. If true, then * messages are not expunged from the subscription's backlog, even if they are * acknowledged, until they fall out of the `message_retention_duration` - * window. This must be true if you would like to - * <a - * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time"> - * Seek to a timestamp</a>. + * window. This must be true if you would like to [Seek to a timestamp] + * (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time). * * * bool retain_acked_messages = 7; @@ -650,9 +648,6 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) { * will be delivered to the subscribers in the order in which they * are received by the Pub/Sub system. Otherwise, they may be delivered in * any order. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * bool enable_message_ordering = 10; @@ -2094,10 +2089,8 @@ public Builder clearAckDeadlineSeconds() { * Indicates whether to retain acknowledged messages. If true, then * messages are not expunged from the subscription's backlog, even if they are * acknowledged, until they fall out of the `message_retention_duration` - * window. This must be true if you would like to - * <a - * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time"> - * Seek to a timestamp</a>. + * window. This must be true if you would like to [Seek to a timestamp] + * (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time). * * * bool retain_acked_messages = 7; @@ -2115,10 +2108,8 @@ public boolean getRetainAckedMessages() { * Indicates whether to retain acknowledged messages. If true, then * messages are not expunged from the subscription's backlog, even if they are * acknowledged, until they fall out of the `message_retention_duration` - * window. This must be true if you would like to - * <a - * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time"> - * Seek to a timestamp</a>. + * window. This must be true if you would like to [Seek to a timestamp] + * (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time). * * * bool retain_acked_messages = 7; @@ -2139,10 +2130,8 @@ public Builder setRetainAckedMessages(boolean value) { * Indicates whether to retain acknowledged messages. If true, then * messages are not expunged from the subscription's backlog, even if they are * acknowledged, until they fall out of the `message_retention_duration` - * window. This must be true if you would like to - * <a - * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time"> - * Seek to a timestamp</a>. + * window. This must be true if you would like to [Seek to a timestamp] + * (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time). * * * bool retain_acked_messages = 7; @@ -2560,9 +2549,6 @@ public Builder putAllLabels(java.util.Map va * will be delivered to the subscribers in the order in which they * are received by the Pub/Sub system. Otherwise, they may be delivered in * any order. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * bool enable_message_ordering = 10; @@ -2581,9 +2567,6 @@ public boolean getEnableMessageOrdering() { * will be delivered to the subscribers in the order in which they * are received by the Pub/Sub system. Otherwise, they may be delivered in * any order. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * bool enable_message_ordering = 10; @@ -2605,9 +2588,6 @@ public Builder setEnableMessageOrdering(boolean value) { * will be delivered to the subscribers in the order in which they * are received by the Pub/Sub system. Otherwise, they may be delivered in * any order. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * bool enable_message_ordering = 10; 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 index f7d1714d1..e19141cb0 100644 --- 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 @@ -168,10 +168,8 @@ public interface SubscriptionOrBuilder * Indicates whether to retain acknowledged messages. If true, then * messages are not expunged from the subscription's backlog, even if they are * acknowledged, until they fall out of the `message_retention_duration` - * window. This must be true if you would like to - * <a - * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time"> - * Seek to a timestamp</a>. + * window. This must be true if you would like to [Seek to a timestamp] + * (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time). * * * bool retain_acked_messages = 7; @@ -297,9 +295,6 @@ public interface SubscriptionOrBuilder * will be delivered to the subscribers in the order in which they * are received by the Pub/Sub system. Otherwise, they may be delivered in * any order. - * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This - * API might be changed in backward-incompatible ways and is not recommended - * for production use. It is not subject to any SLA or deprecation policy. * * * bool enable_message_ordering = 10; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java index 5df76aa71..18db5a187 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java @@ -246,8 +246,8 @@ public int getLabelsCount() { * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -269,8 +269,8 @@ public java.util.Map getLabels() { * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -283,8 +283,8 @@ public java.util.Map getLabelsMap() { * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -301,8 +301,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -985,8 +985,8 @@ public int getLabelsCount() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 2; @@ -1008,8 +1008,8 @@ public java.util.Map getLabels() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 2; @@ -1022,8 +1022,8 @@ public java.util.Map getLabelsMap() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 2; @@ -1041,8 +1041,8 @@ public java.lang.String getLabelsOrDefault( * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 2; @@ -1067,8 +1067,8 @@ public Builder clearLabels() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 2; @@ -1089,8 +1089,8 @@ public java.util.Map getMutableLabels() { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 2; @@ -1109,8 +1109,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) { * * * 
-     * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-     * managing labels</a>.
+     * See [Creating and managing labels]
+     * (https://cloud.google.com/pubsub/docs/labels).
      *
* * map<string, string> labels = 2; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java index 1e1338b11..a11846480 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java @@ -62,8 +62,8 @@ public interface TopicOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -73,8 +73,8 @@ public interface TopicOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -87,8 +87,8 @@ public interface TopicOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -98,8 +98,8 @@ public interface TopicOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; @@ -109,8 +109,8 @@ public interface TopicOrBuilder * * * 
-   * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-   * managing labels</a>.
+   * See [Creating and managing labels]
+   * (https://cloud.google.com/pubsub/docs/labels).
    *
* * map<string, string> labels = 2; 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 index dc9151446..909863eb9 100644 --- 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 @@ -42,9 +42,8 @@ service Publisher { "https://www.googleapis.com/auth/cloud-platform," "https://www.googleapis.com/auth/pubsub"; - // Creates the given topic with the given name. See the - // - // resource name rules. + // Creates the given topic with the given name. See the [resource name rules]( + // https://cloud.google.com/pubsub/docs/admin#resource_names). rpc CreateTopic(Topic) returns (Topic) { option (google.api.http) = { put: "/v1/{name=projects/*/topics/*}" @@ -98,11 +97,10 @@ service Publisher { } // Lists the names of the snapshots on this topic. Snapshots are used in - // Seek - // operations, which allow - // you to manage message acknowledgments in bulk. That is, you can set the - // acknowledgment state of messages in an existing subscription to the state - // captured by a snapshot. + // [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + // which allow you to manage message acknowledgments in bulk. That is, you can + // set the acknowledgment state of messages in an existing subscription to the + // state captured by a snapshot. rpc ListTopicSnapshots(ListTopicSnapshotsRequest) returns (ListTopicSnapshotsResponse) { option (google.api.http) = { @@ -161,8 +159,8 @@ message Topic { // must not start with `"goog"`. string name = 1 [(google.api.field_behavior) = REQUIRED]; - // See Creating and - // managing labels. + // See [Creating and managing labels] + // (https://cloud.google.com/pubsub/docs/labels). map labels = 2; // Policy constraining the set of Google Cloud Platform regions where messages @@ -180,11 +178,11 @@ message Topic { // A message that is published by publishers and consumed by subscribers. The // message must contain either a non-empty data field or at least one attribute. // Note that client libraries represent this object differently -// depending on the language. See the corresponding -// client -// library documentation for more information. See -// Quotas and limits -// for more information about message limits. +// depending on the language. See the corresponding [client library +// documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for +// more information. See [quotas and limits] +// (https://cloud.google.com/pubsub/quotas) for more information about message +// limits. message PubsubMessage { // The message data field. If this field is empty, the message must contain // at least one attribute. @@ -212,9 +210,6 @@ message PubsubMessage { // delivered to subscribers in the order in which they are received by the // Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` // must specify the same `ordering_key` value. - // EXPERIMENTAL: This feature is part of a closed alpha release. This - // API might be changed in backward-incompatible ways and is not recommended - // for production use. It is not subject to any SLA or deprecation policy. string ordering_key = 5; } @@ -388,19 +383,17 @@ service Subscriber { "https://www.googleapis.com/auth/cloud-platform," "https://www.googleapis.com/auth/pubsub"; - // Creates a subscription to a given topic. See the - // - // resource name rules. + // Creates a subscription to a given topic. See the [resource name rules] + // (https://cloud.google.com/pubsub/docs/admin#resource_names). // If the subscription already exists, returns `ALREADY_EXISTS`. // If the corresponding topic doesn't exist, returns `NOT_FOUND`. // // If the name is not provided in the request, the server will assign a random // name for this subscription on the same project as the topic, conforming - // to the - // [resource name - // format](https://cloud.google.com/pubsub/docs/admin#resource_names). The - // generated name is populated in the returned Subscription object. Note that - // for REST API requests, you must specify a name in the request. + // to the [resource name format] + // (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated + // name is populated in the returned Subscription object. Note that for REST + // API requests, you must specify a name in the request. rpc CreateSubscription(Subscription) returns (Subscription) { option (google.api.http) = { put: "/v1/{name=projects/*/subscriptions/*}" @@ -528,12 +521,11 @@ service Subscriber { option (google.api.method_signature) = "snapshot"; } - // Lists the existing snapshots. Snapshots are used in - // Seek - // operations, which allow - // you to manage message acknowledgments in bulk. That is, you can set the - // acknowledgment state of messages in an existing subscription to the state - // captured by a snapshot. + // Lists the existing snapshots. Snapshots are used in [Seek]( + // https://cloud.google.com/pubsub/docs/replay-overview) operations, which + // allow you to manage message acknowledgments in bulk. That is, you can set + // the acknowledgment state of messages in an existing subscription to the + // state captured by a snapshot. rpc ListSnapshots(ListSnapshotsRequest) returns (ListSnapshotsResponse) { option (google.api.http) = { get: "/v1/{project=projects/*}/snapshots" @@ -542,21 +534,19 @@ service Subscriber { } // Creates a snapshot from the requested subscription. Snapshots are used in - // Seek - // operations, which allow - // you to manage message acknowledgments in bulk. That is, you can set the - // acknowledgment state of messages in an existing subscription to the state - // captured by a snapshot. - //

If the snapshot already exists, returns `ALREADY_EXISTS`. + // [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + // which allow you to manage message acknowledgments in bulk. That is, you can + // set the acknowledgment state of messages in an existing subscription to the + // state captured by a snapshot. + // If the snapshot already exists, returns `ALREADY_EXISTS`. // If the requested subscription doesn't exist, returns `NOT_FOUND`. // If the backlog in the subscription is too old -- and the resulting snapshot // would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. // See also the `Snapshot.expire_time` field. If the name is not provided in // the request, the server will assign a random // name for this snapshot on the same project as the subscription, conforming - // to the - // [resource name - // format](https://cloud.google.com/pubsub/docs/admin#resource_names). The + // to the [resource name format] + // (https://cloud.google.com/pubsub/docs/admin#resource_names). The // generated name is populated in the returned Snapshot object. Note that for // REST API requests, you must specify a name in the request. rpc CreateSnapshot(CreateSnapshotRequest) returns (Snapshot) { @@ -580,12 +570,11 @@ service Subscriber { }; } - // Removes an existing snapshot. Snapshots are used in - // Seek - // operations, which allow - // you to manage message acknowledgments in bulk. That is, you can set the - // acknowledgment state of messages in an existing subscription to the state - // captured by a snapshot.

+ // Removes an existing snapshot. Snapshots are used in [Seek] + // (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + // allow you to manage message acknowledgments in bulk. That is, you can set + // the acknowledgment state of messages in an existing subscription to the + // state captured by a snapshot. // When the snapshot is deleted, all messages retained in the snapshot // are immediately dropped. After a snapshot is deleted, a new one may be // created with the same name, but the new one has no association with the old @@ -598,13 +587,12 @@ service Subscriber { } // Seeks an existing subscription to a point in time or to a given snapshot, - // whichever is provided in the request. Snapshots are used in - // Seek - // operations, which allow - // you to manage message acknowledgments in bulk. That is, you can set the - // acknowledgment state of messages in an existing subscription to the state - // captured by a snapshot. Note that both the subscription and the snapshot - // must be on the same topic. + // whichever is provided in the request. Snapshots are used in [Seek]( + // https://cloud.google.com/pubsub/docs/replay-overview) operations, which + // allow you to manage message acknowledgments in bulk. That is, you can set + // the acknowledgment state of messages in an existing subscription to the + // state captured by a snapshot. Note that both the subscription and the + // snapshot must be on the same topic. rpc Seek(SeekRequest) returns (SeekResponse) { option (google.api.http) = { post: "/v1/{subscription=projects/*/subscriptions/*}:seek" @@ -666,10 +654,8 @@ message Subscription { // Indicates whether to retain acknowledged messages. If true, then // messages are not expunged from the subscription's backlog, even if they are // acknowledged, until they fall out of the `message_retention_duration` - // window. This must be true if you would like to - // - // Seek to a timestamp. + // window. This must be true if you would like to [Seek to a timestamp] + // (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time). bool retain_acked_messages = 7; // How long to retain unacknowledged messages in the subscription's backlog, @@ -688,9 +674,6 @@ message Subscription { // will be delivered to the subscribers in the order in which they // are received by the Pub/Sub system. Otherwise, they may be delivered in // any order. - // EXPERIMENTAL: This feature is part of a closed alpha release. This - // API might be changed in backward-incompatible ways and is not recommended - // for production use. It is not subject to any SLA or deprecation policy. bool enable_message_ordering = 10; // A policy that specifies the conditions for this subscription's expiration. @@ -1186,11 +1169,10 @@ message UpdateSnapshotRequest { } // A snapshot resource. Snapshots are used in -// Seek -// operations, which allow -// you to manage message acknowledgments in bulk. That is, you can set the -// acknowledgment state of messages in an existing subscription to the state -// captured by a snapshot. +// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) +// operations, which allow you to manage message acknowledgments in bulk. That +// is, you can set the acknowledgment state of messages in an existing +// subscription to the state captured by a snapshot. message Snapshot { option (google.api.resource) = { type: "pubsub.googleapis.com/Snapshot" @@ -1217,8 +1199,8 @@ message Snapshot { // snapshot that would expire in less than 1 hour after creation. google.protobuf.Timestamp expire_time = 3; - // See Creating and - // managing labels. + // See [Creating and managing labels] + // (https://cloud.google.com/pubsub/docs/labels). map labels = 4; } diff --git a/synth.metadata b/synth.metadata index 80fab3945..7f7e499fa 100644 --- a/synth.metadata +++ b/synth.metadata @@ -4,15 +4,15 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-pubsub.git", - "sha": "a820ab8f30c3c4c40cc321ec5350ebb463769d32" + "sha": "7e712b220dde56fa160385bfb532cad85d14dd8d" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "14f0c2cc9392234707247ab2b0782c118cb179aa", - "internalRef": "317914250" + "sha": "706053bbfb3f16ef752e513c2898a1f26cdd8e41", + "internalRef": "323803770" } }, {