* Creates the given topic with the given name. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
*
*/
public void createTopic(
@@ -543,8 +544,13 @@ public void listTopicSubscriptions(
*
*
*
- * Lists the names of the snapshots on this topic.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -656,7 +662,8 @@ protected PublisherStub build(io.grpc.Channel channel, io.grpc.CallOptions callO
*
*
* Creates the given topic with the given name. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
*
*/
public void createTopic(
@@ -755,8 +762,13 @@ public void listTopicSubscriptions(
*
*
*
- * Lists the names of the snapshots on this topic.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -821,7 +833,8 @@ protected PublisherBlockingStub build(
*
*
* Creates the given topic with the given name. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
*
*/
public com.google.pubsub.v1.Topic createTopic(com.google.pubsub.v1.Topic request) {
@@ -896,8 +909,13 @@ public com.google.pubsub.v1.ListTopicSubscriptionsResponse listTopicSubscription
*
*
*
- * Lists the names of the snapshots on this topic.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -953,7 +971,8 @@ protected PublisherFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions
*
*
* Creates the given topic with the given name. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
*
*/
public com.google.common.util.concurrent.ListenableFuture
* Creates a subscription to a given topic. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <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`.
* 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/overview#names).
+ * [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.
*
@@ -1026,8 +1027,12 @@ public void modifyPushConfig(
*
*
*
- * Gets the configuration details of a snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Gets the configuration details of a 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1042,8 +1047,13 @@ public void getSnapshot(
*
*
*
- * Lists the existing snapshots.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1058,8 +1068,14 @@ public void listSnapshots(
*
*
*
- * Creates a snapshot from the requested subscription.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.<br><br>
* If the snapshot already exists, returns `ALREADY_EXISTS`.
@@ -1069,10 +1085,10 @@ public void listSnapshots(
* 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/overview#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.
+ * 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.
*
*/
public void createSnapshot(
@@ -1085,8 +1101,13 @@ public void createSnapshot(
*
*
*
- * Updates an existing snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Updates 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* Note that certain properties of a snapshot are not modifiable.
@@ -1102,8 +1123,13 @@ public void updateSnapshot(
*
*
*
- * Removes an existing snapshot. <br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* When the snapshot is deleted, all messages retained in the snapshot
@@ -1123,8 +1149,14 @@ public void deleteSnapshot(
*
*
* Seeks an existing subscription to a point in time or to a given snapshot,
- * whichever is provided in the request.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1267,13 +1299,14 @@ protected SubscriberStub build(io.grpc.Channel channel, io.grpc.CallOptions call
*
*
* Creates a subscription to a given topic. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <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`.
* 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/overview#names).
+ * [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.
*
@@ -1457,8 +1490,12 @@ public void modifyPushConfig(
*
*
*
- * Gets the configuration details of a snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Gets the configuration details of a 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1476,8 +1513,13 @@ public void getSnapshot(
*
*
*
- * Lists the existing snapshots.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1495,8 +1537,14 @@ public void listSnapshots(
*
*
*
- * Creates a snapshot from the requested subscription.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.<br><br>
* If the snapshot already exists, returns `ALREADY_EXISTS`.
@@ -1506,10 +1554,10 @@ public void listSnapshots(
* 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/overview#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.
+ * 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.
*
*/
public void createSnapshot(
@@ -1525,8 +1573,13 @@ public void createSnapshot(
*
*
*
- * Updates an existing snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Updates 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* Note that certain properties of a snapshot are not modifiable.
@@ -1545,8 +1598,13 @@ public void updateSnapshot(
*
*
*
- * Removes an existing snapshot. <br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* When the snapshot is deleted, all messages retained in the snapshot
@@ -1569,8 +1627,14 @@ public void deleteSnapshot(
*
*
* Seeks an existing subscription to a point in time or to a given snapshot,
- * whichever is provided in the request.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1613,13 +1677,14 @@ protected SubscriberBlockingStub build(
*
*
* Creates a subscription to a given topic. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <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`.
* 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/overview#names).
+ * [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.
*
@@ -1755,8 +1820,12 @@ public com.google.protobuf.Empty modifyPushConfig(
*
*
*
- * Gets the configuration details of a snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Gets the configuration details of a 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1771,8 +1840,13 @@ public com.google.pubsub.v1.Snapshot getSnapshot(
*
*
*
- * Lists the existing snapshots.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1787,8 +1861,14 @@ public com.google.pubsub.v1.ListSnapshotsResponse listSnapshots(
*
*
*
- * Creates a snapshot from the requested subscription.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.<br><br>
* If the snapshot already exists, returns `ALREADY_EXISTS`.
@@ -1798,10 +1878,10 @@ public com.google.pubsub.v1.ListSnapshotsResponse listSnapshots(
* 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/overview#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.
+ * 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.
*
*/
public com.google.pubsub.v1.Snapshot createSnapshot(
@@ -1814,8 +1894,13 @@ public com.google.pubsub.v1.Snapshot createSnapshot(
*
*
*
- * Updates an existing snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Updates 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* Note that certain properties of a snapshot are not modifiable.
@@ -1831,8 +1916,13 @@ public com.google.pubsub.v1.Snapshot updateSnapshot(
*
*
*
- * Removes an existing snapshot. <br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* When the snapshot is deleted, all messages retained in the snapshot
@@ -1852,8 +1942,14 @@ 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.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1892,13 +1988,14 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
* Creates a subscription to a given topic. See the
- * <a href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * <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`.
* 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/overview#names).
+ * [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.
*
@@ -2038,8 +2135,12 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
- * Gets the configuration details of a snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Gets the configuration details of a 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -2054,8 +2155,13 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
- * Lists the existing snapshots.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -2071,8 +2177,14 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
- * Creates a snapshot from the requested subscription.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.<br><br>
* If the snapshot already exists, returns `ALREADY_EXISTS`.
@@ -2082,10 +2194,10 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
* 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/overview#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.
+ * 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.
*
*/
public com.google.common.util.concurrent.ListenableFuture
@@ -2098,8 +2210,13 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
- * Updates an existing snapshot.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Updates 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* Note that certain properties of a snapshot are not modifiable.
@@ -2115,8 +2232,13 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
- * Removes an existing snapshot. <br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>
+ * <b>BETA:</b> This feature is part of a beta 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.
* When the snapshot is deleted, all messages retained in the snapshot
@@ -2136,8 +2258,14 @@ 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.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java
index 1b2ce17937f1..4fee2a01533c 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java
@@ -8,7 +8,7 @@
*
*
* Request for the `CreateSnapshot` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be changed in
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -137,7 +137,8 @@ protected com.google.protobuf.MapField internalGetMapField(int number) {
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -162,7 +163,8 @@ public java.lang.String getName() {
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -268,7 +270,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -288,7 +291,8 @@ public java.util.Map getLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -300,7 +304,8 @@ public java.util.Map getLabelsMap() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -316,7 +321,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -523,7 +529,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
* Request for the `CreateSnapshot` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be changed in
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -723,7 +729,8 @@ public Builder mergeFrom(
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -748,7 +755,8 @@ public java.lang.String getName() {
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -773,7 +781,8 @@ public com.google.protobuf.ByteString getNameBytes() {
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -796,7 +805,8 @@ public Builder setName(java.lang.String value) {
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -816,7 +826,8 @@ public Builder clearName() {
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -996,7 +1007,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -1016,7 +1028,8 @@ public java.util.Map getLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -1028,7 +1041,8 @@ public java.util.Map getLabelsMap() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -1045,7 +1059,8 @@ public java.lang.String getLabelsOrDefault(
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -1069,7 +1084,8 @@ public Builder clearLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -1090,7 +1106,8 @@ public java.util.Map getMutableLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -1109,7 +1126,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java
index 28c94b711d2e..0be6df1fee28 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java
@@ -16,7 +16,8 @@ public interface CreateSnapshotRequestOrBuilder
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -31,7 +32,8 @@ public interface CreateSnapshotRequestOrBuilder
* 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.
* Note that for REST API requests, you must specify a name. See the
- * <a href="/pubsub/docs/admin#resource_names">resource name rules</a>.
+ * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+ * resource name rules</a>.
* Format is `projects/{project}/snapshots/{snap}`.
*
*
@@ -80,7 +82,8 @@ public interface CreateSnapshotRequestOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -90,7 +93,8 @@ public interface CreateSnapshotRequestOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -103,7 +107,8 @@ public interface CreateSnapshotRequestOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -113,7 +118,8 @@ public interface CreateSnapshotRequestOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
@@ -123,7 +129,8 @@ public interface CreateSnapshotRequestOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 3;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java
index 99831862e700..ff9a16fff298 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java
@@ -8,7 +8,7 @@
*
* * Request for the `DeleteSnapshot` method.<br><br> - * <b>ALPHA:</b> This feature is part of an alpha release. This API might be + * <b>BETA:</b> This feature is part of a beta 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. *@@ -304,7 +304,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * *
* Request for the `DeleteSnapshot` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java
index 4cb68f688ead..5c8bba2913a8 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java
@@ -8,7 +8,7 @@
*
* * Request for the GetSnapshot method.<br><br> - * <b>ALPHA:</b> This feature is part of an alpha release. This API might be + * <b>BETA:</b> This feature is part of a beta 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. *@@ -303,7 +303,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * *
* Request for the GetSnapshot method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java
index 3657b6362dc2..2915d7938b03 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java
@@ -8,7 +8,7 @@
*
* * Request for the `ListSnapshots` method.<br><br> - * <b>ALPHA:</b> This feature is part of an alpha release. This API might be + * <b>BETA:</b> This feature is part of a beta 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. *@@ -398,7 +398,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * *
* Request for the `ListSnapshots` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java
index 757837fc337e..82586a0386a2 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java
@@ -8,7 +8,7 @@
*
* * Response for the `ListSnapshots` method.<br><br> - * <b>ALPHA:</b> This feature is part of an alpha release. This API might be + * <b>BETA:</b> This feature is part of a beta 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. *@@ -394,7 +394,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * *
* Response for the `ListSnapshots` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java
index 4dfb49deaf48..423da7aac707 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java
@@ -7,8 +7,8 @@
*
*
* - * Request for the `ListTopicSnapshots` method.<br><br> - * <b>ALPHA:</b> This feature is part of an alpha release. This API might be + * Request for the `ListTopicSnapshots` method. <br><br> + * <b>BETA:</b> This feature is part of a beta 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. *@@ -397,8 +397,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * *
- * Request for the `ListTopicSnapshots` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Request for the `ListTopicSnapshots` method. <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java
index b7537b347208..88799eda0d9e 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java
@@ -8,7 +8,7 @@
*
* * Response for the `ListTopicSnapshots` method.<br><br> - * <b>ALPHA:</b> This feature is part of an alpha release. This API might be + * <b>BETA:</b> This feature is part of a beta 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. *@@ -388,7 +388,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * *
* Response for the `ListTopicSnapshots` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java
index b3c99caeaa13..0417cb8c12b6 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java
@@ -95,8 +95,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -112,8 +112,8 @@ public com.google.protobuf.ProtocolStringList getAllowedPersistenceRegionsList()
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -129,8 +129,8 @@ public int getAllowedPersistenceRegionsCount() {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -146,8 +146,8 @@ public java.lang.String getAllowedPersistenceRegions(int index) {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -506,8 +506,8 @@ private void ensureAllowedPersistenceRegionsIsMutable() {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -523,8 +523,8 @@ public com.google.protobuf.ProtocolStringList getAllowedPersistenceRegionsList()
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -540,8 +540,8 @@ public int getAllowedPersistenceRegionsCount() {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -557,8 +557,8 @@ public java.lang.String getAllowedPersistenceRegions(int index) {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -574,8 +574,8 @@ public com.google.protobuf.ByteString getAllowedPersistenceRegionsBytes(int inde
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -597,8 +597,8 @@ public Builder setAllowedPersistenceRegions(int index, java.lang.String value) {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -620,8 +620,8 @@ public Builder addAllowedPersistenceRegions(java.lang.String value) {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -640,8 +640,8 @@ public Builder addAllAllowedPersistenceRegions(java.lang.Iterable
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -660,8 +660,8 @@ public Builder clearAllowedPersistenceRegions() {
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java
index 918ef490c636..ebc0d1454b41 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java
@@ -12,8 +12,8 @@ public interface MessageStoragePolicyOrBuilder
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -27,8 +27,8 @@ public interface MessageStoragePolicyOrBuilder
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -42,8 +42,8 @@ public interface MessageStoragePolicyOrBuilder
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
@@ -57,8 +57,8 @@ public interface MessageStoragePolicyOrBuilder
*
*
*
- * The list of GCP regions where messages that are published to the topic may
- * be persisted in storage. Messages published by publishers running in
+ * The list of GCP region IDs where messages that are published to the topic
+ * may be persisted in storage. Messages published by publishers running in
* non-allowed GCP regions (or running outside of GCP altogether) will be
* routed for storage in one of the allowed regions. An empty list indicates a
* misconfiguration at the project or organization level, which will result in
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java
index 8ee933d50f23..8d1730521f59 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java
@@ -217,8 +217,9 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
* The new ack deadline with respect to the time this request was sent to
* the Pub/Sub system. For example, if the value is 10, the new
* ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
- * was made. Specifying zero may immediately make the message available for
- * another pull request.
+ * was made. Specifying zero might immediately make the message available for
+ * delivery to another subscriber client. This typically results in an
+ * increase in the rate of message redeliveries (that is, duplicates).
* The minimum deadline you can specify is 0 seconds.
* The maximum deadline you can specify is 600 seconds (10 minutes).
*
@@ -849,8 +850,9 @@ public Builder addAckIdsBytes(com.google.protobuf.ByteString value) {
* The new ack deadline with respect to the time this request was sent to
* the Pub/Sub system. For example, if the value is 10, the new
* ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
- * was made. Specifying zero may immediately make the message available for
- * another pull request.
+ * was made. Specifying zero might immediately make the message available for
+ * delivery to another subscriber client. This typically results in an
+ * increase in the rate of message redeliveries (that is, duplicates).
* The minimum deadline you can specify is 0 seconds.
* The maximum deadline you can specify is 600 seconds (10 minutes).
*
@@ -867,8 +869,9 @@ public int getAckDeadlineSeconds() {
* The new ack deadline with respect to the time this request was sent to
* the Pub/Sub system. For example, if the value is 10, the new
* ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
- * was made. Specifying zero may immediately make the message available for
- * another pull request.
+ * was made. Specifying zero might immediately make the message available for
+ * delivery to another subscriber client. This typically results in an
+ * increase in the rate of message redeliveries (that is, duplicates).
* The minimum deadline you can specify is 0 seconds.
* The maximum deadline you can specify is 600 seconds (10 minutes).
*
@@ -888,8 +891,9 @@ public Builder setAckDeadlineSeconds(int value) {
* The new ack deadline with respect to the time this request was sent to
* the Pub/Sub system. For example, if the value is 10, the new
* ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
- * was made. Specifying zero may immediately make the message available for
- * another pull request.
+ * was made. Specifying zero might immediately make the message available for
+ * delivery to another subscriber client. This typically results in an
+ * increase in the rate of message redeliveries (that is, duplicates).
* The minimum deadline you can specify is 0 seconds.
* The maximum deadline you can specify is 600 seconds (10 minutes).
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java
index 6fa5d98a3ae2..079ea0289756 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java
@@ -79,8 +79,9 @@ public interface ModifyAckDeadlineRequestOrBuilder
* The new ack deadline with respect to the time this request was sent to
* the Pub/Sub system. For example, if the value is 10, the new
* ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
- * was made. Specifying zero may immediately make the message available for
- * another pull request.
+ * was made. Specifying zero might immediately make the message available for
+ * delivery to another subscriber client. This typically results in an
+ * increase in the rate of message redeliveries (that is, duplicates).
* The minimum deadline you can specify is 0 seconds.
* The maximum deadline you can specify is 600 seconds (10 minutes).
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java
index 53fc4ecda8eb..21ae0f027cbe 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java
@@ -9,8 +9,12 @@
*
* 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.
- * See <a href="/pubsub/quotas">Quotas and limits</a> for more information about
- * message limits.
+ * 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.
*
*
* Protobuf type {@code google.pubsub.v1.PubsubMessage}
@@ -550,8 +554,12 @@ 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.
- * See <a href="/pubsub/quotas">Quotas and limits</a> for more information about
- * message limits.
+ * 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.
*
*
* Protobuf type {@code google.pubsub.v1.PubsubMessage}
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java
index f738cc912074..cdc7b4ce4539 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java
@@ -389,11 +389,12 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
+ "apshots/*}\022\204\001\n\004Seek\022\035.google.pubsub.v1.S"
+ "eekRequest\032\036.google.pubsub.v1.SeekRespon"
+ "se\"=\202\323\344\223\0027\"2/v1/{subscription=projects/*"
- + "/subscriptions/*}:seek:\001*B\222\001\n\024com.google"
+ + "/subscriptions/*}:seek:\001*B\256\001\n\024com.google"
+ ".pubsub.v1B\013PubsubProtoP\001Z6google.golang"
+ ".org/genproto/googleapis/pubsub/v1;pubsu"
+ "b\370\001\001\252\002\026Google.Cloud.PubSub.V1\312\002\026Google\\C"
- + "loud\\PubSub\\V1b\006proto3"
+ + "loud\\PubSub\\V1\352\002\031Google::Cloud::PubSub::"
+ + "V1b\006proto3"
};
com.google.protobuf.Descriptors.FileDescriptor.InternalDescriptorAssigner assigner =
new com.google.protobuf.Descriptors.FileDescriptor.InternalDescriptorAssigner() {
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java
index bbfa4e31c334..47f4f36f6bf2 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java
@@ -7,8 +7,8 @@
*
*
*
- * Request for the `Seek` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Request for the `Seek` method. <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -527,8 +527,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Request for the `Seek` method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * Request for the `Seek` method. <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
index 25134a5cf2b3..9be35782091d 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
@@ -7,8 +7,13 @@
*
*
*
- * A snapshot resource.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -321,7 +326,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -341,7 +347,8 @@ public java.util.Map getLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -353,7 +360,8 @@ public java.util.Map getLabelsMap() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -369,7 +377,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -587,8 +596,13 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * A snapshot resource.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1266,7 +1280,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -1286,7 +1301,8 @@ public java.util.Map getLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -1298,7 +1314,8 @@ public java.util.Map getLabelsMap() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -1315,7 +1332,8 @@ public java.lang.String getLabelsOrDefault(
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -1339,7 +1357,8 @@ public Builder clearLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -1360,7 +1379,8 @@ public java.util.Map getMutableLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -1379,7 +1399,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
index 18d810f29ec1..30166c3a8d0b 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
@@ -112,7 +112,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -122,7 +123,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -135,7 +137,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -145,7 +148,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
@@ -155,7 +159,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 4;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
index 16d6e3ebff29..efb2168d1aa7 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
@@ -335,11 +335,11 @@ public com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder() {
*
*
*
- * This value is the maximum time after a subscriber receives a message
- * before the subscriber should acknowledge the message. After message
- * delivery but before the ack deadline expires and before the message is
- * acknowledged, it is an outstanding message and will not be delivered
- * again during that time (on a best-effort basis).
+ * The approximate amount of time (on a best-effort basis) Pub/Sub waits for
+ * the subscriber to acknowledge receipt before resending the message. In the
+ * interval after the message is delivered and before it is acknowledged, it
+ * is considered to be <i>outstanding</i>. During that time period, the
+ * message will not be redelivered (on a best-effort basis).
* For pull subscriptions, this value is used as the initial value for the ack
* deadline. To override this value for a given message, call
* `ModifyAckDeadline` with the corresponding `ack_id` if using
@@ -369,8 +369,11 @@ 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.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>.
+ * <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -393,7 +396,7 @@ public boolean getRetainAckedMessages() {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -413,7 +416,7 @@ public boolean hasMessageRetentionDuration() {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -435,7 +438,7 @@ public com.google.protobuf.Duration getMessageRetentionDuration() {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -475,7 +478,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -495,7 +499,8 @@ public java.util.Map getLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -507,7 +512,8 @@ public java.util.Map getLabelsMap() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -523,7 +529,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -1528,11 +1535,11 @@ public com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder() {
*
*
*
- * This value is the maximum time after a subscriber receives a message
- * before the subscriber should acknowledge the message. After message
- * delivery but before the ack deadline expires and before the message is
- * acknowledged, it is an outstanding message and will not be delivered
- * again during that time (on a best-effort basis).
+ * The approximate amount of time (on a best-effort basis) Pub/Sub waits for
+ * the subscriber to acknowledge receipt before resending the message. In the
+ * interval after the message is delivered and before it is acknowledged, it
+ * is considered to be <i>outstanding</i>. During that time period, the
+ * message will not be redelivered (on a best-effort basis).
* For pull subscriptions, this value is used as the initial value for the ack
* deadline. To override this value for a given message, call
* `ModifyAckDeadline` with the corresponding `ack_id` if using
@@ -1556,11 +1563,11 @@ public int getAckDeadlineSeconds() {
*
*
*
- * This value is the maximum time after a subscriber receives a message
- * before the subscriber should acknowledge the message. After message
- * delivery but before the ack deadline expires and before the message is
- * acknowledged, it is an outstanding message and will not be delivered
- * again during that time (on a best-effort basis).
+ * The approximate amount of time (on a best-effort basis) Pub/Sub waits for
+ * the subscriber to acknowledge receipt before resending the message. In the
+ * interval after the message is delivered and before it is acknowledged, it
+ * is considered to be <i>outstanding</i>. During that time period, the
+ * message will not be redelivered (on a best-effort basis).
* For pull subscriptions, this value is used as the initial value for the ack
* deadline. To override this value for a given message, call
* `ModifyAckDeadline` with the corresponding `ack_id` if using
@@ -1587,11 +1594,11 @@ public Builder setAckDeadlineSeconds(int value) {
*
*
*
- * This value is the maximum time after a subscriber receives a message
- * before the subscriber should acknowledge the message. After message
- * delivery but before the ack deadline expires and before the message is
- * acknowledged, it is an outstanding message and will not be delivered
- * again during that time (on a best-effort basis).
+ * The approximate amount of time (on a best-effort basis) Pub/Sub waits for
+ * the subscriber to acknowledge receipt before resending the message. In the
+ * interval after the message is delivered and before it is acknowledged, it
+ * is considered to be <i>outstanding</i>. During that time period, the
+ * message will not be redelivered (on a best-effort basis).
* For pull subscriptions, this value is used as the initial value for the ack
* deadline. To override this value for a given message, call
* `ModifyAckDeadline` with the corresponding `ack_id` if using
@@ -1623,8 +1630,11 @@ 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.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>.
+ * <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1641,8 +1651,11 @@ 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.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>.
+ * <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1662,8 +1675,11 @@ 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.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>.
+ * <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1693,7 +1709,7 @@ public Builder clearRetainAckedMessages() {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1713,7 +1729,7 @@ public boolean hasMessageRetentionDuration() {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1739,7 +1755,7 @@ public com.google.protobuf.Duration getMessageRetentionDuration() {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1769,7 +1785,7 @@ public Builder setMessageRetentionDuration(com.google.protobuf.Duration value) {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1797,7 +1813,7 @@ public Builder setMessageRetentionDuration(
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1831,7 +1847,7 @@ public Builder mergeMessageRetentionDuration(com.google.protobuf.Duration value)
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1859,7 +1875,7 @@ public Builder clearMessageRetentionDuration() {
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1881,7 +1897,7 @@ public com.google.protobuf.Duration.Builder getMessageRetentionDurationBuilder()
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1907,7 +1923,7 @@ public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilde
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -1960,7 +1976,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -1980,7 +1997,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -1992,7 +2010,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -2009,7 +2028,8 @@ public java.lang.String getLabelsOrDefault(
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -2033,7 +2053,8 @@ public Builder clearLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -2054,7 +2075,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -2073,7 +2095,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
index ba0a20256cf7..dc06e7fb432b 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
@@ -107,11 +107,11 @@ public interface SubscriptionOrBuilder
*
*
*
- * This value is the maximum time after a subscriber receives a message
- * before the subscriber should acknowledge the message. After message
- * delivery but before the ack deadline expires and before the message is
- * acknowledged, it is an outstanding message and will not be delivered
- * again during that time (on a best-effort basis).
+ * The approximate amount of time (on a best-effort basis) Pub/Sub waits for
+ * the subscriber to acknowledge receipt before resending the message. In the
+ * interval after the message is delivered and before it is acknowledged, it
+ * is considered to be <i>outstanding</i>. During that time period, the
+ * message will not be redelivered (on a best-effort basis).
* For pull subscriptions, this value is used as the initial value for the ack
* deadline. To override this value for a given message, call
* `ModifyAckDeadline` with the corresponding `ack_id` if using
@@ -137,8 +137,11 @@ 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.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * 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>.
+ * <br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -157,7 +160,7 @@ public interface SubscriptionOrBuilder
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -175,7 +178,7 @@ public interface SubscriptionOrBuilder
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -193,7 +196,7 @@ public interface SubscriptionOrBuilder
* of acknowledged messages, and thus configures how far back in time a `Seek`
* can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
* minutes.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
@@ -206,7 +209,8 @@ public interface SubscriptionOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -216,7 +220,8 @@ public interface SubscriptionOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -229,7 +234,8 @@ public interface SubscriptionOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -239,7 +245,8 @@ public interface SubscriptionOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
@@ -249,7 +256,8 @@ public interface SubscriptionOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 9;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
index 6501868c14d5..2d0d72b5209f 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
@@ -211,7 +211,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -231,7 +232,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -243,7 +245,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -259,7 +262,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -865,7 +869,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -885,7 +890,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -897,7 +903,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -914,7 +921,8 @@ public java.lang.String getLabelsOrDefault(
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -938,7 +946,8 @@ public Builder clearLabels() {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -959,7 +968,8 @@ public java.util.Map
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -978,7 +988,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
index c5b0f6dcccf5..b10fdd87aa15 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
@@ -43,7 +43,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -53,7 +54,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -66,7 +68,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -76,7 +79,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
@@ -86,7 +90,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="/pubsub/docs/labels"> Creating and managing labels</a>.
+ * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+ * managing labels</a>.
*
*
* map<string, string> labels = 2;
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java
index 2b2f150c55f5..472730603638 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java
@@ -8,7 +8,7 @@
*
* * Request for the UpdateSnapshot method.<br><br> - * <b>ALPHA:</b> This feature is part of an alpha release. This API might be + * <b>BETA:</b> This feature is part of a beta 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. *@@ -380,7 +380,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * *
* Request for the UpdateSnapshot method.<br><br>
- * <b>ALPHA:</b> This feature is part of an alpha release. This API might be
+ * <b>BETA:</b> This feature is part of a beta 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.
*
diff --git a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
index b13c73473aa9..02d0bf34b3ee 100644
--- a/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
+++ b/google-api-grpc/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
@@ -30,13 +30,15 @@ option java_multiple_files = true;
option java_outer_classname = "PubsubProto";
option java_package = "com.google.pubsub.v1";
option php_namespace = "Google\\Cloud\\PubSub\\V1";
+option ruby_package = "Google::Cloud::PubSub::V1";
// The service that an application uses to manipulate topics, and to send
// messages to a topic.
service Publisher {
// Creates the given topic with the given name. See the
- // resource name rules.
+ //
+ // resource name rules.
rpc CreateTopic(Topic) returns (Topic) {
option (google.api.http) = {
put: "/v1/{name=projects/*/topics/*}"
@@ -83,8 +85,13 @@ service Publisher {
};
}
- // Lists the names of the snapshots on this topic.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/overview#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. + * 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: * @@ -228,10 +228,11 @@ public SubscriberStub getStub() { * @param pushConfig If push delivery is used with this subscription, this field is used to * configure it. An empty `pushConfig` signifies that the subscriber will pull and ack * messages using API methods. - * @param ackDeadlineSeconds This value is the maximum time after a subscriber receives a message - * before the subscriber should acknowledge the message. After message delivery but before the - * ack deadline expires and before the message is acknowledged, it is an outstanding message - * and will not be delivered again during that time (on a best-effort basis). + * @param ackDeadlineSeconds The approximate amount of time (on a best-effort basis) Pub/Sub waits + * for the subscriber to acknowledge receipt before resending the message. In the interval + * after the message is delivered and before it is acknowledged, it is considered to be + * <i>outstanding</i>. During that time period, the message will not be + * redelivered (on a best-effort basis). *
For pull subscriptions, this value is used as the initial value for the ack deadline. To * override this value for a given message, call `ModifyAckDeadline` with the corresponding * `ack_id` if using non-streaming pull or send the `ack_id` in a @@ -263,15 +264,15 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** * Creates a subscription to a given topic. See the <a - * href="/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`. + * 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`. * *
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/overview#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. + * 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: * @@ -296,10 +297,11 @@ public final Subscription createSubscription( * @param pushConfig If push delivery is used with this subscription, this field is used to * configure it. An empty `pushConfig` signifies that the subscriber will pull and ack * messages using API methods. - * @param ackDeadlineSeconds This value is the maximum time after a subscriber receives a message - * before the subscriber should acknowledge the message. After message delivery but before the - * ack deadline expires and before the message is acknowledged, it is an outstanding message - * and will not be delivered again during that time (on a best-effort basis). + * @param ackDeadlineSeconds The approximate amount of time (on a best-effort basis) Pub/Sub waits + * for the subscriber to acknowledge receipt before resending the message. In the interval + * after the message is delivered and before it is acknowledged, it is considered to be + * <i>outstanding</i>. During that time period, the message will not be + * redelivered (on a best-effort basis). *
For pull subscriptions, this value is used as the initial value for the ack deadline. To * override this value for a given message, call `ModifyAckDeadline` with the corresponding * `ack_id` if using non-streaming pull or send the `ack_id` in a @@ -328,15 +330,15 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** * Creates a subscription to a given topic. See the <a - * href="/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`. + * 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`. * *
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/overview#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. + * 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: * @@ -362,15 +364,15 @@ public final Subscription createSubscription(Subscription request) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** * Creates a subscription to a given topic. See the <a - * href="/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`. + * 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`. * *
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/overview#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. + * 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:
*
@@ -816,9 +818,11 @@ public final UnaryCallable Sample code:
*
@@ -1381,9 +1391,13 @@ public final ListSnapshotsPagedResponse listSnapshots(ProjectName project) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots.<br><br> <b>ALPHA:</b> This feature is
- * part of an 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.
+ * 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.<br><br> <b>BETA:</b> This feature is part of a beta 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.
*
* Sample code:
*
@@ -1407,9 +1421,13 @@ public final ListSnapshotsPagedResponse listSnapshots(String project) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots.<br><br> <b>ALPHA:</b> This feature is
- * part of an 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.
+ * 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.<br><br> <b>BETA:</b> This feature is part of a beta 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.
*
* Sample code:
*
@@ -1434,9 +1452,13 @@ public final ListSnapshotsPagedResponse listSnapshots(ListSnapshotsRequest reque
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots.<br><br> <b>ALPHA:</b> This feature is
- * part of an 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.
+ * 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.<br><br> <b>BETA:</b> This feature is part of a beta 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.
*
* Sample code:
*
@@ -1461,9 +1483,13 @@ public final ListSnapshotsPagedResponse listSnapshots(ListSnapshotsRequest reque
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots.<br><br> <b>ALPHA:</b> This feature is
- * part of an 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.
+ * 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.<br><br> <b>BETA:</b> This feature is part of a beta 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.
*
* Sample code:
*
@@ -1494,18 +1520,21 @@ public final UnaryCallable Sample code:
*
@@ -1520,8 +1549,8 @@ public final UnaryCallable Sample code:
*
@@ -1569,8 +1601,8 @@ public final Snapshot createSnapshot(
* @param name Optional user-provided name for this snapshot. 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. Note that for REST API requests, you must specify a name. See the <a
- * href="/pubsub/docs/admin#resource_names">resource name rules</a>. Format is
- * `projects/{project}/snapshots/{snap}`.
+ * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
+ * rules</a>. Format is `projects/{project}/snapshots/{snap}`.
* @param subscription The subscription whose backlog the snapshot retains. Specifically, the
* created snapshot is guaranteed to retain: (a) The existing backlog on the subscription.
* More precisely, this is defined as the messages in the subscription's backlog that are
@@ -1588,18 +1620,21 @@ public final Snapshot createSnapshot(String name, String subscription) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates a snapshot from the requested subscription.<br><br>
- * <b>ALPHA:</b> This feature is part of an 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.<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/overview#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 <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> <b>BETA:</b> This feature is part of a beta 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.<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.
*
* Sample code:
*
@@ -1624,18 +1659,21 @@ public final Snapshot createSnapshot(CreateSnapshotRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates a snapshot from the requested subscription.<br><br>
- * <b>ALPHA:</b> This feature is part of an 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.<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/overview#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 <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> <b>BETA:</b> This feature is part of a beta 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.<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.
*
* Sample code:
*
@@ -1659,10 +1697,14 @@ public final UnaryCallable Sample code:
*
@@ -1697,10 +1739,14 @@ public final Snapshot updateSnapshot(UpdateSnapshotRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Updates an existing snapshot.<br><br> <b>ALPHA:</b> This feature is
- * part of an 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. Note that
- * certain properties of a snapshot are not modifiable.
+ * Updates 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> <b>BETA:</b> This feature is part of a beta 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. Note that certain properties of a
+ * snapshot are not modifiable.
*
* Sample code:
*
@@ -1734,13 +1780,16 @@ public final UnaryCallable Sample code:
*
@@ -1766,13 +1815,16 @@ public final void deleteSnapshot(ProjectSnapshotName snapshot) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Removes an existing snapshot. <br><br> <b>ALPHA:</b> This feature is
- * part of an 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. 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 <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> <b>BETA:</b> This feature is part of a beta 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. 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:
*
@@ -1796,13 +1848,16 @@ public final void deleteSnapshot(String snapshot) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Removes an existing snapshot. <br><br> <b>ALPHA:</b> This feature is
- * part of an 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. 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 <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> <b>BETA:</b> This feature is part of a beta 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. 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:
*
@@ -1825,13 +1880,16 @@ public final void deleteSnapshot(DeleteSnapshotRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Removes an existing snapshot. <br><br> <b>ALPHA:</b> This feature is
- * part of an 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. 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 <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> <b>BETA:</b> This feature is part of a beta 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. 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:
*
@@ -1854,9 +1912,14 @@ public final UnaryCallable Sample code:
*
@@ -1880,9 +1943,14 @@ 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.<br><br> <b>ALPHA:</b> This feature is part of an 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.
+ * 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.<br><br>
+ * <b>BETA:</b> This feature is part of a beta 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.
*
* Sample code:
*
diff --git a/google-cloud-clients/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java b/google-cloud-clients/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java
index 073e1f2750c1..0f497ce565a2 100644
--- a/google-cloud-clients/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java
+++ b/google-cloud-clients/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java
@@ -177,7 +177,8 @@ public PublisherStub getStub() {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Creates the given topic with the given name. See the <a
- * href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
+ * rules</a>.
*
* Sample code:
*
@@ -204,7 +205,8 @@ public final Topic createTopic(ProjectTopicName name) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Creates the given topic with the given name. See the <a
- * href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
+ * rules</a>.
*
* Sample code:
*
@@ -231,7 +233,8 @@ public final Topic createTopic(String name) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Creates the given topic with the given name. See the <a
- * href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
+ * rules</a>.
*
* Sample code:
*
@@ -255,7 +258,8 @@ public final Topic createTopic(Topic request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Creates the given topic with the given name. See the <a
- * href="/pubsub/docs/admin#resource_names"> resource name rules</a>.
+ * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
+ * rules</a>.
*
* Sample code:
*
diff --git a/google-cloud-clients/google-cloud-pubsub/synth.metadata b/google-cloud-clients/google-cloud-pubsub/synth.metadata
index 3c2ad1f85029..05048bef9909 100644
--- a/google-cloud-clients/google-cloud-pubsub/synth.metadata
+++ b/google-cloud-clients/google-cloud-pubsub/synth.metadata
@@ -1,19 +1,19 @@
{
- "updateTime": "2018-12-07T08:45:57.038583Z",
+ "updateTime": "2019-01-05T08:46:07.715668Z",
"sources": [
{
"generator": {
"name": "artman",
- "version": "0.16.2",
- "dockerImage": "googleapis/artman@sha256:2f6b261ee7fe1aedf238991c93a20b3820de37a343d0cacf3e3e9555c2aaf2ea"
+ "version": "0.16.4",
+ "dockerImage": "googleapis/artman@sha256:8b45fae963557c3299921037ecbb86f0689f41b1b4aea73408ebc50562cb2857"
}
},
{
"git": {
"name": "googleapis",
"remote": "https://github.com/googleapis/googleapis.git",
- "sha": "200fbbe59cc7b0077ae525eb5f3d6420c0c53e61",
- "internalRef": "224174014"
+ "sha": "a111a53c0c6722afcd793b64724ceef7862db5b9",
+ "internalRef": "227896184"
}
}
],