diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SchemaServiceClient.java index ddc98a2f0..02b4aef14 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -80,240 +80,240 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * - * + * * * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * @@ -449,7 +449,7 @@ public SchemaServiceStub getStub() { * will have a `name` made using the given `parent` and `schema_id`. * @param schemaId The ID to use for the schema, which will become the final component of the * schema's resource name. - *

See https://cloud.google.com/pubsub/docs/admin#resource_names for resource name + *

See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for resource name * constraints. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -490,7 +490,7 @@ public final Schema createSchema(ProjectName parent, Schema schema, String schem * will have a `name` made using the given `parent` and `schema_id`. * @param schemaId The ID to use for the schema, which will become the final component of the * schema's resource name. - *

See https://cloud.google.com/pubsub/docs/admin#resource_names for resource name + *

See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for resource name * constraints. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index e7617298c..7eca1a773 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -100,352 +100,352 @@ * close(). * *

MethodsMethods
MethodDescriptionMethod Variants
CreateSchema

CreateSchema

Creates a schema.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createSchema(CreateSchemaRequest request) + *

  • createSchema(CreateSchemaRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createSchema(ProjectName parent, Schema schema, String schemaId) - *
  • createSchema(String parent, Schema schema, String schemaId) + *

  • createSchema(ProjectName parent, Schema schema, String schemaId) + *

  • createSchema(String parent, Schema schema, String schemaId) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createSchemaCallable() + *

  • createSchemaCallable() *

*
GetSchema

GetSchema

Gets a schema.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getSchema(GetSchemaRequest request) + *

  • getSchema(GetSchemaRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getSchema(SchemaName name) - *
  • getSchema(String name) + *

  • getSchema(SchemaName name) + *

  • getSchema(String name) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getSchemaCallable() + *

  • getSchemaCallable() *

*
ListSchemas

ListSchemas

Lists schemas in a project.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSchemas(ListSchemasRequest request) + *

  • listSchemas(ListSchemasRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSchemas(ProjectName parent) - *
  • listSchemas(String parent) + *

  • listSchemas(ProjectName parent) + *

  • listSchemas(String parent) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listSchemasPagedCallable() - *
  • listSchemasCallable() + *

  • listSchemasPagedCallable() + *

  • listSchemasCallable() *

*
ListSchemaRevisions

ListSchemaRevisions

Lists all schema revisions for the named schema.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSchemaRevisions(ListSchemaRevisionsRequest request) + *

  • listSchemaRevisions(ListSchemaRevisionsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSchemaRevisions(SchemaName name) - *
  • listSchemaRevisions(String name) + *

  • listSchemaRevisions(SchemaName name) + *

  • listSchemaRevisions(String name) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listSchemaRevisionsPagedCallable() - *
  • listSchemaRevisionsCallable() + *

  • listSchemaRevisionsPagedCallable() + *

  • listSchemaRevisionsCallable() *

*
CommitSchema

CommitSchema

Commits a new schema revision to an existing schema.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • commitSchema(CommitSchemaRequest request) + *

  • commitSchema(CommitSchemaRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • commitSchema(SchemaName name, Schema schema) - *
  • commitSchema(String name, Schema schema) + *

  • commitSchema(SchemaName name, Schema schema) + *

  • commitSchema(String name, Schema schema) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • commitSchemaCallable() + *

  • commitSchemaCallable() *

*
RollbackSchema

RollbackSchema

Creates a new schema revision that is a copy of the provided revision_id.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • rollbackSchema(RollbackSchemaRequest request) + *

  • rollbackSchema(RollbackSchemaRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • rollbackSchema(SchemaName name, String revisionId) - *
  • rollbackSchema(String name, String revisionId) + *

  • rollbackSchema(SchemaName name, String revisionId) + *

  • rollbackSchema(String name, String revisionId) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • rollbackSchemaCallable() + *

  • rollbackSchemaCallable() *

*
DeleteSchemaRevision

DeleteSchemaRevision

Deletes a specific schema revision.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteSchemaRevision(DeleteSchemaRevisionRequest request) + *

  • deleteSchemaRevision(DeleteSchemaRevisionRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteSchemaRevision(SchemaName name, String revisionId) - *
  • deleteSchemaRevision(String name, String revisionId) + *

  • deleteSchemaRevision(SchemaName name, String revisionId) + *

  • deleteSchemaRevision(String name, String revisionId) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • deleteSchemaRevisionCallable() + *

  • deleteSchemaRevisionCallable() *

*
DeleteSchema

DeleteSchema

Deletes a schema.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteSchema(DeleteSchemaRequest request) + *

  • deleteSchema(DeleteSchemaRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteSchema(SchemaName name) - *
  • deleteSchema(String name) + *

  • deleteSchema(SchemaName name) + *

  • deleteSchema(String name) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • deleteSchemaCallable() + *

  • deleteSchemaCallable() *

*
ValidateSchema

ValidateSchema

Validates a schema.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • validateSchema(ValidateSchemaRequest request) + *

  • validateSchema(ValidateSchemaRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • validateSchema(ProjectName parent, Schema schema) - *
  • validateSchema(String parent, Schema schema) + *

  • validateSchema(ProjectName parent, Schema schema) + *

  • validateSchema(String parent, Schema schema) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • validateSchemaCallable() + *

  • validateSchemaCallable() *

*
ValidateMessage

ValidateMessage

Validates a message against a schema.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • validateMessage(ValidateMessageRequest request) + *

  • validateMessage(ValidateMessageRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • validateMessageCallable() + *

  • validateMessageCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *

  • setIamPolicy(SetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setIamPolicyCallable() + *

  • setIamPolicyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *

  • getIamPolicy(GetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getIamPolicyCallable() + *

  • getIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *

  • testIamPermissions(TestIamPermissionsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • testIamPermissionsCallable() + *

  • testIamPermissionsCallable() *

*
- * + * * * * * * * - * + * * * * * - * + * * * * * - * - * + * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * - * + * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * @@ -596,12 +596,12 @@ public SubscriberStub getStub() { * @param topic Required. The name of the topic from which this subscription is receiving * messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be * `_deleted-topic_` if the topic has been deleted. - * @param pushConfig If push delivery is used with this subscription, this field is used to - * configure it. - * @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 - * _outstanding_. During that time period, the message will not be redelivered (on a + * @param pushConfig Optional. If push delivery is used with this subscription, this field is used + * to configure it. + * @param ackDeadlineSeconds Optional. 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 _outstanding_. 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 @@ -666,12 +666,12 @@ public final Subscription createSubscription( * @param topic Required. The name of the topic from which this subscription is receiving * messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be * `_deleted-topic_` if the topic has been deleted. - * @param pushConfig If push delivery is used with this subscription, this field is used to - * configure it. - * @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 - * _outstanding_. During that time period, the message will not be redelivered (on a + * @param pushConfig Optional. If push delivery is used with this subscription, this field is used + * to configure it. + * @param ackDeadlineSeconds Optional. 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 _outstanding_. 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 @@ -736,12 +736,12 @@ public final Subscription createSubscription( * @param topic Required. The name of the topic from which this subscription is receiving * messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be * `_deleted-topic_` if the topic has been deleted. - * @param pushConfig If push delivery is used with this subscription, this field is used to - * configure it. - * @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 - * _outstanding_. During that time period, the message will not be redelivered (on a + * @param pushConfig Optional. If push delivery is used with this subscription, this field is used + * to configure it. + * @param ackDeadlineSeconds Optional. 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 _outstanding_. 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 @@ -806,12 +806,12 @@ public final Subscription createSubscription( * @param topic Required. The name of the topic from which this subscription is receiving * messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be * `_deleted-topic_` if the topic has been deleted. - * @param pushConfig If push delivery is used with this subscription, this field is used to - * configure it. - * @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 - * _outstanding_. During that time period, the message will not be redelivered (on a + * @param pushConfig Optional. If push delivery is used with this subscription, this field is used + * to configure it. + * @param ackDeadlineSeconds Optional. 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 _outstanding_. 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 @@ -1296,8 +1296,8 @@ public final UnaryCallable getSubscription // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing subscription. Note that certain properties of a subscription, such as its - * topic, are not modifiable. + * Updates an existing subscription by updating the fields specified in the update mask. Note that + * certain properties of a subscription, such as its topic, are not modifiable. * *

Sample code: * @@ -1330,8 +1330,8 @@ public final Subscription updateSubscription(Subscription subscription, FieldMas // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing subscription. Note that certain properties of a subscription, such as its - * topic, are not modifiable. + * Updates an existing subscription by updating the fields specified in the update mask. Note that + * certain properties of a subscription, such as its topic, are not modifiable. * *

Sample code: * @@ -1360,8 +1360,8 @@ public final Subscription updateSubscription(UpdateSubscriptionRequest request) // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing subscription. Note that certain properties of a subscription, such as its - * topic, are not modifiable. + * Updates an existing subscription by updating the fields specified in the update mask. Note that + * certain properties of a subscription, such as its topic, are not modifiable. * *

Sample code: * @@ -1742,8 +1742,8 @@ public final UnaryCallable deleteSubscriptionC * expire 10 seconds after the `ModifyAckDeadline` call 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). + * The minimum deadline you can specify is 0 seconds. The maximum deadline you can specify in + * a single request is 600 seconds (10 minutes). * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void modifyAckDeadline( @@ -1788,8 +1788,8 @@ public final void modifyAckDeadline( * expire 10 seconds after the `ModifyAckDeadline` call 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). + * The minimum deadline you can specify is 0 seconds. The maximum deadline you can specify in + * a single request is 600 seconds (10 minutes). * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void modifyAckDeadline( @@ -3380,9 +3380,9 @@ public final UnaryCallable createSnapshotCallab // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing snapshot. Snapshots are used in - * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to - * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * Updates an existing snapshot by updating the fields specified in the update mask. Snapshots are + * used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow + * you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: @@ -3413,9 +3413,9 @@ public final Snapshot updateSnapshot(Snapshot snapshot, FieldMask updateMask) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing snapshot. Snapshots are used in - * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to - * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * Updates an existing snapshot by updating the fields specified in the update mask. Snapshots are + * used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow + * you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: @@ -3445,9 +3445,9 @@ public final Snapshot updateSnapshot(UpdateSnapshotRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing snapshot. Snapshots are used in - * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to - * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of + * Updates an existing snapshot by updating the fields specified in the update mask. Snapshots are + * used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow + * you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of * messages in an existing subscription to the state captured by a snapshot. * *

Sample code: diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java index 4e2652585..a80ed29ec 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -81,221 +81,221 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * *

MethodsMethods
MethodDescriptionMethod Variants
CreateSubscription

CreateSubscription

Creates a subscription to a given topic. See the [resource name rules] (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names). If the subscription already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns `NOT_FOUND`. *

If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic, conforming to the [resource name format] (https://cloud.google.com/pubsub/docs/pubsub-basics#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.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createSubscription(Subscription request) + *

  • createSubscription(Subscription request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createSubscription(SubscriptionName name, TopicName topic, PushConfig pushConfig, int ackDeadlineSeconds) - *
  • createSubscription(SubscriptionName name, String topic, PushConfig pushConfig, int ackDeadlineSeconds) - *
  • createSubscription(String name, TopicName topic, PushConfig pushConfig, int ackDeadlineSeconds) - *
  • createSubscription(String name, String topic, PushConfig pushConfig, int ackDeadlineSeconds) + *

  • createSubscription(SubscriptionName name, TopicName topic, PushConfig pushConfig, int ackDeadlineSeconds) + *

  • createSubscription(SubscriptionName name, String topic, PushConfig pushConfig, int ackDeadlineSeconds) + *

  • createSubscription(String name, TopicName topic, PushConfig pushConfig, int ackDeadlineSeconds) + *

  • createSubscription(String name, String topic, PushConfig pushConfig, int ackDeadlineSeconds) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createSubscriptionCallable() + *

  • createSubscriptionCallable() *

*
GetSubscription

GetSubscription

Gets the configuration details of a subscription.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getSubscription(GetSubscriptionRequest request) + *

  • getSubscription(GetSubscriptionRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getSubscription(SubscriptionName subscription) - *
  • getSubscription(String subscription) + *

  • getSubscription(SubscriptionName subscription) + *

  • getSubscription(String subscription) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getSubscriptionCallable() + *

  • getSubscriptionCallable() *

*
UpdateSubscription

Updates an existing subscription. Note that certain properties of a subscription, such as its topic, are not modifiable.

UpdateSubscription

Updates an existing subscription by updating the fields specified in the update mask. Note that certain properties of a subscription, such as its topic, are not modifiable.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSubscription(UpdateSubscriptionRequest request) + *

  • updateSubscription(UpdateSubscriptionRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSubscription(Subscription subscription, FieldMask updateMask) + *

  • updateSubscription(Subscription subscription, FieldMask updateMask) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateSubscriptionCallable() + *

  • updateSubscriptionCallable() *

*
ListSubscriptions

ListSubscriptions

Lists matching subscriptions.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSubscriptions(ListSubscriptionsRequest request) + *

  • listSubscriptions(ListSubscriptionsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSubscriptions(ProjectName project) - *
  • listSubscriptions(String project) + *

  • listSubscriptions(ProjectName project) + *

  • listSubscriptions(String project) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listSubscriptionsPagedCallable() - *
  • listSubscriptionsCallable() + *

  • listSubscriptionsPagedCallable() + *

  • listSubscriptionsCallable() *

*
DeleteSubscription

DeleteSubscription

Deletes an existing subscription. All messages retained in the subscription are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`. After a subscription is deleted, a new one may be created with the same name, but the new one has no association with the old subscription or its topic unless the same topic is specified.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteSubscription(DeleteSubscriptionRequest request) + *

  • deleteSubscription(DeleteSubscriptionRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteSubscription(SubscriptionName subscription) - *
  • deleteSubscription(String subscription) + *

  • deleteSubscription(SubscriptionName subscription) + *

  • deleteSubscription(String subscription) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • deleteSubscriptionCallable() + *

  • deleteSubscriptionCallable() *

*
ModifyAckDeadline

ModifyAckDeadline

Modifies the ack deadline for a specific message. This method is useful to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted. Note that this does not modify the subscription-level `ackDeadlineSeconds` used for subsequent messages.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • modifyAckDeadline(ModifyAckDeadlineRequest request) + *

  • modifyAckDeadline(ModifyAckDeadlineRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • modifyAckDeadline(SubscriptionName subscription, List<String> ackIds, int ackDeadlineSeconds) - *
  • modifyAckDeadline(String subscription, List<String> ackIds, int ackDeadlineSeconds) + *

  • modifyAckDeadline(SubscriptionName subscription, List<String> ackIds, int ackDeadlineSeconds) + *

  • modifyAckDeadline(String subscription, List<String> ackIds, int ackDeadlineSeconds) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • modifyAckDeadlineCallable() + *

  • modifyAckDeadlineCallable() *

*
Acknowledge

Acknowledge

Acknowledges the messages associated with the `ack_ids` in the `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages from the subscription. *

Acknowledging a message whose ack deadline has expired may succeed, but such a message may be redelivered later. Acknowledging a message more than once will not result in an error.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • acknowledge(AcknowledgeRequest request) + *

  • acknowledge(AcknowledgeRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • acknowledge(SubscriptionName subscription, List<String> ackIds) - *
  • acknowledge(String subscription, List<String> ackIds) + *

  • acknowledge(SubscriptionName subscription, List<String> ackIds) + *

  • acknowledge(String subscription, List<String> ackIds) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • acknowledgeCallable() + *

  • acknowledgeCallable() *

*
Pull

Pull

Pulls messages from the server.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • pull(PullRequest request) + *

  • pull(PullRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • pull(SubscriptionName subscription, int maxMessages) - *
  • pull(String subscription, int maxMessages) - *
  • pull(SubscriptionName subscription, boolean returnImmediately, int maxMessages) - *
  • pull(String subscription, boolean returnImmediately, int maxMessages) + *

  • pull(SubscriptionName subscription, int maxMessages) + *

  • pull(String subscription, int maxMessages) + *

  • pull(SubscriptionName subscription, boolean returnImmediately, int maxMessages) + *

  • pull(String subscription, boolean returnImmediately, int maxMessages) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • pullCallable() + *

  • pullCallable() *

*
StreamingPull

StreamingPull

Establishes a stream with the server, which sends messages down to the client. The client streams acknowledgements and ack deadline modifications back to the server. The server will close the stream and return the status on any error. The server may close the stream with status `UNAVAILABLE` to reassign server-side resources, in which case, the client should re-establish the stream. Flow control can be achieved by configuring the underlying RPC channel.

 *

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • streamingPullCallable() + *

  • streamingPullCallable() *

*
ModifyPushConfig

ModifyPushConfig

Modifies the `PushConfig` for a specified subscription. *

This may be used to change a push subscription to a pull one (signified by an empty `PushConfig`) or vice versa, or change the endpoint URL and other attributes of a push subscription. Messages will accumulate for delivery continuously through the call regardless of changes to the `PushConfig`.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • modifyPushConfig(ModifyPushConfigRequest request) + *

  • modifyPushConfig(ModifyPushConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • modifyPushConfig(SubscriptionName subscription, PushConfig pushConfig) - *
  • modifyPushConfig(String subscription, PushConfig pushConfig) + *

  • modifyPushConfig(SubscriptionName subscription, PushConfig pushConfig) + *

  • modifyPushConfig(String subscription, PushConfig pushConfig) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • modifyPushConfigCallable() + *

  • modifyPushConfigCallable() *

*
GetSnapshot

GetSnapshot

Gets the configuration details of a snapshot. Snapshots are used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getSnapshot(GetSnapshotRequest request) + *

  • getSnapshot(GetSnapshotRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getSnapshot(SnapshotName snapshot) - *
  • getSnapshot(String snapshot) + *

  • getSnapshot(SnapshotName snapshot) + *

  • getSnapshot(String snapshot) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getSnapshotCallable() + *

  • getSnapshotCallable() *

*
ListSnapshots

ListSnapshots

Lists the existing snapshots. Snapshots are used in [Seek]( https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSnapshots(ListSnapshotsRequest request) + *

  • listSnapshots(ListSnapshotsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSnapshots(ProjectName project) - *
  • listSnapshots(String project) + *

  • listSnapshots(ProjectName project) + *

  • listSnapshots(String project) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listSnapshotsPagedCallable() - *
  • listSnapshotsCallable() + *

  • listSnapshotsPagedCallable() + *

  • listSnapshotsCallable() *

*
CreateSnapshot

CreateSnapshot

Creates a snapshot from the requested subscription. Snapshots are used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot. If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the `Snapshot.expire_time` field. If the name is not provided in the request, the server will assign a random name for this snapshot on the same project as the subscription, conforming to the [resource name format] (https://cloud.google.com/pubsub/docs/pubsub-basics#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.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createSnapshot(CreateSnapshotRequest request) + *

  • createSnapshot(CreateSnapshotRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createSnapshot(SnapshotName name, SubscriptionName subscription) - *
  • createSnapshot(SnapshotName name, String subscription) - *
  • createSnapshot(String name, SubscriptionName subscription) - *
  • createSnapshot(String name, String subscription) + *

  • createSnapshot(SnapshotName name, SubscriptionName subscription) + *

  • createSnapshot(SnapshotName name, String subscription) + *

  • createSnapshot(String name, SubscriptionName subscription) + *

  • createSnapshot(String name, String subscription) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createSnapshotCallable() + *

  • createSnapshotCallable() *

*
UpdateSnapshot

Updates an existing snapshot. Snapshots are used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.

UpdateSnapshot

Updates an existing snapshot by updating the fields specified in the update mask. Snapshots are used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSnapshot(UpdateSnapshotRequest request) + *

  • updateSnapshot(UpdateSnapshotRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSnapshot(Snapshot snapshot, FieldMask updateMask) + *

  • updateSnapshot(Snapshot snapshot, FieldMask updateMask) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateSnapshotCallable() + *

  • updateSnapshotCallable() *

*
DeleteSnapshot

DeleteSnapshot

Removes an existing snapshot. Snapshots are used in [Seek] (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with the same name, but the new one has no association with the old snapshot or its subscription, unless the same subscription is specified.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteSnapshot(DeleteSnapshotRequest request) + *

  • deleteSnapshot(DeleteSnapshotRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteSnapshot(SnapshotName snapshot) - *
  • deleteSnapshot(String snapshot) + *

  • deleteSnapshot(SnapshotName snapshot) + *

  • deleteSnapshot(String snapshot) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • deleteSnapshotCallable() + *

  • deleteSnapshotCallable() *

*
Seek

Seek

Seeks an existing subscription to a point in time or to a given snapshot, whichever is provided in the request. Snapshots are used in [Seek] (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot. Note that both the subscription and the snapshot must be on the same topic.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • seek(SeekRequest request) + *

  • seek(SeekRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • seekCallable() + *

  • seekCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *

  • setIamPolicy(SetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setIamPolicyCallable() + *

  • setIamPolicyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *

  • getIamPolicy(GetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getIamPolicyCallable() + *

  • getIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *

  • testIamPermissions(TestIamPermissionsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • testIamPermissionsCallable() + *

  • testIamPermissionsCallable() *

*
- * + * * * * * * * - * + * * * * * - * - * + * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * @@ -515,6 +515,7 @@ public final Topic createTopic(ProjectTopicName name) { * .setSchemaSettings(SchemaSettings.newBuilder().build()) * .setSatisfiesPzs(true) * .setMessageRetentionDuration(Duration.newBuilder().build()) + * .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) * .build(); * Topic response = topicAdminClient.createTopic(request); * } @@ -550,6 +551,7 @@ public final Topic createTopic(Topic request) { * .setSchemaSettings(SchemaSettings.newBuilder().build()) * .setSatisfiesPzs(true) * .setMessageRetentionDuration(Duration.newBuilder().build()) + * .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) * .build(); * ApiFuture future = topicAdminClient.createTopicCallable().futureCall(request); * // Do something. @@ -563,7 +565,8 @@ public final UnaryCallable createTopicCallable() { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing topic. Note that certain properties of a topic are not modifiable. + * Updates an existing topic by updating the fields specified in the update mask. Note that + * certain properties of a topic are not modifiable. * *

Sample code: * @@ -595,7 +598,8 @@ public final Topic updateTopic(Topic topic, FieldMask updateMask) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing topic. Note that certain properties of a topic are not modifiable. + * Updates an existing topic by updating the fields specified in the update mask. Note that + * certain properties of a topic are not modifiable. * *

Sample code: * @@ -624,7 +628,8 @@ public final Topic updateTopic(UpdateTopicRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Updates an existing topic. Note that certain properties of a topic are not modifiable. + * Updates an existing topic by updating the fields specified in the update mask. Note that + * certain properties of a topic are not modifiable. * *

Sample code: * diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/PublisherStubSettings.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/PublisherStubSettings.java index f3c495688..262a09205 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/PublisherStubSettings.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/PublisherStubSettings.java @@ -480,6 +480,15 @@ public PublisherStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -760,7 +769,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -773,7 +781,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -941,6 +948,15 @@ public UnaryCallSettings.Builder getIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public PublisherStubSettings build() throws IOException { return new PublisherStubSettings(this); diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SchemaServiceStubSettings.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SchemaServiceStubSettings.java index 8b036328d..bb5e127d3 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SchemaServiceStubSettings.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SchemaServiceStubSettings.java @@ -340,6 +340,15 @@ public SchemaServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -591,7 +600,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -604,7 +612,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -770,6 +777,15 @@ public UnaryCallSettings.Builder getIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SchemaServiceStubSettings build() throws IOException { return new SchemaServiceStubSettings(this); diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SubscriberStubSettings.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SubscriberStubSettings.java index c517f17d6..93122a831 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SubscriberStubSettings.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/stub/SubscriberStubSettings.java @@ -385,6 +385,15 @@ public SubscriberStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -721,7 +730,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -734,7 +742,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -954,6 +961,15 @@ public UnaryCallSettings.Builder getIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SubscriberStubSettings build() throws IOException { return new SubscriberStubSettings(this); diff --git a/google-cloud-pubsub/src/main/resources/META-INF/native-image/com.google.cloud.pubsub.v1/reflect-config.json b/google-cloud-pubsub/src/main/resources/META-INF/native-image/com.google.cloud.pubsub.v1/reflect-config.json index 8fd73b027..441c326d2 100644 --- a/google-cloud-pubsub/src/main/resources/META-INF/native-image/com.google.cloud.pubsub.v1/reflect-config.json +++ b/google-cloud-pubsub/src/main/resources/META-INF/native-image/com.google.cloud.pubsub.v1/reflect-config.json @@ -1691,6 +1691,51 @@ "allDeclaredClasses": true, "allPublicClasses": true }, + { + "name": "com.google.pubsub.v1.IngestionDataSourceSettings", + "queryAllDeclaredConstructors": true, + "queryAllPublicConstructors": true, + "queryAllDeclaredMethods": true, + "allPublicMethods": true, + "allDeclaredClasses": true, + "allPublicClasses": true + }, + { + "name": "com.google.pubsub.v1.IngestionDataSourceSettings$AwsKinesis", + "queryAllDeclaredConstructors": true, + "queryAllPublicConstructors": true, + "queryAllDeclaredMethods": true, + "allPublicMethods": true, + "allDeclaredClasses": true, + "allPublicClasses": true + }, + { + "name": "com.google.pubsub.v1.IngestionDataSourceSettings$AwsKinesis$Builder", + "queryAllDeclaredConstructors": true, + "queryAllPublicConstructors": true, + "queryAllDeclaredMethods": true, + "allPublicMethods": true, + "allDeclaredClasses": true, + "allPublicClasses": true + }, + { + "name": "com.google.pubsub.v1.IngestionDataSourceSettings$AwsKinesis$State", + "queryAllDeclaredConstructors": true, + "queryAllPublicConstructors": true, + "queryAllDeclaredMethods": true, + "allPublicMethods": true, + "allDeclaredClasses": true, + "allPublicClasses": true + }, + { + "name": "com.google.pubsub.v1.IngestionDataSourceSettings$Builder", + "queryAllDeclaredConstructors": true, + "queryAllPublicConstructors": true, + "queryAllDeclaredMethods": true, + "allPublicMethods": true, + "allDeclaredClasses": true, + "allPublicClasses": true + }, { "name": "com.google.pubsub.v1.ListSchemaRevisionsRequest", "queryAllDeclaredConstructors": true, @@ -2456,6 +2501,15 @@ "allDeclaredClasses": true, "allPublicClasses": true }, + { + "name": "com.google.pubsub.v1.Topic$State", + "queryAllDeclaredConstructors": true, + "queryAllPublicConstructors": true, + "queryAllDeclaredMethods": true, + "allPublicMethods": true, + "allDeclaredClasses": true, + "allPublicClasses": true + }, { "name": "com.google.pubsub.v1.UpdateSnapshotRequest", "queryAllDeclaredConstructors": true, diff --git a/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientHttpJsonTest.java b/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientHttpJsonTest.java index c18152b5d..2dc4d6e09 100644 --- a/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientHttpJsonTest.java +++ b/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientHttpJsonTest.java @@ -45,6 +45,7 @@ import com.google.protobuf.FieldMask; import com.google.pubsub.v1.DetachSubscriptionRequest; import com.google.pubsub.v1.DetachSubscriptionResponse; +import com.google.pubsub.v1.IngestionDataSourceSettings; import com.google.pubsub.v1.ListTopicSnapshotsResponse; import com.google.pubsub.v1.ListTopicSubscriptionsResponse; import com.google.pubsub.v1.ListTopicsResponse; @@ -115,6 +116,7 @@ public void createTopicTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockService.addResponse(expectedResponse); @@ -165,6 +167,7 @@ public void createTopicTest2() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockService.addResponse(expectedResponse); @@ -215,6 +218,7 @@ public void updateTopicTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockService.addResponse(expectedResponse); @@ -227,6 +231,7 @@ public void updateTopicTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); FieldMask updateMask = FieldMask.newBuilder().build(); @@ -265,6 +270,7 @@ public void updateTopicExceptionTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); FieldMask updateMask = FieldMask.newBuilder().build(); client.updateTopic(topic, updateMask); @@ -373,6 +379,7 @@ public void getTopicTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockService.addResponse(expectedResponse); @@ -423,6 +430,7 @@ public void getTopicTest2() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockService.addResponse(expectedResponse); diff --git a/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientTest.java b/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientTest.java index 1693f7e40..44a9c11c5 100644 --- a/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientTest.java +++ b/google-cloud-pubsub/src/test/java/com/google/cloud/pubsub/v1/TopicAdminClientTest.java @@ -45,6 +45,7 @@ import com.google.pubsub.v1.DetachSubscriptionRequest; import com.google.pubsub.v1.DetachSubscriptionResponse; import com.google.pubsub.v1.GetTopicRequest; +import com.google.pubsub.v1.IngestionDataSourceSettings; import com.google.pubsub.v1.ListTopicSnapshotsRequest; import com.google.pubsub.v1.ListTopicSnapshotsResponse; import com.google.pubsub.v1.ListTopicSubscriptionsRequest; @@ -129,6 +130,7 @@ public void createTopicTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockPublisher.addResponse(expectedResponse); @@ -173,6 +175,7 @@ public void createTopicTest2() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockPublisher.addResponse(expectedResponse); @@ -217,6 +220,7 @@ public void updateTopicTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockPublisher.addResponse(expectedResponse); @@ -342,6 +346,7 @@ public void getTopicTest() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockPublisher.addResponse(expectedResponse); @@ -386,6 +391,7 @@ public void getTopicTest2() throws Exception { .setSchemaSettings(SchemaSettings.newBuilder().build()) .setSatisfiesPzs(true) .setMessageRetentionDuration(Duration.newBuilder().build()) + .setIngestionDataSourceSettings(IngestionDataSourceSettings.newBuilder().build()) .build(); mockPublisher.addResponse(expectedResponse); diff --git a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java index 020bf6f9d..18d2202b1 100644 --- a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java +++ b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -479,8 +479,8 @@ default void createTopic( * * * 

-     * Updates an existing topic. Note that certain properties of a
-     * topic are not modifiable.
+     * Updates an existing topic by updating the fields specified in the update
+     * mask. Note that certain properties of a topic are not modifiable.
      *
*/ default void updateTopic( @@ -656,8 +656,8 @@ public void createTopic( * * * 
-     * Updates an existing topic. Note that certain properties of a
-     * topic are not modifiable.
+     * Updates an existing topic by updating the fields specified in the update
+     * mask. Note that certain properties of a topic are not modifiable.
      *
*/ public void updateTopic( @@ -828,8 +828,8 @@ public com.google.pubsub.v1.Topic createTopic(com.google.pubsub.v1.Topic request * * * 
-     * Updates an existing topic. Note that certain properties of a
-     * topic are not modifiable.
+     * Updates an existing topic by updating the fields specified in the update
+     * mask. Note that certain properties of a topic are not modifiable.
      *
*/ public com.google.pubsub.v1.Topic updateTopic(com.google.pubsub.v1.UpdateTopicRequest request) { @@ -976,8 +976,8 @@ protected PublisherFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions * * * 
-     * Updates an existing topic. Note that certain properties of a
-     * topic are not modifiable.
+     * Updates an existing topic by updating the fields specified in the update
+     * mask. Note that certain properties of a topic are not modifiable.
      *
*/ public com.google.common.util.concurrent.ListenableFuture diff --git a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaServiceGrpc.java b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaServiceGrpc.java index 3b11ea3dc..ab612d2c5 100644 --- a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaServiceGrpc.java +++ b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaServiceGrpc.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java index c90e438e8..3bf65b4e3 100644 --- a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java +++ b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriberGrpc.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -778,8 +778,9 @@ default void getSubscription( * * * 
-     * Updates an existing subscription. Note that certain properties of a
-     * subscription, such as its topic, are not modifiable.
+     * Updates an existing subscription by updating the fields specified in the
+     * update mask. Note that certain properties of a subscription, such as its
+     * topic, are not modifiable.
      *
*/ default void updateSubscription( @@ -978,7 +979,8 @@ default void createSnapshot( * * * 
-     * Updates an existing snapshot. Snapshots are used in
+     * Updates an existing snapshot by updating the fields specified in the update
+     * mask. Snapshots are used in
      * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
      * which allow you to manage message acknowledgments in bulk. That is, you can
      * set the acknowledgment state of messages in an existing subscription to the
@@ -1115,8 +1117,9 @@ public void getSubscription(
      *
      *
      * 
-     * Updates an existing subscription. Note that certain properties of a
-     * subscription, such as its topic, are not modifiable.
+     * Updates an existing subscription by updating the fields specified in the
+     * update mask. Note that certain properties of a subscription, such as its
+     * topic, are not modifiable.
      * 

      */
     public void updateSubscription(
@@ -1334,7 +1337,8 @@ public void createSnapshot(
      *
      *
      * 
-     * Updates an existing snapshot. Snapshots are used in
+     * Updates an existing snapshot by updating the fields specified in the update
+     * mask. Snapshots are used in
      * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
      * which allow you to manage message acknowledgments in bulk. That is, you can
      * set the acknowledgment state of messages in an existing subscription to the
@@ -1455,8 +1459,9 @@ public com.google.pubsub.v1.Subscription getSubscription(
      *
      *
      * 
-     * Updates an existing subscription. Note that certain properties of a
-     * subscription, such as its topic, are not modifiable.
+     * Updates an existing subscription by updating the fields specified in the
+     * update mask. Note that certain properties of a subscription, such as its
+     * topic, are not modifiable.
      * 

      */
     public com.google.pubsub.v1.Subscription updateSubscription(
@@ -1624,7 +1629,8 @@ public com.google.pubsub.v1.Snapshot createSnapshot(
      *
      *
      * 
-     * Updates an existing snapshot. Snapshots are used in
+     * Updates an existing snapshot by updating the fields specified in the update
+     * mask. Snapshots are used in
      * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
      * which allow you to manage message acknowledgments in bulk. That is, you can
      * set the acknowledgment state of messages in an existing subscription to the
@@ -1736,8 +1742,9 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
      *
      *
      * 
-     * Updates an existing subscription. Note that certain properties of a
-     * subscription, such as its topic, are not modifiable.
+     * Updates an existing subscription by updating the fields specified in the
+     * update mask. Note that certain properties of a subscription, such as its
+     * topic, are not modifiable.
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1909,7 +1916,8 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
      *
      *
      * 
-     * Updates an existing snapshot. Snapshots are used in
+     * Updates an existing snapshot by updating the fields specified in the update
+     * mask. Snapshots are used in
      * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
      * which allow you to manage message acknowledgments in bulk. That is, you can
      * set the acknowledgment state of messages in an existing subscription to the
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequest.java
index ad61b3fa8..f118acddd 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequestOrBuilder.java
index b2e049435..ef4ff0f2c 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/AcknowledgeRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfig.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfig.java
index 2683f75df..8bc70c28b 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfig.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfig.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -128,6 +128,17 @@ public enum State implements com.google.protobuf.ProtocolMessageEnum {
      * SCHEMA_MISMATCH = 4;
      */
     SCHEMA_MISMATCH(4),
+    /**
+     *
+     *
+     * 
+     * Cannot write to the destination because enforce_in_transit is set to true
+     * and the destination locations are not in the allowed regions.
+     * 

+     *
+     * IN_TRANSIT_LOCATION_RESTRICTION = 5;
+     */
+    IN_TRANSIT_LOCATION_RESTRICTION(5),
     UNRECOGNIZED(-1),
     ;
 
@@ -186,6 +197,17 @@ public enum State implements com.google.protobuf.ProtocolMessageEnum {
      * SCHEMA_MISMATCH = 4;
      */
     public static final int SCHEMA_MISMATCH_VALUE = 4;
+    /**
+     *
+     *
+     * 
+     * Cannot write to the destination because enforce_in_transit is set to true
+     * and the destination locations are not in the allowed regions.
+     * 

+     *
+     * IN_TRANSIT_LOCATION_RESTRICTION = 5;
+     */
+    public static final int IN_TRANSIT_LOCATION_RESTRICTION_VALUE = 5;
 
     public final int getNumber() {
       if (this == UNRECOGNIZED) {
@@ -221,6 +243,8 @@ public static State forNumber(int value) {
           return NOT_FOUND;
         case 4:
           return SCHEMA_MISMATCH;
+        case 5:
+          return IN_TRANSIT_LOCATION_RESTRICTION;
         default:
           return null;
       }
@@ -282,11 +306,11 @@ private State(int value) {
    *
    *
    * 
-   * The name of the table to which to write data, of the form
+   * Optional. The name of the table to which to write data, of the form
    * {projectId}.{datasetId}.{tableId}
    * 

    *
-   * string table = 1;
+   * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The table.
    */
@@ -306,11 +330,11 @@ public java.lang.String getTable() {
    *
    *
    * 
-   * The name of the table to which to write data, of the form
+   * Optional. The name of the table to which to write data, of the form
    * {projectId}.{datasetId}.{tableId}
    * 

    *
-   * string table = 1;
+   * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for table.
    */
@@ -353,14 +377,14 @@ public boolean getUseTopicSchema() {
    *
    *
    * 
-   * When true, write the subscription name, message_id, publish_time,
+   * Optional. When true, write the subscription name, message_id, publish_time,
    * attributes, and ordering_key to additional columns in the table. The
    * subscription name, message_id, and publish_time fields are put in their own
    * columns while all other message properties (other than data) are written to
    * a JSON object in the attributes column.
    * 

    *
-   * bool write_metadata = 3;
+   * bool write_metadata = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The writeMetadata.
    */
@@ -375,14 +399,14 @@ public boolean getWriteMetadata() {
    *
    *
    * 
-   * When true and use_topic_schema is true, any fields that are a part of the
-   * topic schema that are not part of the BigQuery table schema are dropped
-   * when writing to BigQuery. Otherwise, the schemas must be kept in sync and
-   * any messages with extra fields are not written and remain in the
+   * Optional. When true and use_topic_schema is true, any fields that are a
+   * part of the topic schema that are not part of the BigQuery table schema are
+   * dropped when writing to BigQuery. Otherwise, the schemas must be kept in
+   * sync and any messages with extra fields are not written and remain in the
    * subscription's backlog.
    * 

    *
-   * bool drop_unknown_fields = 4;
+   * bool drop_unknown_fields = 4 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The dropUnknownFields.
    */
@@ -905,11 +929,11 @@ public Builder mergeFrom(
      *
      *
      * 
-     * The name of the table to which to write data, of the form
+     * Optional. The name of the table to which to write data, of the form
      * {projectId}.{datasetId}.{tableId}
      * 

      *
-     * string table = 1;
+     * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The table.
      */
@@ -928,11 +952,11 @@ public java.lang.String getTable() {
      *
      *
      * 
-     * The name of the table to which to write data, of the form
+     * Optional. The name of the table to which to write data, of the form
      * {projectId}.{datasetId}.{tableId}
      * 

      *
-     * string table = 1;
+     * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for table.
      */
@@ -951,11 +975,11 @@ public com.google.protobuf.ByteString getTableBytes() {
      *
      *
      * 
-     * The name of the table to which to write data, of the form
+     * Optional. The name of the table to which to write data, of the form
      * {projectId}.{datasetId}.{tableId}
      * 

      *
-     * string table = 1;
+     * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The table to set.
      * @return This builder for chaining.
@@ -973,11 +997,11 @@ public Builder setTable(java.lang.String value) {
      *
      *
      * 
-     * The name of the table to which to write data, of the form
+     * Optional. The name of the table to which to write data, of the form
      * {projectId}.{datasetId}.{tableId}
      * 

      *
-     * string table = 1;
+     * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -991,11 +1015,11 @@ public Builder clearTable() {
      *
      *
      * 
-     * The name of the table to which to write data, of the form
+     * Optional. The name of the table to which to write data, of the form
      * {projectId}.{datasetId}.{tableId}
      * 

      *
-     * string table = 1;
+     * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for table to set.
      * @return This builder for chaining.
@@ -1075,14 +1099,14 @@ public Builder clearUseTopicSchema() {
      *
      *
      * 
-     * When true, write the subscription name, message_id, publish_time,
+     * Optional. When true, write the subscription name, message_id, publish_time,
      * attributes, and ordering_key to additional columns in the table. The
      * subscription name, message_id, and publish_time fields are put in their own
      * columns while all other message properties (other than data) are written to
      * a JSON object in the attributes column.
      * 

      *
-     * bool write_metadata = 3;
+     * bool write_metadata = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The writeMetadata.
      */
@@ -1094,14 +1118,14 @@ public boolean getWriteMetadata() {
      *
      *
      * 
-     * When true, write the subscription name, message_id, publish_time,
+     * Optional. When true, write the subscription name, message_id, publish_time,
      * attributes, and ordering_key to additional columns in the table. The
      * subscription name, message_id, and publish_time fields are put in their own
      * columns while all other message properties (other than data) are written to
      * a JSON object in the attributes column.
      * 

      *
-     * bool write_metadata = 3;
+     * bool write_metadata = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The writeMetadata to set.
      * @return This builder for chaining.
@@ -1117,14 +1141,14 @@ public Builder setWriteMetadata(boolean value) {
      *
      *
      * 
-     * When true, write the subscription name, message_id, publish_time,
+     * Optional. When true, write the subscription name, message_id, publish_time,
      * attributes, and ordering_key to additional columns in the table. The
      * subscription name, message_id, and publish_time fields are put in their own
      * columns while all other message properties (other than data) are written to
      * a JSON object in the attributes column.
      * 

      *
-     * bool write_metadata = 3;
+     * bool write_metadata = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -1140,14 +1164,14 @@ public Builder clearWriteMetadata() {
      *
      *
      * 
-     * When true and use_topic_schema is true, any fields that are a part of the
-     * topic schema that are not part of the BigQuery table schema are dropped
-     * when writing to BigQuery. Otherwise, the schemas must be kept in sync and
-     * any messages with extra fields are not written and remain in the
+     * Optional. When true and use_topic_schema is true, any fields that are a
+     * part of the topic schema that are not part of the BigQuery table schema are
+     * dropped when writing to BigQuery. Otherwise, the schemas must be kept in
+     * sync and any messages with extra fields are not written and remain in the
      * subscription's backlog.
      * 

      *
-     * bool drop_unknown_fields = 4;
+     * bool drop_unknown_fields = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The dropUnknownFields.
      */
@@ -1159,14 +1183,14 @@ public boolean getDropUnknownFields() {
      *
      *
      * 
-     * When true and use_topic_schema is true, any fields that are a part of the
-     * topic schema that are not part of the BigQuery table schema are dropped
-     * when writing to BigQuery. Otherwise, the schemas must be kept in sync and
-     * any messages with extra fields are not written and remain in the
+     * Optional. When true and use_topic_schema is true, any fields that are a
+     * part of the topic schema that are not part of the BigQuery table schema are
+     * dropped when writing to BigQuery. Otherwise, the schemas must be kept in
+     * sync and any messages with extra fields are not written and remain in the
      * subscription's backlog.
      * 

      *
-     * bool drop_unknown_fields = 4;
+     * bool drop_unknown_fields = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The dropUnknownFields to set.
      * @return This builder for chaining.
@@ -1182,14 +1206,14 @@ public Builder setDropUnknownFields(boolean value) {
      *
      *
      * 
-     * When true and use_topic_schema is true, any fields that are a part of the
-     * topic schema that are not part of the BigQuery table schema are dropped
-     * when writing to BigQuery. Otherwise, the schemas must be kept in sync and
-     * any messages with extra fields are not written and remain in the
+     * Optional. When true and use_topic_schema is true, any fields that are a
+     * part of the topic schema that are not part of the BigQuery table schema are
+     * dropped when writing to BigQuery. Otherwise, the schemas must be kept in
+     * sync and any messages with extra fields are not written and remain in the
      * subscription's backlog.
      * 

      *
-     * bool drop_unknown_fields = 4;
+     * bool drop_unknown_fields = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfigOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfigOrBuilder.java
index bc805214f..2742cc001 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfigOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/BigQueryConfigOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,11 +27,11 @@ public interface BigQueryConfigOrBuilder
    *
    *
    * 
-   * The name of the table to which to write data, of the form
+   * Optional. The name of the table to which to write data, of the form
    * {projectId}.{datasetId}.{tableId}
    * 

    *
-   * string table = 1;
+   * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The table.
    */
@@ -40,11 +40,11 @@ public interface BigQueryConfigOrBuilder
    *
    *
    * 
-   * The name of the table to which to write data, of the form
+   * Optional. The name of the table to which to write data, of the form
    * {projectId}.{datasetId}.{tableId}
    * 

    *
-   * string table = 1;
+   * string table = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for table.
    */
@@ -69,14 +69,14 @@ public interface BigQueryConfigOrBuilder
    *
    *
    * 
-   * When true, write the subscription name, message_id, publish_time,
+   * Optional. When true, write the subscription name, message_id, publish_time,
    * attributes, and ordering_key to additional columns in the table. The
    * subscription name, message_id, and publish_time fields are put in their own
    * columns while all other message properties (other than data) are written to
    * a JSON object in the attributes column.
    * 

    *
-   * bool write_metadata = 3;
+   * bool write_metadata = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The writeMetadata.
    */
@@ -86,14 +86,14 @@ public interface BigQueryConfigOrBuilder
    *
    *
    * 
-   * When true and use_topic_schema is true, any fields that are a part of the
-   * topic schema that are not part of the BigQuery table schema are dropped
-   * when writing to BigQuery. Otherwise, the schemas must be kept in sync and
-   * any messages with extra fields are not written and remain in the
+   * Optional. When true and use_topic_schema is true, any fields that are a
+   * part of the topic schema that are not part of the BigQuery table schema are
+   * dropped when writing to BigQuery. Otherwise, the schemas must be kept in
+   * sync and any messages with extra fields are not written and remain in the
    * subscription's backlog.
    * 

    *
-   * bool drop_unknown_fields = 4;
+   * bool drop_unknown_fields = 4 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The dropUnknownFields.
    */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfig.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfig.java
index a4532a62f..b44f9b427 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfig.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfig.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -116,6 +116,17 @@ public enum State implements com.google.protobuf.ProtocolMessageEnum {
      * NOT_FOUND = 3;
      */
     NOT_FOUND(3),
+    /**
+     *
+     *
+     * 
+     * Cannot write to the destination because enforce_in_transit is set to true
+     * and the destination locations are not in the allowed regions.
+     * 

+     *
+     * IN_TRANSIT_LOCATION_RESTRICTION = 4;
+     */
+    IN_TRANSIT_LOCATION_RESTRICTION(4),
     UNRECOGNIZED(-1),
     ;
 
@@ -160,6 +171,17 @@ public enum State implements com.google.protobuf.ProtocolMessageEnum {
      * NOT_FOUND = 3;
      */
     public static final int NOT_FOUND_VALUE = 3;
+    /**
+     *
+     *
+     * 
+     * Cannot write to the destination because enforce_in_transit is set to true
+     * and the destination locations are not in the allowed regions.
+     * 

+     *
+     * IN_TRANSIT_LOCATION_RESTRICTION = 4;
+     */
+    public static final int IN_TRANSIT_LOCATION_RESTRICTION_VALUE = 4;
 
     public final int getNumber() {
       if (this == UNRECOGNIZED) {
@@ -193,6 +215,8 @@ public static State forNumber(int value) {
           return PERMISSION_DENIED;
         case 3:
           return NOT_FOUND;
+        case 4:
+          return IN_TRANSIT_LOCATION_RESTRICTION;
         default:
           return null;
       }
@@ -681,15 +705,15 @@ public interface AvroConfigOrBuilder
      *
      *
      * 
-     * When true, write the subscription name, message_id, publish_time,
-     * attributes, and ordering_key as additional fields in the output. The
-     * subscription name, message_id, and publish_time fields are put in their
-     * own fields while all other message properties other than data (for
-     * example, an ordering_key, if present) are added as entries in the
-     * attributes map.
+     * Optional. When true, write the subscription name, message_id,
+     * publish_time, attributes, and ordering_key as additional fields in the
+     * output. The subscription name, message_id, and publish_time fields are
+     * put in their own fields while all other message properties other than
+     * data (for example, an ordering_key, if present) are added as entries in
+     * the attributes map.
      * 

      *
-     * bool write_metadata = 1;
+     * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The writeMetadata.
      */
@@ -744,15 +768,15 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      *
      *
      * 
-     * When true, write the subscription name, message_id, publish_time,
-     * attributes, and ordering_key as additional fields in the output. The
-     * subscription name, message_id, and publish_time fields are put in their
-     * own fields while all other message properties other than data (for
-     * example, an ordering_key, if present) are added as entries in the
-     * attributes map.
+     * Optional. When true, write the subscription name, message_id,
+     * publish_time, attributes, and ordering_key as additional fields in the
+     * output. The subscription name, message_id, and publish_time fields are
+     * put in their own fields while all other message properties other than
+     * data (for example, an ordering_key, if present) are added as entries in
+     * the attributes map.
      * 

      *
-     * bool write_metadata = 1;
+     * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The writeMetadata.
      */
@@ -1111,15 +1135,15 @@ public Builder mergeFrom(
        *
        *
        * 
-       * When true, write the subscription name, message_id, publish_time,
-       * attributes, and ordering_key as additional fields in the output. The
-       * subscription name, message_id, and publish_time fields are put in their
-       * own fields while all other message properties other than data (for
-       * example, an ordering_key, if present) are added as entries in the
-       * attributes map.
+       * Optional. When true, write the subscription name, message_id,
+       * publish_time, attributes, and ordering_key as additional fields in the
+       * output. The subscription name, message_id, and publish_time fields are
+       * put in their own fields while all other message properties other than
+       * data (for example, an ordering_key, if present) are added as entries in
+       * the attributes map.
        * 

        *
-       * bool write_metadata = 1;
+       * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return The writeMetadata.
        */
@@ -1131,15 +1155,15 @@ public boolean getWriteMetadata() {
        *
        *
        * 
-       * When true, write the subscription name, message_id, publish_time,
-       * attributes, and ordering_key as additional fields in the output. The
-       * subscription name, message_id, and publish_time fields are put in their
-       * own fields while all other message properties other than data (for
-       * example, an ordering_key, if present) are added as entries in the
-       * attributes map.
+       * Optional. When true, write the subscription name, message_id,
+       * publish_time, attributes, and ordering_key as additional fields in the
+       * output. The subscription name, message_id, and publish_time fields are
+       * put in their own fields while all other message properties other than
+       * data (for example, an ordering_key, if present) are added as entries in
+       * the attributes map.
        * 

        *
-       * bool write_metadata = 1;
+       * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The writeMetadata to set.
        * @return This builder for chaining.
@@ -1155,15 +1179,15 @@ public Builder setWriteMetadata(boolean value) {
        *
        *
        * 
-       * When true, write the subscription name, message_id, publish_time,
-       * attributes, and ordering_key as additional fields in the output. The
-       * subscription name, message_id, and publish_time fields are put in their
-       * own fields while all other message properties other than data (for
-       * example, an ordering_key, if present) are added as entries in the
-       * attributes map.
+       * Optional. When true, write the subscription name, message_id,
+       * publish_time, attributes, and ordering_key as additional fields in the
+       * output. The subscription name, message_id, and publish_time fields are
+       * put in their own fields while all other message properties other than
+       * data (for example, an ordering_key, if present) are added as entries in
+       * the attributes map.
        * 

        *
-       * bool write_metadata = 1;
+       * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return This builder for chaining.
        */
@@ -1352,11 +1376,11 @@ public com.google.protobuf.ByteString getBucketBytes() {
    *
    *
    * 
-   * User-provided prefix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Optional. User-provided prefix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
    * 

    *
-   * string filename_prefix = 2;
+   * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The filenamePrefix.
    */
@@ -1376,11 +1400,11 @@ public java.lang.String getFilenamePrefix() {
    *
    *
    * 
-   * User-provided prefix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Optional. User-provided prefix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
    * 

    *
-   * string filename_prefix = 2;
+   * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for filenamePrefix.
    */
@@ -1405,12 +1429,12 @@ public com.google.protobuf.ByteString getFilenamePrefixBytes() {
    *
    *
    * 
-   * User-provided suffix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-   * not end in "/".
+   * Optional. User-provided suffix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Must not end in "/".
    * 

    *
-   * string filename_suffix = 3;
+   * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The filenameSuffix.
    */
@@ -1430,12 +1454,12 @@ public java.lang.String getFilenameSuffix() {
    *
    *
    * 
-   * User-provided suffix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-   * not end in "/".
+   * Optional. User-provided suffix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Must not end in "/".
    * 

    *
-   * string filename_suffix = 3;
+   * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for filenameSuffix.
    */
@@ -1457,10 +1481,13 @@ public com.google.protobuf.ByteString getFilenameSuffixBytes() {
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in text format.
+   * Optional. If set, message data will be written to Cloud Storage in text
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the textConfig field is set.
    */
@@ -1472,10 +1499,13 @@ public boolean hasTextConfig() {
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in text format.
+   * Optional. If set, message data will be written to Cloud Storage in text
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The textConfig.
    */
@@ -1490,10 +1520,13 @@ public com.google.pubsub.v1.CloudStorageConfig.TextConfig getTextConfig() {
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in text format.
+   * Optional. If set, message data will be written to Cloud Storage in text
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.CloudStorageConfig.TextConfigOrBuilder getTextConfigOrBuilder() {
@@ -1508,10 +1541,13 @@ public com.google.pubsub.v1.CloudStorageConfig.TextConfigOrBuilder getTextConfig
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in Avro format.
+   * Optional. If set, message data will be written to Cloud Storage in Avro
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the avroConfig field is set.
    */
@@ -1523,10 +1559,13 @@ public boolean hasAvroConfig() {
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in Avro format.
+   * Optional. If set, message data will be written to Cloud Storage in Avro
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The avroConfig.
    */
@@ -1541,10 +1580,13 @@ public com.google.pubsub.v1.CloudStorageConfig.AvroConfig getAvroConfig() {
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in Avro format.
+   * Optional. If set, message data will be written to Cloud Storage in Avro
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.CloudStorageConfig.AvroConfigOrBuilder getAvroConfigOrBuilder() {
@@ -1560,12 +1602,13 @@ public com.google.pubsub.v1.CloudStorageConfig.AvroConfigOrBuilder getAvroConfig
    *
    *
    * 
-   * The maximum duration that can elapse before a new Cloud Storage file is
-   * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-   * the subscription's acknowledgement deadline.
+   * Optional. The maximum duration that can elapse before a new Cloud Storage
+   * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+   * exceed the subscription's acknowledgement deadline.
    * 

    *
-   * .google.protobuf.Duration max_duration = 6;
+   * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the maxDuration field is set.
    */
@@ -1577,12 +1620,13 @@ public boolean hasMaxDuration() {
    *
    *
    * 
-   * The maximum duration that can elapse before a new Cloud Storage file is
-   * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-   * the subscription's acknowledgement deadline.
+   * Optional. The maximum duration that can elapse before a new Cloud Storage
+   * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+   * exceed the subscription's acknowledgement deadline.
    * 

    *
-   * .google.protobuf.Duration max_duration = 6;
+   * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The maxDuration.
    */
@@ -1594,12 +1638,13 @@ public com.google.protobuf.Duration getMaxDuration() {
    *
    *
    * 
-   * The maximum duration that can elapse before a new Cloud Storage file is
-   * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-   * the subscription's acknowledgement deadline.
+   * Optional. The maximum duration that can elapse before a new Cloud Storage
+   * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+   * exceed the subscription's acknowledgement deadline.
    * 

    *
-   * .google.protobuf.Duration max_duration = 6;
+   * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.protobuf.DurationOrBuilder getMaxDurationOrBuilder() {
@@ -1612,12 +1657,12 @@ public com.google.protobuf.DurationOrBuilder getMaxDurationOrBuilder() {
    *
    *
    * 
-   * The maximum bytes that can be written to a Cloud Storage file before a new
-   * file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded
-   * in cases where messages are larger than the limit.
+   * Optional. The maximum bytes that can be written to a Cloud Storage file
+   * before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may
+   * be exceeded in cases where messages are larger than the limit.
    * 

    *
-   * int64 max_bytes = 7;
+   * int64 max_bytes = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The maxBytes.
    */
@@ -2358,11 +2403,11 @@ public Builder setBucketBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * User-provided prefix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Optional. User-provided prefix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
      * 

      *
-     * string filename_prefix = 2;
+     * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The filenamePrefix.
      */
@@ -2381,11 +2426,11 @@ public java.lang.String getFilenamePrefix() {
      *
      *
      * 
-     * User-provided prefix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Optional. User-provided prefix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
      * 

      *
-     * string filename_prefix = 2;
+     * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for filenamePrefix.
      */
@@ -2404,11 +2449,11 @@ public com.google.protobuf.ByteString getFilenamePrefixBytes() {
      *
      *
      * 
-     * User-provided prefix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Optional. User-provided prefix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
      * 

      *
-     * string filename_prefix = 2;
+     * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The filenamePrefix to set.
      * @return This builder for chaining.
@@ -2426,11 +2471,11 @@ public Builder setFilenamePrefix(java.lang.String value) {
      *
      *
      * 
-     * User-provided prefix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Optional. User-provided prefix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
      * 

      *
-     * string filename_prefix = 2;
+     * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -2444,11 +2489,11 @@ public Builder clearFilenamePrefix() {
      *
      *
      * 
-     * User-provided prefix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Optional. User-provided prefix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
      * 

      *
-     * string filename_prefix = 2;
+     * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for filenamePrefix to set.
      * @return This builder for chaining.
@@ -2469,12 +2514,12 @@ public Builder setFilenamePrefixBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * User-provided suffix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-     * not end in "/".
+     * Optional. User-provided suffix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Must not end in "/".
      * 

      *
-     * string filename_suffix = 3;
+     * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The filenameSuffix.
      */
@@ -2493,12 +2538,12 @@ public java.lang.String getFilenameSuffix() {
      *
      *
      * 
-     * User-provided suffix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-     * not end in "/".
+     * Optional. User-provided suffix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Must not end in "/".
      * 

      *
-     * string filename_suffix = 3;
+     * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for filenameSuffix.
      */
@@ -2517,12 +2562,12 @@ public com.google.protobuf.ByteString getFilenameSuffixBytes() {
      *
      *
      * 
-     * User-provided suffix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-     * not end in "/".
+     * Optional. User-provided suffix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Must not end in "/".
      * 

      *
-     * string filename_suffix = 3;
+     * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The filenameSuffix to set.
      * @return This builder for chaining.
@@ -2540,12 +2585,12 @@ public Builder setFilenameSuffix(java.lang.String value) {
      *
      *
      * 
-     * User-provided suffix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-     * not end in "/".
+     * Optional. User-provided suffix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Must not end in "/".
      * 

      *
-     * string filename_suffix = 3;
+     * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -2559,12 +2604,12 @@ public Builder clearFilenameSuffix() {
      *
      *
      * 
-     * User-provided suffix for Cloud Storage filename. See the [object naming
-     * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-     * not end in "/".
+     * Optional. User-provided suffix for Cloud Storage filename. See the [object
+     * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+     * Must not end in "/".
      * 

      *
-     * string filename_suffix = 3;
+     * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for filenameSuffix to set.
      * @return This builder for chaining.
@@ -2589,10 +2634,13 @@ public Builder setFilenameSuffixBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the textConfig field is set.
      */
@@ -2604,10 +2652,13 @@ public boolean hasTextConfig() {
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The textConfig.
      */
@@ -2629,10 +2680,13 @@ public com.google.pubsub.v1.CloudStorageConfig.TextConfig getTextConfig() {
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setTextConfig(com.google.pubsub.v1.CloudStorageConfig.TextConfig value) {
       if (textConfigBuilder_ == null) {
@@ -2651,10 +2705,13 @@ public Builder setTextConfig(com.google.pubsub.v1.CloudStorageConfig.TextConfig
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setTextConfig(
         com.google.pubsub.v1.CloudStorageConfig.TextConfig.Builder builderForValue) {
@@ -2671,10 +2728,13 @@ public Builder setTextConfig(
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeTextConfig(com.google.pubsub.v1.CloudStorageConfig.TextConfig value) {
       if (textConfigBuilder_ == null) {
@@ -2704,10 +2764,13 @@ public Builder mergeTextConfig(com.google.pubsub.v1.CloudStorageConfig.TextConfi
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearTextConfig() {
       if (textConfigBuilder_ == null) {
@@ -2729,10 +2792,13 @@ public Builder clearTextConfig() {
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.CloudStorageConfig.TextConfig.Builder getTextConfigBuilder() {
       return getTextConfigFieldBuilder().getBuilder();
@@ -2741,10 +2807,13 @@ public com.google.pubsub.v1.CloudStorageConfig.TextConfig.Builder getTextConfigB
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     @java.lang.Override
     public com.google.pubsub.v1.CloudStorageConfig.TextConfigOrBuilder getTextConfigOrBuilder() {
@@ -2761,10 +2830,13 @@ public com.google.pubsub.v1.CloudStorageConfig.TextConfigOrBuilder getTextConfig
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in text format.
+     * Optional. If set, message data will be written to Cloud Storage in text
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.CloudStorageConfig.TextConfig,
@@ -2799,10 +2871,13 @@ public com.google.pubsub.v1.CloudStorageConfig.TextConfigOrBuilder getTextConfig
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the avroConfig field is set.
      */
@@ -2814,10 +2889,13 @@ public boolean hasAvroConfig() {
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The avroConfig.
      */
@@ -2839,10 +2917,13 @@ public com.google.pubsub.v1.CloudStorageConfig.AvroConfig getAvroConfig() {
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setAvroConfig(com.google.pubsub.v1.CloudStorageConfig.AvroConfig value) {
       if (avroConfigBuilder_ == null) {
@@ -2861,10 +2942,13 @@ public Builder setAvroConfig(com.google.pubsub.v1.CloudStorageConfig.AvroConfig
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setAvroConfig(
         com.google.pubsub.v1.CloudStorageConfig.AvroConfig.Builder builderForValue) {
@@ -2881,10 +2965,13 @@ public Builder setAvroConfig(
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeAvroConfig(com.google.pubsub.v1.CloudStorageConfig.AvroConfig value) {
       if (avroConfigBuilder_ == null) {
@@ -2914,10 +3001,13 @@ public Builder mergeAvroConfig(com.google.pubsub.v1.CloudStorageConfig.AvroConfi
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearAvroConfig() {
       if (avroConfigBuilder_ == null) {
@@ -2939,10 +3029,13 @@ public Builder clearAvroConfig() {
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.CloudStorageConfig.AvroConfig.Builder getAvroConfigBuilder() {
       return getAvroConfigFieldBuilder().getBuilder();
@@ -2951,10 +3044,13 @@ public com.google.pubsub.v1.CloudStorageConfig.AvroConfig.Builder getAvroConfigB
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     @java.lang.Override
     public com.google.pubsub.v1.CloudStorageConfig.AvroConfigOrBuilder getAvroConfigOrBuilder() {
@@ -2971,10 +3067,13 @@ public com.google.pubsub.v1.CloudStorageConfig.AvroConfigOrBuilder getAvroConfig
      *
      *
      * 
-     * If set, message data will be written to Cloud Storage in Avro format.
+     * Optional. If set, message data will be written to Cloud Storage in Avro
+     * format.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.CloudStorageConfig.AvroConfig,
@@ -3010,12 +3109,13 @@ public com.google.pubsub.v1.CloudStorageConfig.AvroConfigOrBuilder getAvroConfig
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the maxDuration field is set.
      */
@@ -3026,12 +3126,13 @@ public boolean hasMaxDuration() {
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The maxDuration.
      */
@@ -3048,12 +3149,13 @@ public com.google.protobuf.Duration getMaxDuration() {
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMaxDuration(com.google.protobuf.Duration value) {
       if (maxDurationBuilder_ == null) {
@@ -3072,12 +3174,13 @@ public Builder setMaxDuration(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMaxDuration(com.google.protobuf.Duration.Builder builderForValue) {
       if (maxDurationBuilder_ == null) {
@@ -3093,12 +3196,13 @@ public Builder setMaxDuration(com.google.protobuf.Duration.Builder builderForVal
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeMaxDuration(com.google.protobuf.Duration value) {
       if (maxDurationBuilder_ == null) {
@@ -3120,12 +3224,13 @@ public Builder mergeMaxDuration(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearMaxDuration() {
       bitField0_ = (bitField0_ & ~0x00000020);
@@ -3141,12 +3246,13 @@ public Builder clearMaxDuration() {
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.Duration.Builder getMaxDurationBuilder() {
       bitField0_ |= 0x00000020;
@@ -3157,12 +3263,13 @@ public com.google.protobuf.Duration.Builder getMaxDurationBuilder() {
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.DurationOrBuilder getMaxDurationOrBuilder() {
       if (maxDurationBuilder_ != null) {
@@ -3177,12 +3284,13 @@ public com.google.protobuf.DurationOrBuilder getMaxDurationOrBuilder() {
      *
      *
      * 
-     * The maximum duration that can elapse before a new Cloud Storage file is
-     * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-     * the subscription's acknowledgement deadline.
+     * Optional. The maximum duration that can elapse before a new Cloud Storage
+     * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+     * exceed the subscription's acknowledgement deadline.
      * 

      *
-     * .google.protobuf.Duration max_duration = 6;
+     * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.Duration,
@@ -3206,12 +3314,12 @@ public com.google.protobuf.DurationOrBuilder getMaxDurationOrBuilder() {
      *
      *
      * 
-     * The maximum bytes that can be written to a Cloud Storage file before a new
-     * file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded
-     * in cases where messages are larger than the limit.
+     * Optional. The maximum bytes that can be written to a Cloud Storage file
+     * before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may
+     * be exceeded in cases where messages are larger than the limit.
      * 

      *
-     * int64 max_bytes = 7;
+     * int64 max_bytes = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The maxBytes.
      */
@@ -3223,12 +3331,12 @@ public long getMaxBytes() {
      *
      *
      * 
-     * The maximum bytes that can be written to a Cloud Storage file before a new
-     * file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded
-     * in cases where messages are larger than the limit.
+     * Optional. The maximum bytes that can be written to a Cloud Storage file
+     * before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may
+     * be exceeded in cases where messages are larger than the limit.
      * 

      *
-     * int64 max_bytes = 7;
+     * int64 max_bytes = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The maxBytes to set.
      * @return This builder for chaining.
@@ -3244,12 +3352,12 @@ public Builder setMaxBytes(long value) {
      *
      *
      * 
-     * The maximum bytes that can be written to a Cloud Storage file before a new
-     * file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded
-     * in cases where messages are larger than the limit.
+     * Optional. The maximum bytes that can be written to a Cloud Storage file
+     * before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may
+     * be exceeded in cases where messages are larger than the limit.
      * 

      *
-     * int64 max_bytes = 7;
+     * int64 max_bytes = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfigOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfigOrBuilder.java
index 5122f804a..780c0ea61 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfigOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CloudStorageConfigOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -58,11 +58,11 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * User-provided prefix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Optional. User-provided prefix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
    * 

    *
-   * string filename_prefix = 2;
+   * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The filenamePrefix.
    */
@@ -71,11 +71,11 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * User-provided prefix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Optional. User-provided prefix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
    * 

    *
-   * string filename_prefix = 2;
+   * string filename_prefix = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for filenamePrefix.
    */
@@ -85,12 +85,12 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * User-provided suffix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-   * not end in "/".
+   * Optional. User-provided suffix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Must not end in "/".
    * 

    *
-   * string filename_suffix = 3;
+   * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The filenameSuffix.
    */
@@ -99,12 +99,12 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * User-provided suffix for Cloud Storage filename. See the [object naming
-   * requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-   * not end in "/".
+   * Optional. User-provided suffix for Cloud Storage filename. See the [object
+   * naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+   * Must not end in "/".
    * 

    *
-   * string filename_suffix = 3;
+   * string filename_suffix = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for filenameSuffix.
    */
@@ -114,10 +114,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in text format.
+   * Optional. If set, message data will be written to Cloud Storage in text
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the textConfig field is set.
    */
@@ -126,10 +129,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in text format.
+   * Optional. If set, message data will be written to Cloud Storage in text
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The textConfig.
    */
@@ -138,10 +144,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in text format.
+   * Optional. If set, message data will be written to Cloud Storage in text
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.TextConfig text_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.CloudStorageConfig.TextConfigOrBuilder getTextConfigOrBuilder();
 
@@ -149,10 +158,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in Avro format.
+   * Optional. If set, message data will be written to Cloud Storage in Avro
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the avroConfig field is set.
    */
@@ -161,10 +173,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in Avro format.
+   * Optional. If set, message data will be written to Cloud Storage in Avro
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The avroConfig.
    */
@@ -173,10 +188,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * If set, message data will be written to Cloud Storage in Avro format.
+   * Optional. If set, message data will be written to Cloud Storage in Avro
+   * format.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig.AvroConfig avro_config = 5 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.CloudStorageConfig.AvroConfigOrBuilder getAvroConfigOrBuilder();
 
@@ -184,12 +202,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * The maximum duration that can elapse before a new Cloud Storage file is
-   * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-   * the subscription's acknowledgement deadline.
+   * Optional. The maximum duration that can elapse before a new Cloud Storage
+   * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+   * exceed the subscription's acknowledgement deadline.
    * 

    *
-   * .google.protobuf.Duration max_duration = 6;
+   * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the maxDuration field is set.
    */
@@ -198,12 +217,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * The maximum duration that can elapse before a new Cloud Storage file is
-   * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-   * the subscription's acknowledgement deadline.
+   * Optional. The maximum duration that can elapse before a new Cloud Storage
+   * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+   * exceed the subscription's acknowledgement deadline.
    * 

    *
-   * .google.protobuf.Duration max_duration = 6;
+   * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The maxDuration.
    */
@@ -212,12 +232,13 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * The maximum duration that can elapse before a new Cloud Storage file is
-   * created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-   * the subscription's acknowledgement deadline.
+   * Optional. The maximum duration that can elapse before a new Cloud Storage
+   * file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+   * exceed the subscription's acknowledgement deadline.
    * 

    *
-   * .google.protobuf.Duration max_duration = 6;
+   * .google.protobuf.Duration max_duration = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.protobuf.DurationOrBuilder getMaxDurationOrBuilder();
 
@@ -225,12 +246,12 @@ public interface CloudStorageConfigOrBuilder
    *
    *
    * 
-   * The maximum bytes that can be written to a Cloud Storage file before a new
-   * file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded
-   * in cases where messages are larger than the limit.
+   * Optional. The maximum bytes that can be written to a Cloud Storage file
+   * before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may
+   * be exceeded in cases where messages are larger than the limit.
    * 

    *
-   * int64 max_bytes = 7;
+   * int64 max_bytes = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The maxBytes.
    */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequest.java
index ba816deeb..2c1c5b2dd 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequestOrBuilder.java
index 7ac207df8..3bdf1c9bf 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CommitSchemaRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequest.java
index 82fe63cea..c53c7f0ab 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -189,8 +189,8 @@ public com.google.pubsub.v1.SchemaOrBuilder getSchemaOrBuilder() {
    * The ID to use for the schema, which will become the final component of
    * the schema's resource name.
    *
-   * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource
-   * name constraints.
+   * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for
+   * resource name constraints.
    * 

    *
    * string schema_id = 3;
@@ -216,8 +216,8 @@ public java.lang.String getSchemaId() {
    * The ID to use for the schema, which will become the final component of
    * the schema's resource name.
    *
-   * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource
-   * name constraints.
+   * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for
+   * resource name constraints.
    * 

    *
    * string schema_id = 3;
@@ -976,8 +976,8 @@ public com.google.pubsub.v1.SchemaOrBuilder getSchemaOrBuilder() {
      * The ID to use for the schema, which will become the final component of
      * the schema's resource name.
      *
-     * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource
-     * name constraints.
+     * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for
+     * resource name constraints.
      * 

      *
      * string schema_id = 3;
@@ -1002,8 +1002,8 @@ public java.lang.String getSchemaId() {
      * The ID to use for the schema, which will become the final component of
      * the schema's resource name.
      *
-     * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource
-     * name constraints.
+     * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for
+     * resource name constraints.
      *
* * string schema_id = 3; @@ -1028,8 +1028,8 @@ public com.google.protobuf.ByteString getSchemaIdBytes() { * The ID to use for the schema, which will become the final component of * the schema's resource name. * - * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource - * name constraints. + * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for + * resource name constraints. * * * string schema_id = 3; @@ -1053,8 +1053,8 @@ public Builder setSchemaId(java.lang.String value) { * The ID to use for the schema, which will become the final component of * the schema's resource name. * - * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource - * name constraints. + * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for + * resource name constraints. * * * string schema_id = 3; @@ -1074,8 +1074,8 @@ public Builder clearSchemaId() { * The ID to use for the schema, which will become the final component of * the schema's resource name. * - * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource - * name constraints. + * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for + * resource name constraints. * * * string schema_id = 3; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequestOrBuilder.java index c4cc82962..4d7883850 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSchemaRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -108,8 +108,8 @@ public interface CreateSchemaRequestOrBuilder * The ID to use for the schema, which will become the final component of * the schema's resource name. * - * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource - * name constraints. + * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for + * resource name constraints. * * * string schema_id = 3; @@ -124,8 +124,8 @@ public interface CreateSchemaRequestOrBuilder * The ID to use for the schema, which will become the final component of * the schema's resource name. * - * See https://cloud.google.com/pubsub/docs/admin#resource_names for resource - * name constraints. + * See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for + * resource name constraints. * * * string schema_id = 3; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java index 3918f5ca6..5cd0670a2 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -240,11 +240,11 @@ public int getLabelsCount() { * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public boolean containsLabels(java.lang.String key) { @@ -263,11 +263,11 @@ public java.util.Map getLabels() { * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public java.util.Map getLabelsMap() { @@ -277,11 +277,11 @@ public java.util.Map getLabelsMap() { * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public /* nullable */ java.lang.String getLabelsOrDefault( @@ -298,11 +298,11 @@ public java.util.Map getLabelsMap() { * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public java.lang.String getLabelsOrThrow(java.lang.String key) { @@ -1063,11 +1063,11 @@ public int getLabelsCount() { * * * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public boolean containsLabels(java.lang.String key) { @@ -1086,11 +1086,11 @@ public java.util.Map getLabels() { * * * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public java.util.Map getLabelsMap() { @@ -1100,11 +1100,11 @@ public java.util.Map getLabelsMap() { * * * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public /* nullable */ java.lang.String getLabelsOrDefault( @@ -1121,11 +1121,11 @@ public java.util.Map getLabelsMap() { * * * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public java.lang.String getLabelsOrThrow(java.lang.String key) { @@ -1148,11 +1148,11 @@ public Builder clearLabels() { * * * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ public Builder removeLabels(java.lang.String key) { if (key == null) { @@ -1171,11 +1171,11 @@ public java.util.Map getMutableLabels() { * * * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ public Builder putLabels(java.lang.String key, java.lang.String value) { if (key == null) { @@ -1192,11 +1192,11 @@ public Builder putLabels(java.lang.String key, java.lang.String value) { * * * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ public Builder putAllLabels(java.util.Map values) { internalGetMutableLabels().getMutableMap().putAll(values); diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java index ee4a6d68f..ae5776a89 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/CreateSnapshotRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -111,22 +111,22 @@ public interface CreateSnapshotRequestOrBuilder * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ int getLabelsCount(); /** * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ boolean containsLabels(java.lang.String key); /** Use {@link #getLabelsMap()} instead. */ @@ -136,22 +136,22 @@ public interface CreateSnapshotRequestOrBuilder * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ java.util.Map getLabelsMap(); /** * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ /* nullable */ java.lang.String getLabelsOrDefault( @@ -162,11 +162,11 @@ java.lang.String getLabelsOrDefault( * * * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    *
* - * map<string, string> labels = 3; + * map<string, string> labels = 3 [(.google.api.field_behavior) = OPTIONAL]; */ java.lang.String getLabelsOrThrow(java.lang.String key); } diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicy.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicy.java index 08f316b30..04e61da32 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicy.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicy.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -74,18 +74,18 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * The name of the topic to which dead letter messages should be published.
-   * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-   * account associated with the enclosing subscription's parent project (i.e.,
-   * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-   * permission to Publish() to this topic.
+   * Optional. The name of the topic to which dead letter messages should be
+   * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+   * service account associated with the enclosing subscription's parent project
+   * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+   * have permission to Publish() to this topic.
    *
    * The operation will fail if the topic does not exist.
    * Users should ensure that there is a subscription attached to this topic
    * since messages published to a topic with no subscriptions are lost.
    *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The deadLetterTopic. */ @@ -105,18 +105,18 @@ public java.lang.String getDeadLetterTopic() { * * * 
-   * The name of the topic to which dead letter messages should be published.
-   * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-   * account associated with the enclosing subscription's parent project (i.e.,
-   * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-   * permission to Publish() to this topic.
+   * Optional. The name of the topic to which dead letter messages should be
+   * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+   * service account associated with the enclosing subscription's parent project
+   * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+   * have permission to Publish() to this topic.
    *
    * The operation will fail if the topic does not exist.
    * Users should ensure that there is a subscription attached to this topic
    * since messages published to a topic with no subscriptions are lost.
    *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for deadLetterTopic. */ @@ -139,8 +139,8 @@ public com.google.protobuf.ByteString getDeadLetterTopicBytes() { * * * 
-   * The maximum number of delivery attempts for any message. The value must be
-   * between 5 and 100.
+   * Optional. The maximum number of delivery attempts for any message. The
+   * value must be between 5 and 100.
    *
    * The number of delivery attempts is defined as 1 + (the sum of number of
    * NACKs and number of times the acknowledgement deadline has been exceeded
@@ -154,7 +154,7 @@ public com.google.protobuf.ByteString getDeadLetterTopicBytes() {
    * If this parameter is 0, a default value of 5 is used.
    *
* - * int32 max_delivery_attempts = 2; + * int32 max_delivery_attempts = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The maxDeliveryAttempts. */ @@ -533,18 +533,18 @@ public Builder mergeFrom( * * * 
-     * The name of the topic to which dead letter messages should be published.
-     * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-     * account associated with the enclosing subscription's parent project (i.e.,
-     * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-     * permission to Publish() to this topic.
+     * Optional. The name of the topic to which dead letter messages should be
+     * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+     * service account associated with the enclosing subscription's parent project
+     * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+     * have permission to Publish() to this topic.
      *
      * The operation will fail if the topic does not exist.
      * Users should ensure that there is a subscription attached to this topic
      * since messages published to a topic with no subscriptions are lost.
      *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The deadLetterTopic. */ @@ -563,18 +563,18 @@ public java.lang.String getDeadLetterTopic() { * * * 
-     * The name of the topic to which dead letter messages should be published.
-     * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-     * account associated with the enclosing subscription's parent project (i.e.,
-     * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-     * permission to Publish() to this topic.
+     * Optional. The name of the topic to which dead letter messages should be
+     * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+     * service account associated with the enclosing subscription's parent project
+     * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+     * have permission to Publish() to this topic.
      *
      * The operation will fail if the topic does not exist.
      * Users should ensure that there is a subscription attached to this topic
      * since messages published to a topic with no subscriptions are lost.
      *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for deadLetterTopic. */ @@ -593,18 +593,18 @@ public com.google.protobuf.ByteString getDeadLetterTopicBytes() { * * * 
-     * The name of the topic to which dead letter messages should be published.
-     * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-     * account associated with the enclosing subscription's parent project (i.e.,
-     * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-     * permission to Publish() to this topic.
+     * Optional. The name of the topic to which dead letter messages should be
+     * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+     * service account associated with the enclosing subscription's parent project
+     * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+     * have permission to Publish() to this topic.
      *
      * The operation will fail if the topic does not exist.
      * Users should ensure that there is a subscription attached to this topic
      * since messages published to a topic with no subscriptions are lost.
      *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The deadLetterTopic to set. * @return This builder for chaining. @@ -622,18 +622,18 @@ public Builder setDeadLetterTopic(java.lang.String value) { * * * 
-     * The name of the topic to which dead letter messages should be published.
-     * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-     * account associated with the enclosing subscription's parent project (i.e.,
-     * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-     * permission to Publish() to this topic.
+     * Optional. The name of the topic to which dead letter messages should be
+     * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+     * service account associated with the enclosing subscription's parent project
+     * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+     * have permission to Publish() to this topic.
      *
      * The operation will fail if the topic does not exist.
      * Users should ensure that there is a subscription attached to this topic
      * since messages published to a topic with no subscriptions are lost.
      *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -647,18 +647,18 @@ public Builder clearDeadLetterTopic() { * * * 
-     * The name of the topic to which dead letter messages should be published.
-     * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-     * account associated with the enclosing subscription's parent project (i.e.,
-     * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-     * permission to Publish() to this topic.
+     * Optional. The name of the topic to which dead letter messages should be
+     * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+     * service account associated with the enclosing subscription's parent project
+     * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+     * have permission to Publish() to this topic.
      *
      * The operation will fail if the topic does not exist.
      * Users should ensure that there is a subscription attached to this topic
      * since messages published to a topic with no subscriptions are lost.
      *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for deadLetterTopic to set. * @return This builder for chaining. @@ -679,8 +679,8 @@ public Builder setDeadLetterTopicBytes(com.google.protobuf.ByteString value) { * * * 
-     * The maximum number of delivery attempts for any message. The value must be
-     * between 5 and 100.
+     * Optional. The maximum number of delivery attempts for any message. The
+     * value must be between 5 and 100.
      *
      * The number of delivery attempts is defined as 1 + (the sum of number of
      * NACKs and number of times the acknowledgement deadline has been exceeded
@@ -694,7 +694,7 @@ public Builder setDeadLetterTopicBytes(com.google.protobuf.ByteString value) {
      * If this parameter is 0, a default value of 5 is used.
      *
* - * int32 max_delivery_attempts = 2; + * int32 max_delivery_attempts = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The maxDeliveryAttempts. */ @@ -706,8 +706,8 @@ public int getMaxDeliveryAttempts() { * * * 
-     * The maximum number of delivery attempts for any message. The value must be
-     * between 5 and 100.
+     * Optional. The maximum number of delivery attempts for any message. The
+     * value must be between 5 and 100.
      *
      * The number of delivery attempts is defined as 1 + (the sum of number of
      * NACKs and number of times the acknowledgement deadline has been exceeded
@@ -721,7 +721,7 @@ public int getMaxDeliveryAttempts() {
      * If this parameter is 0, a default value of 5 is used.
      *
* - * int32 max_delivery_attempts = 2; + * int32 max_delivery_attempts = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The maxDeliveryAttempts to set. * @return This builder for chaining. @@ -737,8 +737,8 @@ public Builder setMaxDeliveryAttempts(int value) { * * * 
-     * The maximum number of delivery attempts for any message. The value must be
-     * between 5 and 100.
+     * Optional. The maximum number of delivery attempts for any message. The
+     * value must be between 5 and 100.
      *
      * The number of delivery attempts is defined as 1 + (the sum of number of
      * NACKs and number of times the acknowledgement deadline has been exceeded
@@ -752,7 +752,7 @@ public Builder setMaxDeliveryAttempts(int value) {
      * If this parameter is 0, a default value of 5 is used.
      *
* - * int32 max_delivery_attempts = 2; + * int32 max_delivery_attempts = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicyOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicyOrBuilder.java index 57c34d389..8782315f6 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicyOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeadLetterPolicyOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,18 +27,18 @@ public interface DeadLetterPolicyOrBuilder * * * 
-   * The name of the topic to which dead letter messages should be published.
-   * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-   * account associated with the enclosing subscription's parent project (i.e.,
-   * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-   * permission to Publish() to this topic.
+   * Optional. The name of the topic to which dead letter messages should be
+   * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+   * service account associated with the enclosing subscription's parent project
+   * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+   * have permission to Publish() to this topic.
    *
    * The operation will fail if the topic does not exist.
    * Users should ensure that there is a subscription attached to this topic
    * since messages published to a topic with no subscriptions are lost.
    *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The deadLetterTopic. */ @@ -47,18 +47,18 @@ public interface DeadLetterPolicyOrBuilder * * * 
-   * The name of the topic to which dead letter messages should be published.
-   * Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-   * account associated with the enclosing subscription's parent project (i.e.,
-   * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-   * permission to Publish() to this topic.
+   * Optional. The name of the topic to which dead letter messages should be
+   * published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+   * service account associated with the enclosing subscription's parent project
+   * (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+   * have permission to Publish() to this topic.
    *
    * The operation will fail if the topic does not exist.
    * Users should ensure that there is a subscription attached to this topic
    * since messages published to a topic with no subscriptions are lost.
    *
* - * string dead_letter_topic = 1; + * string dead_letter_topic = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for deadLetterTopic. */ @@ -68,8 +68,8 @@ public interface DeadLetterPolicyOrBuilder * * * 
-   * The maximum number of delivery attempts for any message. The value must be
-   * between 5 and 100.
+   * Optional. The maximum number of delivery attempts for any message. The
+   * value must be between 5 and 100.
    *
    * The number of delivery attempts is defined as 1 + (the sum of number of
    * NACKs and number of times the acknowledgement deadline has been exceeded
@@ -83,7 +83,7 @@ public interface DeadLetterPolicyOrBuilder
    * If this parameter is 0, a default value of 5 is used.
    *
* - * int32 max_delivery_attempts = 2; + * int32 max_delivery_attempts = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The maxDeliveryAttempts. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequest.java index 05b705298..f2b94a760 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequestOrBuilder.java index 9a119b4b6..a40fb98aa 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequest.java index d057aaf47..3f0288302 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequestOrBuilder.java index 1286bce9f..5b6bb574f 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSchemaRevisionRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java index 3d494f98f..a8429c3de 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequestOrBuilder.java index c69c25ca8..49328a977 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSnapshotRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequest.java index d91bb8783..28aecaadd 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequestOrBuilder.java index 53ffc2512..793cb2a16 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteSubscriptionRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequest.java index a4055d287..df449fac8 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequestOrBuilder.java index 8360c7745..00b6fa902 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DeleteTopicRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequest.java index 910c1f9e2..b563d3d38 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequestOrBuilder.java index 6b348ec14..50b968b41 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponse.java index 0eae1bac2..a0c910e2c 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponseOrBuilder.java index 4d8a60b3a..e667c16ef 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/DetachSubscriptionResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Encoding.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Encoding.java index 6f07b9ea4..883df5b84 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Encoding.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Encoding.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicy.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicy.java index 89229dd47..a64bf1fec 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicy.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicy.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -67,15 +67,15 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * Specifies the "time-to-live" duration for an associated resource. The
-   * resource expires if it is not active for a period of `ttl`. The definition
-   * of "activity" depends on the type of the associated resource. The minimum
-   * and maximum allowed values for `ttl` depend on the type of the associated
-   * resource, as well. If `ttl` is not set, the associated resource never
-   * expires.
+   * Optional. Specifies the "time-to-live" duration for an associated resource.
+   * The resource expires if it is not active for a period of `ttl`. The
+   * definition of "activity" depends on the type of the associated resource.
+   * The minimum and maximum allowed values for `ttl` depend on the type of the
+   * associated resource, as well. If `ttl` is not set, the associated resource
+   * never expires.
    *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return Whether the ttl field is set. */ @@ -87,15 +87,15 @@ public boolean hasTtl() { * * * 
-   * Specifies the "time-to-live" duration for an associated resource. The
-   * resource expires if it is not active for a period of `ttl`. The definition
-   * of "activity" depends on the type of the associated resource. The minimum
-   * and maximum allowed values for `ttl` depend on the type of the associated
-   * resource, as well. If `ttl` is not set, the associated resource never
-   * expires.
+   * Optional. Specifies the "time-to-live" duration for an associated resource.
+   * The resource expires if it is not active for a period of `ttl`. The
+   * definition of "activity" depends on the type of the associated resource.
+   * The minimum and maximum allowed values for `ttl` depend on the type of the
+   * associated resource, as well. If `ttl` is not set, the associated resource
+   * never expires.
    *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The ttl. */ @@ -107,15 +107,15 @@ public com.google.protobuf.Duration getTtl() { * * * 
-   * Specifies the "time-to-live" duration for an associated resource. The
-   * resource expires if it is not active for a period of `ttl`. The definition
-   * of "activity" depends on the type of the associated resource. The minimum
-   * and maximum allowed values for `ttl` depend on the type of the associated
-   * resource, as well. If `ttl` is not set, the associated resource never
-   * expires.
+   * Optional. Specifies the "time-to-live" duration for an associated resource.
+   * The resource expires if it is not active for a period of `ttl`. The
+   * definition of "activity" depends on the type of the associated resource.
+   * The minimum and maximum allowed values for `ttl` depend on the type of the
+   * associated resource, as well. If `ttl` is not set, the associated resource
+   * never expires.
    *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ @java.lang.Override public com.google.protobuf.DurationOrBuilder getTtlOrBuilder() { @@ -479,15 +479,15 @@ public Builder mergeFrom( * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return Whether the ttl field is set. */ @@ -498,15 +498,15 @@ public boolean hasTtl() { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The ttl. */ @@ -521,15 +521,15 @@ public com.google.protobuf.Duration getTtl() { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ public Builder setTtl(com.google.protobuf.Duration value) { if (ttlBuilder_ == null) { @@ -548,15 +548,15 @@ public Builder setTtl(com.google.protobuf.Duration value) { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ public Builder setTtl(com.google.protobuf.Duration.Builder builderForValue) { if (ttlBuilder_ == null) { @@ -572,15 +572,15 @@ public Builder setTtl(com.google.protobuf.Duration.Builder builderForValue) { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ public Builder mergeTtl(com.google.protobuf.Duration value) { if (ttlBuilder_ == null) { @@ -602,15 +602,15 @@ public Builder mergeTtl(com.google.protobuf.Duration value) { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ public Builder clearTtl() { bitField0_ = (bitField0_ & ~0x00000001); @@ -626,15 +626,15 @@ public Builder clearTtl() { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ public com.google.protobuf.Duration.Builder getTtlBuilder() { bitField0_ |= 0x00000001; @@ -645,15 +645,15 @@ public com.google.protobuf.Duration.Builder getTtlBuilder() { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ public com.google.protobuf.DurationOrBuilder getTtlOrBuilder() { if (ttlBuilder_ != null) { @@ -666,15 +666,15 @@ public com.google.protobuf.DurationOrBuilder getTtlOrBuilder() { * * * 
-     * Specifies the "time-to-live" duration for an associated resource. The
-     * resource expires if it is not active for a period of `ttl`. The definition
-     * of "activity" depends on the type of the associated resource. The minimum
-     * and maximum allowed values for `ttl` depend on the type of the associated
-     * resource, as well. If `ttl` is not set, the associated resource never
-     * expires.
+     * Optional. Specifies the "time-to-live" duration for an associated resource.
+     * The resource expires if it is not active for a period of `ttl`. The
+     * definition of "activity" depends on the type of the associated resource.
+     * The minimum and maximum allowed values for `ttl` depend on the type of the
+     * associated resource, as well. If `ttl` is not set, the associated resource
+     * never expires.
      *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ private com.google.protobuf.SingleFieldBuilderV3< com.google.protobuf.Duration, diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicyOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicyOrBuilder.java index 1b35de3b7..c46d53a5f 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicyOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ExpirationPolicyOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,15 +27,15 @@ public interface ExpirationPolicyOrBuilder * * * 
-   * Specifies the "time-to-live" duration for an associated resource. The
-   * resource expires if it is not active for a period of `ttl`. The definition
-   * of "activity" depends on the type of the associated resource. The minimum
-   * and maximum allowed values for `ttl` depend on the type of the associated
-   * resource, as well. If `ttl` is not set, the associated resource never
-   * expires.
+   * Optional. Specifies the "time-to-live" duration for an associated resource.
+   * The resource expires if it is not active for a period of `ttl`. The
+   * definition of "activity" depends on the type of the associated resource.
+   * The minimum and maximum allowed values for `ttl` depend on the type of the
+   * associated resource, as well. If `ttl` is not set, the associated resource
+   * never expires.
    *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return Whether the ttl field is set. */ @@ -44,15 +44,15 @@ public interface ExpirationPolicyOrBuilder * * * 
-   * Specifies the "time-to-live" duration for an associated resource. The
-   * resource expires if it is not active for a period of `ttl`. The definition
-   * of "activity" depends on the type of the associated resource. The minimum
-   * and maximum allowed values for `ttl` depend on the type of the associated
-   * resource, as well. If `ttl` is not set, the associated resource never
-   * expires.
+   * Optional. Specifies the "time-to-live" duration for an associated resource.
+   * The resource expires if it is not active for a period of `ttl`. The
+   * definition of "activity" depends on the type of the associated resource.
+   * The minimum and maximum allowed values for `ttl` depend on the type of the
+   * associated resource, as well. If `ttl` is not set, the associated resource
+   * never expires.
    *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The ttl. */ @@ -61,15 +61,15 @@ public interface ExpirationPolicyOrBuilder * * * 
-   * Specifies the "time-to-live" duration for an associated resource. The
-   * resource expires if it is not active for a period of `ttl`. The definition
-   * of "activity" depends on the type of the associated resource. The minimum
-   * and maximum allowed values for `ttl` depend on the type of the associated
-   * resource, as well. If `ttl` is not set, the associated resource never
-   * expires.
+   * Optional. Specifies the "time-to-live" duration for an associated resource.
+   * The resource expires if it is not active for a period of `ttl`. The
+   * definition of "activity" depends on the type of the associated resource.
+   * The minimum and maximum allowed values for `ttl` depend on the type of the
+   * associated resource, as well. If `ttl` is not set, the associated resource
+   * never expires.
    *
* - * .google.protobuf.Duration ttl = 1; + * .google.protobuf.Duration ttl = 1 [(.google.api.field_behavior) = OPTIONAL]; */ com.google.protobuf.DurationOrBuilder getTtlOrBuilder(); } diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequest.java index 61bf3ff17..9d6a6bd87 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequestOrBuilder.java index 2ec773994..81fa8291f 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSchemaRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java index 1953ee97c..54051d611 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequestOrBuilder.java index 9eecf39ab..2c195ca68 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSnapshotRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequest.java index 66577cd6c..f2bfee161 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequestOrBuilder.java index bc2288db3..a61e7e84f 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetSubscriptionRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequest.java index 59b81305a..2b801c10a 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequestOrBuilder.java index 72ce889da..3e38266a3 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/GetTopicRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/IngestionDataSourceSettings.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/IngestionDataSourceSettings.java new file mode 100644 index 000000000..04c354d8b --- /dev/null +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/IngestionDataSourceSettings.java @@ -0,0 +1,2623 @@ +/* + * Copyright 2024 Google LLC + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +// Generated by the protocol buffer compiler. DO NOT EDIT! +// source: google/pubsub/v1/pubsub.proto + +package com.google.pubsub.v1; + +/** + * + * + * 
+ * Settings for an ingestion data source on a topic.
+ *
+ * + * Protobuf type {@code google.pubsub.v1.IngestionDataSourceSettings} + */ +public final class IngestionDataSourceSettings extends com.google.protobuf.GeneratedMessageV3 + implements + // @@protoc_insertion_point(message_implements:google.pubsub.v1.IngestionDataSourceSettings) + IngestionDataSourceSettingsOrBuilder { + private static final long serialVersionUID = 0L; + // Use IngestionDataSourceSettings.newBuilder() to construct. + private IngestionDataSourceSettings(com.google.protobuf.GeneratedMessageV3.Builder builder) { + super(builder); + } + + private IngestionDataSourceSettings() {} + + @java.lang.Override + @SuppressWarnings({"unused"}) + protected java.lang.Object newInstance(UnusedPrivateParameter unused) { + return new IngestionDataSourceSettings(); + } + + public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_descriptor; + } + + @java.lang.Override + protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable + internalGetFieldAccessorTable() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_fieldAccessorTable + .ensureFieldAccessorsInitialized( + com.google.pubsub.v1.IngestionDataSourceSettings.class, + com.google.pubsub.v1.IngestionDataSourceSettings.Builder.class); + } + + public interface AwsKinesisOrBuilder + extends + // @@protoc_insertion_point(interface_extends:google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) + com.google.protobuf.MessageOrBuilder { + + /** + * + * + * 
+     * Output only. An output-only field that indicates the state of the Kinesis
+     * ingestion source.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @return The enum numeric value on the wire for state. + */ + int getStateValue(); + /** + * + * + * 
+     * Output only. An output-only field that indicates the state of the Kinesis
+     * ingestion source.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @return The state. + */ + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State getState(); + + /** + * + * + * 
+     * Required. The Kinesis stream ARN to ingest data from.
+     *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The streamArn. + */ + java.lang.String getStreamArn(); + /** + * + * + * 
+     * Required. The Kinesis stream ARN to ingest data from.
+     *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for streamArn. + */ + com.google.protobuf.ByteString getStreamArnBytes(); + + /** + * + * + * 
+     * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+     * Fan-Out mode. The consumer must be already created and ready to be used.
+     *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The consumerArn. + */ + java.lang.String getConsumerArn(); + /** + * + * + * 
+     * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+     * Fan-Out mode. The consumer must be already created and ready to be used.
+     *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for consumerArn. + */ + com.google.protobuf.ByteString getConsumerArnBytes(); + + /** + * + * + * 
+     * Required. AWS role ARN to be used for Federated Identity authentication
+     * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+     * required permissions that need to be attached to it.
+     *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The awsRoleArn. + */ + java.lang.String getAwsRoleArn(); + /** + * + * + * 
+     * Required. AWS role ARN to be used for Federated Identity authentication
+     * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+     * required permissions that need to be attached to it.
+     *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for awsRoleArn. + */ + com.google.protobuf.ByteString getAwsRoleArnBytes(); + + /** + * + * + * 
+     * Required. The GCP service account to be used for Federated Identity
+     * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+     * the provided role). The `aws_role_arn` must be set up with
+     * `accounts.google.com:sub` equals to this service account number.
+     *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The gcpServiceAccount. + */ + java.lang.String getGcpServiceAccount(); + /** + * + * + * 
+     * Required. The GCP service account to be used for Federated Identity
+     * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+     * the provided role). The `aws_role_arn` must be set up with
+     * `accounts.google.com:sub` equals to this service account number.
+     *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for gcpServiceAccount. + */ + com.google.protobuf.ByteString getGcpServiceAccountBytes(); + } + /** + * + * + * 
+   * Ingestion settings for Amazon Kinesis Data Streams.
+   *
+ * + * Protobuf type {@code google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis} + */ + public static final class AwsKinesis extends com.google.protobuf.GeneratedMessageV3 + implements + // @@protoc_insertion_point(message_implements:google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) + AwsKinesisOrBuilder { + private static final long serialVersionUID = 0L; + // Use AwsKinesis.newBuilder() to construct. + private AwsKinesis(com.google.protobuf.GeneratedMessageV3.Builder builder) { + super(builder); + } + + private AwsKinesis() { + state_ = 0; + streamArn_ = ""; + consumerArn_ = ""; + awsRoleArn_ = ""; + gcpServiceAccount_ = ""; + } + + @java.lang.Override + @SuppressWarnings({"unused"}) + protected java.lang.Object newInstance(UnusedPrivateParameter unused) { + return new AwsKinesis(); + } + + public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_descriptor; + } + + @java.lang.Override + protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable + internalGetFieldAccessorTable() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_fieldAccessorTable + .ensureFieldAccessorsInitialized( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.class, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.Builder.class); + } + + /** + * + * + * 
+     * Possible states for managed ingestion from Amazon Kinesis Data Streams.
+     *
+ * + * Protobuf enum {@code google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State} + */ + public enum State implements com.google.protobuf.ProtocolMessageEnum { + /** + * + * + * 
+       * Default value. This value is unused.
+       *
+ * + * STATE_UNSPECIFIED = 0; + */ + STATE_UNSPECIFIED(0), + /** + * + * + * 
+       * Ingestion is active.
+       *
+ * + * ACTIVE = 1; + */ + ACTIVE(1), + /** + * + * + * 
+       * Permission denied encountered while consuming data from Kinesis.
+       * This can happen if:
+       *   - The provided `aws_role_arn` does not exist or does not have the
+       *     appropriate permissions attached.
+       *   - The provided `aws_role_arn` is not set up properly for Identity
+       *     Federation using `gcp_service_account`.
+       *   - The Pub/Sub SA is not granted the
+       *     `iam.serviceAccounts.getOpenIdToken` permission on
+       *     `gcp_service_account`.
+       *
+ * + * KINESIS_PERMISSION_DENIED = 2; + */ + KINESIS_PERMISSION_DENIED(2), + /** + * + * + * 
+       * Permission denied encountered while publishing to the topic. This can
+       * happen due to Pub/Sub SA has not been granted the [appropriate publish
+       * permissions](https://cloud.google.com/pubsub/docs/access-control#pubsub.publisher)
+       *
+ * + * PUBLISH_PERMISSION_DENIED = 3; + */ + PUBLISH_PERMISSION_DENIED(3), + /** + * + * + * 
+       * The Kinesis stream does not exist.
+       *
+ * + * STREAM_NOT_FOUND = 4; + */ + STREAM_NOT_FOUND(4), + /** + * + * + * 
+       * The Kinesis consumer does not exist.
+       *
+ * + * CONSUMER_NOT_FOUND = 5; + */ + CONSUMER_NOT_FOUND(5), + UNRECOGNIZED(-1), + ; + + /** + * + * + * 
+       * Default value. This value is unused.
+       *
+ * + * STATE_UNSPECIFIED = 0; + */ + public static final int STATE_UNSPECIFIED_VALUE = 0; + /** + * + * + * 
+       * Ingestion is active.
+       *
+ * + * ACTIVE = 1; + */ + public static final int ACTIVE_VALUE = 1; + /** + * + * + * 
+       * Permission denied encountered while consuming data from Kinesis.
+       * This can happen if:
+       *   - The provided `aws_role_arn` does not exist or does not have the
+       *     appropriate permissions attached.
+       *   - The provided `aws_role_arn` is not set up properly for Identity
+       *     Federation using `gcp_service_account`.
+       *   - The Pub/Sub SA is not granted the
+       *     `iam.serviceAccounts.getOpenIdToken` permission on
+       *     `gcp_service_account`.
+       *
+ * + * KINESIS_PERMISSION_DENIED = 2; + */ + public static final int KINESIS_PERMISSION_DENIED_VALUE = 2; + /** + * + * + * 
+       * Permission denied encountered while publishing to the topic. This can
+       * happen due to Pub/Sub SA has not been granted the [appropriate publish
+       * permissions](https://cloud.google.com/pubsub/docs/access-control#pubsub.publisher)
+       *
+ * + * PUBLISH_PERMISSION_DENIED = 3; + */ + public static final int PUBLISH_PERMISSION_DENIED_VALUE = 3; + /** + * + * + * 
+       * The Kinesis stream does not exist.
+       *
+ * + * STREAM_NOT_FOUND = 4; + */ + public static final int STREAM_NOT_FOUND_VALUE = 4; + /** + * + * + * 
+       * The Kinesis consumer does not exist.
+       *
+ * + * CONSUMER_NOT_FOUND = 5; + */ + public static final int CONSUMER_NOT_FOUND_VALUE = 5; + + public final int getNumber() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalArgumentException( + "Can't get the number of an unknown enum value."); + } + return value; + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + * @deprecated Use {@link #forNumber(int)} instead. + */ + @java.lang.Deprecated + public static State valueOf(int value) { + return forNumber(value); + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + */ + public static State forNumber(int value) { + switch (value) { + case 0: + return STATE_UNSPECIFIED; + case 1: + return ACTIVE; + case 2: + return KINESIS_PERMISSION_DENIED; + case 3: + return PUBLISH_PERMISSION_DENIED; + case 4: + return STREAM_NOT_FOUND; + case 5: + return CONSUMER_NOT_FOUND; + default: + return null; + } + } + + public static com.google.protobuf.Internal.EnumLiteMap internalGetValueMap() { + return internalValueMap; + } + + private static final com.google.protobuf.Internal.EnumLiteMap internalValueMap = + new com.google.protobuf.Internal.EnumLiteMap() { + public State findValueByNumber(int number) { + return State.forNumber(number); + } + }; + + public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalStateException( + "Can't get the descriptor of an unrecognized enum value."); + } + return getDescriptor().getValues().get(ordinal()); + } + + public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() { + return getDescriptor(); + } + + public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() { + return com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDescriptor() + .getEnumTypes() + .get(0); + } + + private static final State[] VALUES = values(); + + public static State valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc) { + if (desc.getType() != getDescriptor()) { + throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type."); + } + if (desc.getIndex() == -1) { + return UNRECOGNIZED; + } + return VALUES[desc.getIndex()]; + } + + private final int value; + + private State(int value) { + this.value = value; + } + + // @@protoc_insertion_point(enum_scope:google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State) + } + + public static final int STATE_FIELD_NUMBER = 1; + private int state_ = 0; + /** + * + * + * 
+     * Output only. An output-only field that indicates the state of the Kinesis
+     * ingestion source.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @return The enum numeric value on the wire for state. + */ + @java.lang.Override + public int getStateValue() { + return state_; + } + /** + * + * + * 
+     * Output only. An output-only field that indicates the state of the Kinesis
+     * ingestion source.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @return The state. + */ + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State getState() { + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State result = + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State.forNumber(state_); + return result == null + ? com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State.UNRECOGNIZED + : result; + } + + public static final int STREAM_ARN_FIELD_NUMBER = 2; + + @SuppressWarnings("serial") + private volatile java.lang.Object streamArn_ = ""; + /** + * + * + * 
+     * Required. The Kinesis stream ARN to ingest data from.
+     *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The streamArn. + */ + @java.lang.Override + public java.lang.String getStreamArn() { + java.lang.Object ref = streamArn_; + if (ref instanceof java.lang.String) { + return (java.lang.String) ref; + } else { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + streamArn_ = s; + return s; + } + } + /** + * + * + * 
+     * Required. The Kinesis stream ARN to ingest data from.
+     *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for streamArn. + */ + @java.lang.Override + public com.google.protobuf.ByteString getStreamArnBytes() { + java.lang.Object ref = streamArn_; + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + streamArn_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + + public static final int CONSUMER_ARN_FIELD_NUMBER = 3; + + @SuppressWarnings("serial") + private volatile java.lang.Object consumerArn_ = ""; + /** + * + * + * 
+     * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+     * Fan-Out mode. The consumer must be already created and ready to be used.
+     *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The consumerArn. + */ + @java.lang.Override + public java.lang.String getConsumerArn() { + java.lang.Object ref = consumerArn_; + if (ref instanceof java.lang.String) { + return (java.lang.String) ref; + } else { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + consumerArn_ = s; + return s; + } + } + /** + * + * + * 
+     * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+     * Fan-Out mode. The consumer must be already created and ready to be used.
+     *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for consumerArn. + */ + @java.lang.Override + public com.google.protobuf.ByteString getConsumerArnBytes() { + java.lang.Object ref = consumerArn_; + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + consumerArn_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + + public static final int AWS_ROLE_ARN_FIELD_NUMBER = 4; + + @SuppressWarnings("serial") + private volatile java.lang.Object awsRoleArn_ = ""; + /** + * + * + * 
+     * Required. AWS role ARN to be used for Federated Identity authentication
+     * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+     * required permissions that need to be attached to it.
+     *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The awsRoleArn. + */ + @java.lang.Override + public java.lang.String getAwsRoleArn() { + java.lang.Object ref = awsRoleArn_; + if (ref instanceof java.lang.String) { + return (java.lang.String) ref; + } else { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + awsRoleArn_ = s; + return s; + } + } + /** + * + * + * 
+     * Required. AWS role ARN to be used for Federated Identity authentication
+     * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+     * required permissions that need to be attached to it.
+     *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for awsRoleArn. + */ + @java.lang.Override + public com.google.protobuf.ByteString getAwsRoleArnBytes() { + java.lang.Object ref = awsRoleArn_; + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + awsRoleArn_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + + public static final int GCP_SERVICE_ACCOUNT_FIELD_NUMBER = 5; + + @SuppressWarnings("serial") + private volatile java.lang.Object gcpServiceAccount_ = ""; + /** + * + * + * 
+     * Required. The GCP service account to be used for Federated Identity
+     * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+     * the provided role). The `aws_role_arn` must be set up with
+     * `accounts.google.com:sub` equals to this service account number.
+     *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The gcpServiceAccount. + */ + @java.lang.Override + public java.lang.String getGcpServiceAccount() { + java.lang.Object ref = gcpServiceAccount_; + if (ref instanceof java.lang.String) { + return (java.lang.String) ref; + } else { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + gcpServiceAccount_ = s; + return s; + } + } + /** + * + * + * 
+     * Required. The GCP service account to be used for Federated Identity
+     * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+     * the provided role). The `aws_role_arn` must be set up with
+     * `accounts.google.com:sub` equals to this service account number.
+     *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for gcpServiceAccount. + */ + @java.lang.Override + public com.google.protobuf.ByteString getGcpServiceAccountBytes() { + java.lang.Object ref = gcpServiceAccount_; + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + gcpServiceAccount_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + + private byte memoizedIsInitialized = -1; + + @java.lang.Override + public final boolean isInitialized() { + byte isInitialized = memoizedIsInitialized; + if (isInitialized == 1) return true; + if (isInitialized == 0) return false; + + memoizedIsInitialized = 1; + return true; + } + + @java.lang.Override + public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException { + if (state_ + != com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State.STATE_UNSPECIFIED + .getNumber()) { + output.writeEnum(1, state_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(streamArn_)) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 2, streamArn_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(consumerArn_)) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 3, consumerArn_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(awsRoleArn_)) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 4, awsRoleArn_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(gcpServiceAccount_)) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 5, gcpServiceAccount_); + } + getUnknownFields().writeTo(output); + } + + @java.lang.Override + public int getSerializedSize() { + int size = memoizedSize; + if (size != -1) return size; + + size = 0; + if (state_ + != com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State.STATE_UNSPECIFIED + .getNumber()) { + size += com.google.protobuf.CodedOutputStream.computeEnumSize(1, state_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(streamArn_)) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, streamArn_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(consumerArn_)) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(3, consumerArn_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(awsRoleArn_)) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(4, awsRoleArn_); + } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(gcpServiceAccount_)) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(5, gcpServiceAccount_); + } + size += getUnknownFields().getSerializedSize(); + memoizedSize = size; + return size; + } + + @java.lang.Override + public boolean equals(final java.lang.Object obj) { + if (obj == this) { + return true; + } + if (!(obj instanceof com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis)) { + return super.equals(obj); + } + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis other = + (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) obj; + + if (state_ != other.state_) return false; + if (!getStreamArn().equals(other.getStreamArn())) return false; + if (!getConsumerArn().equals(other.getConsumerArn())) return false; + if (!getAwsRoleArn().equals(other.getAwsRoleArn())) return false; + if (!getGcpServiceAccount().equals(other.getGcpServiceAccount())) return false; + if (!getUnknownFields().equals(other.getUnknownFields())) return false; + return true; + } + + @java.lang.Override + public int hashCode() { + if (memoizedHashCode != 0) { + return memoizedHashCode; + } + int hash = 41; + hash = (19 * hash) + getDescriptor().hashCode(); + hash = (37 * hash) + STATE_FIELD_NUMBER; + hash = (53 * hash) + state_; + hash = (37 * hash) + STREAM_ARN_FIELD_NUMBER; + hash = (53 * hash) + getStreamArn().hashCode(); + hash = (37 * hash) + CONSUMER_ARN_FIELD_NUMBER; + hash = (53 * hash) + getConsumerArn().hashCode(); + hash = (37 * hash) + AWS_ROLE_ARN_FIELD_NUMBER; + hash = (53 * hash) + getAwsRoleArn().hashCode(); + hash = (37 * hash) + GCP_SERVICE_ACCOUNT_FIELD_NUMBER; + hash = (53 * hash) + getGcpServiceAccount().hashCode(); + hash = (29 * hash) + getUnknownFields().hashCode(); + memoizedHashCode = hash; + return hash; + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + java.nio.ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + com.google.protobuf.ByteString data) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + com.google.protobuf.ByteString data, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom(byte[] data) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + java.io.InputStream input) throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException( + PARSER, input, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseDelimitedFrom( + java.io.InputStream input) throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseDelimitedFrom( + java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException( + PARSER, input, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + com.google.protobuf.CodedInputStream input) throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis parseFrom( + com.google.protobuf.CodedInputStream input, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException( + PARSER, input, extensionRegistry); + } + + @java.lang.Override + public Builder newBuilderForType() { + return newBuilder(); + } + + public static Builder newBuilder() { + return DEFAULT_INSTANCE.toBuilder(); + } + + public static Builder newBuilder( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis prototype) { + return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype); + } + + @java.lang.Override + public Builder toBuilder() { + return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this); + } + + @java.lang.Override + protected Builder newBuilderForType( + com.google.protobuf.GeneratedMessageV3.BuilderParent parent) { + Builder builder = new Builder(parent); + return builder; + } + /** + * + * + * 
+     * Ingestion settings for Amazon Kinesis Data Streams.
+     *
+ * + * Protobuf type {@code google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis} + */ + public static final class Builder + extends com.google.protobuf.GeneratedMessageV3.Builder + implements + // @@protoc_insertion_point(builder_implements:google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesisOrBuilder { + public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_descriptor; + } + + @java.lang.Override + protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable + internalGetFieldAccessorTable() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_fieldAccessorTable + .ensureFieldAccessorsInitialized( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.class, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.Builder.class); + } + + // Construct using com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.newBuilder() + private Builder() {} + + private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) { + super(parent); + } + + @java.lang.Override + public Builder clear() { + super.clear(); + bitField0_ = 0; + state_ = 0; + streamArn_ = ""; + consumerArn_ = ""; + awsRoleArn_ = ""; + gcpServiceAccount_ = ""; + return this; + } + + @java.lang.Override + public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_descriptor; + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis + getDefaultInstanceForType() { + return com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance(); + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis build() { + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis result = buildPartial(); + if (!result.isInitialized()) { + throw newUninitializedMessageException(result); + } + return result; + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis buildPartial() { + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis result = + new com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis(this); + if (bitField0_ != 0) { + buildPartial0(result); + } + onBuilt(); + return result; + } + + private void buildPartial0( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis result) { + int from_bitField0_ = bitField0_; + if (((from_bitField0_ & 0x00000001) != 0)) { + result.state_ = state_; + } + if (((from_bitField0_ & 0x00000002) != 0)) { + result.streamArn_ = streamArn_; + } + if (((from_bitField0_ & 0x00000004) != 0)) { + result.consumerArn_ = consumerArn_; + } + if (((from_bitField0_ & 0x00000008) != 0)) { + result.awsRoleArn_ = awsRoleArn_; + } + if (((from_bitField0_ & 0x00000010) != 0)) { + result.gcpServiceAccount_ = gcpServiceAccount_; + } + } + + @java.lang.Override + public Builder clone() { + return super.clone(); + } + + @java.lang.Override + public Builder setField( + com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) { + return super.setField(field, value); + } + + @java.lang.Override + public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) { + return super.clearField(field); + } + + @java.lang.Override + public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) { + return super.clearOneof(oneof); + } + + @java.lang.Override + public Builder setRepeatedField( + com.google.protobuf.Descriptors.FieldDescriptor field, + int index, + java.lang.Object value) { + return super.setRepeatedField(field, index, value); + } + + @java.lang.Override + public Builder addRepeatedField( + com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) { + return super.addRepeatedField(field, value); + } + + @java.lang.Override + public Builder mergeFrom(com.google.protobuf.Message other) { + if (other instanceof com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) { + return mergeFrom((com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) other); + } else { + super.mergeFrom(other); + return this; + } + } + + public Builder mergeFrom(com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis other) { + if (other + == com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance()) + return this; + if (other.state_ != 0) { + setStateValue(other.getStateValue()); + } + if (!other.getStreamArn().isEmpty()) { + streamArn_ = other.streamArn_; + bitField0_ |= 0x00000002; + onChanged(); + } + if (!other.getConsumerArn().isEmpty()) { + consumerArn_ = other.consumerArn_; + bitField0_ |= 0x00000004; + onChanged(); + } + if (!other.getAwsRoleArn().isEmpty()) { + awsRoleArn_ = other.awsRoleArn_; + bitField0_ |= 0x00000008; + onChanged(); + } + if (!other.getGcpServiceAccount().isEmpty()) { + gcpServiceAccount_ = other.gcpServiceAccount_; + bitField0_ |= 0x00000010; + onChanged(); + } + this.mergeUnknownFields(other.getUnknownFields()); + onChanged(); + return this; + } + + @java.lang.Override + public final boolean isInitialized() { + return true; + } + + @java.lang.Override + public Builder mergeFrom( + com.google.protobuf.CodedInputStream input, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + if (extensionRegistry == null) { + throw new java.lang.NullPointerException(); + } + try { + boolean done = false; + while (!done) { + int tag = input.readTag(); + switch (tag) { + case 0: + done = true; + break; + case 8: + { + state_ = input.readEnum(); + bitField0_ |= 0x00000001; + break; + } // case 8 + case 18: + { + streamArn_ = input.readStringRequireUtf8(); + bitField0_ |= 0x00000002; + break; + } // case 18 + case 26: + { + consumerArn_ = input.readStringRequireUtf8(); + bitField0_ |= 0x00000004; + break; + } // case 26 + case 34: + { + awsRoleArn_ = input.readStringRequireUtf8(); + bitField0_ |= 0x00000008; + break; + } // case 34 + case 42: + { + gcpServiceAccount_ = input.readStringRequireUtf8(); + bitField0_ |= 0x00000010; + break; + } // case 42 + default: + { + if (!super.parseUnknownField(input, extensionRegistry, tag)) { + done = true; // was an endgroup tag + } + break; + } // default: + } // switch (tag) + } // while (!done) + } catch (com.google.protobuf.InvalidProtocolBufferException e) { + throw e.unwrapIOException(); + } finally { + onChanged(); + } // finally + return this; + } + + private int bitField0_; + + private int state_ = 0; + /** + * + * + * 
+       * Output only. An output-only field that indicates the state of the Kinesis
+       * ingestion source.
+       *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @return The enum numeric value on the wire for state. + */ + @java.lang.Override + public int getStateValue() { + return state_; + } + /** + * + * + * 
+       * Output only. An output-only field that indicates the state of the Kinesis
+       * ingestion source.
+       *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @param value The enum numeric value on the wire for state to set. + * @return This builder for chaining. + */ + public Builder setStateValue(int value) { + state_ = value; + bitField0_ |= 0x00000001; + onChanged(); + return this; + } + /** + * + * + * 
+       * Output only. An output-only field that indicates the state of the Kinesis
+       * ingestion source.
+       *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @return The state. + */ + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State getState() { + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State result = + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State.forNumber(state_); + return result == null + ? com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State.UNRECOGNIZED + : result; + } + /** + * + * + * 
+       * Output only. An output-only field that indicates the state of the Kinesis
+       * ingestion source.
+       *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @param value The state to set. + * @return This builder for chaining. + */ + public Builder setState( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State value) { + if (value == null) { + throw new NullPointerException(); + } + bitField0_ |= 0x00000001; + state_ = value.getNumber(); + onChanged(); + return this; + } + /** + * + * + * 
+       * Output only. An output-only field that indicates the state of the Kinesis
+       * ingestion source.
+       *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.State state = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * + * + * @return This builder for chaining. + */ + public Builder clearState() { + bitField0_ = (bitField0_ & ~0x00000001); + state_ = 0; + onChanged(); + return this; + } + + private java.lang.Object streamArn_ = ""; + /** + * + * + * 
+       * Required. The Kinesis stream ARN to ingest data from.
+       *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The streamArn. + */ + public java.lang.String getStreamArn() { + java.lang.Object ref = streamArn_; + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + streamArn_ = s; + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + * 
+       * Required. The Kinesis stream ARN to ingest data from.
+       *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for streamArn. + */ + public com.google.protobuf.ByteString getStreamArnBytes() { + java.lang.Object ref = streamArn_; + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + streamArn_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + * 
+       * Required. The Kinesis stream ARN to ingest data from.
+       *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The streamArn to set. + * @return This builder for chaining. + */ + public Builder setStreamArn(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + streamArn_ = value; + bitField0_ |= 0x00000002; + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. The Kinesis stream ARN to ingest data from.
+       *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @return This builder for chaining. + */ + public Builder clearStreamArn() { + streamArn_ = getDefaultInstance().getStreamArn(); + bitField0_ = (bitField0_ & ~0x00000002); + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. The Kinesis stream ARN to ingest data from.
+       *
+ * + * string stream_arn = 2 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The bytes for streamArn to set. + * @return This builder for chaining. + */ + public Builder setStreamArnBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + streamArn_ = value; + bitField0_ |= 0x00000002; + onChanged(); + return this; + } + + private java.lang.Object consumerArn_ = ""; + /** + * + * + * 
+       * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+       * Fan-Out mode. The consumer must be already created and ready to be used.
+       *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The consumerArn. + */ + public java.lang.String getConsumerArn() { + java.lang.Object ref = consumerArn_; + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + consumerArn_ = s; + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + * 
+       * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+       * Fan-Out mode. The consumer must be already created and ready to be used.
+       *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for consumerArn. + */ + public com.google.protobuf.ByteString getConsumerArnBytes() { + java.lang.Object ref = consumerArn_; + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + consumerArn_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + * 
+       * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+       * Fan-Out mode. The consumer must be already created and ready to be used.
+       *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The consumerArn to set. + * @return This builder for chaining. + */ + public Builder setConsumerArn(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + consumerArn_ = value; + bitField0_ |= 0x00000004; + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+       * Fan-Out mode. The consumer must be already created and ready to be used.
+       *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @return This builder for chaining. + */ + public Builder clearConsumerArn() { + consumerArn_ = getDefaultInstance().getConsumerArn(); + bitField0_ = (bitField0_ & ~0x00000004); + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+       * Fan-Out mode. The consumer must be already created and ready to be used.
+       *
+ * + * string consumer_arn = 3 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The bytes for consumerArn to set. + * @return This builder for chaining. + */ + public Builder setConsumerArnBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + consumerArn_ = value; + bitField0_ |= 0x00000004; + onChanged(); + return this; + } + + private java.lang.Object awsRoleArn_ = ""; + /** + * + * + * 
+       * Required. AWS role ARN to be used for Federated Identity authentication
+       * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+       * required permissions that need to be attached to it.
+       *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The awsRoleArn. + */ + public java.lang.String getAwsRoleArn() { + java.lang.Object ref = awsRoleArn_; + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + awsRoleArn_ = s; + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + * 
+       * Required. AWS role ARN to be used for Federated Identity authentication
+       * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+       * required permissions that need to be attached to it.
+       *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for awsRoleArn. + */ + public com.google.protobuf.ByteString getAwsRoleArnBytes() { + java.lang.Object ref = awsRoleArn_; + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + awsRoleArn_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + * 
+       * Required. AWS role ARN to be used for Federated Identity authentication
+       * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+       * required permissions that need to be attached to it.
+       *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The awsRoleArn to set. + * @return This builder for chaining. + */ + public Builder setAwsRoleArn(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + awsRoleArn_ = value; + bitField0_ |= 0x00000008; + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. AWS role ARN to be used for Federated Identity authentication
+       * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+       * required permissions that need to be attached to it.
+       *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @return This builder for chaining. + */ + public Builder clearAwsRoleArn() { + awsRoleArn_ = getDefaultInstance().getAwsRoleArn(); + bitField0_ = (bitField0_ & ~0x00000008); + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. AWS role ARN to be used for Federated Identity authentication
+       * with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+       * required permissions that need to be attached to it.
+       *
+ * + * string aws_role_arn = 4 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The bytes for awsRoleArn to set. + * @return This builder for chaining. + */ + public Builder setAwsRoleArnBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + awsRoleArn_ = value; + bitField0_ |= 0x00000008; + onChanged(); + return this; + } + + private java.lang.Object gcpServiceAccount_ = ""; + /** + * + * + * 
+       * Required. The GCP service account to be used for Federated Identity
+       * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+       * the provided role). The `aws_role_arn` must be set up with
+       * `accounts.google.com:sub` equals to this service account number.
+       *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The gcpServiceAccount. + */ + public java.lang.String getGcpServiceAccount() { + java.lang.Object ref = gcpServiceAccount_; + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + gcpServiceAccount_ = s; + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + * 
+       * Required. The GCP service account to be used for Federated Identity
+       * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+       * the provided role). The `aws_role_arn` must be set up with
+       * `accounts.google.com:sub` equals to this service account number.
+       *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @return The bytes for gcpServiceAccount. + */ + public com.google.protobuf.ByteString getGcpServiceAccountBytes() { + java.lang.Object ref = gcpServiceAccount_; + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + gcpServiceAccount_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + * 
+       * Required. The GCP service account to be used for Federated Identity
+       * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+       * the provided role). The `aws_role_arn` must be set up with
+       * `accounts.google.com:sub` equals to this service account number.
+       *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The gcpServiceAccount to set. + * @return This builder for chaining. + */ + public Builder setGcpServiceAccount(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + gcpServiceAccount_ = value; + bitField0_ |= 0x00000010; + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. The GCP service account to be used for Federated Identity
+       * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+       * the provided role). The `aws_role_arn` must be set up with
+       * `accounts.google.com:sub` equals to this service account number.
+       *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @return This builder for chaining. + */ + public Builder clearGcpServiceAccount() { + gcpServiceAccount_ = getDefaultInstance().getGcpServiceAccount(); + bitField0_ = (bitField0_ & ~0x00000010); + onChanged(); + return this; + } + /** + * + * + * 
+       * Required. The GCP service account to be used for Federated Identity
+       * authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+       * the provided role). The `aws_role_arn` must be set up with
+       * `accounts.google.com:sub` equals to this service account number.
+       *
+ * + * string gcp_service_account = 5 [(.google.api.field_behavior) = REQUIRED]; + * + * @param value The bytes for gcpServiceAccount to set. + * @return This builder for chaining. + */ + public Builder setGcpServiceAccountBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + gcpServiceAccount_ = value; + bitField0_ |= 0x00000010; + onChanged(); + return this; + } + + @java.lang.Override + public final Builder setUnknownFields( + final com.google.protobuf.UnknownFieldSet unknownFields) { + return super.setUnknownFields(unknownFields); + } + + @java.lang.Override + public final Builder mergeUnknownFields( + final com.google.protobuf.UnknownFieldSet unknownFields) { + return super.mergeUnknownFields(unknownFields); + } + + // @@protoc_insertion_point(builder_scope:google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) + } + + // @@protoc_insertion_point(class_scope:google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) + private static final com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis + DEFAULT_INSTANCE; + + static { + DEFAULT_INSTANCE = new com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis(); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis getDefaultInstance() { + return DEFAULT_INSTANCE; + } + + private static final com.google.protobuf.Parser PARSER = + new com.google.protobuf.AbstractParser() { + @java.lang.Override + public AwsKinesis parsePartialFrom( + com.google.protobuf.CodedInputStream input, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + Builder builder = newBuilder(); + try { + builder.mergeFrom(input, extensionRegistry); + } catch (com.google.protobuf.InvalidProtocolBufferException e) { + throw e.setUnfinishedMessage(builder.buildPartial()); + } catch (com.google.protobuf.UninitializedMessageException e) { + throw e.asInvalidProtocolBufferException() + .setUnfinishedMessage(builder.buildPartial()); + } catch (java.io.IOException e) { + throw new com.google.protobuf.InvalidProtocolBufferException(e) + .setUnfinishedMessage(builder.buildPartial()); + } + return builder.buildPartial(); + } + }; + + public static com.google.protobuf.Parser parser() { + return PARSER; + } + + @java.lang.Override + public com.google.protobuf.Parser getParserForType() { + return PARSER; + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis getDefaultInstanceForType() { + return DEFAULT_INSTANCE; + } + } + + private int sourceCase_ = 0; + + @SuppressWarnings("serial") + private java.lang.Object source_; + + public enum SourceCase + implements + com.google.protobuf.Internal.EnumLite, + com.google.protobuf.AbstractMessage.InternalOneOfEnum { + AWS_KINESIS(1), + SOURCE_NOT_SET(0); + private final int value; + + private SourceCase(int value) { + this.value = value; + } + /** + * @param value The number of the enum to look for. + * @return The enum associated with the given number. + * @deprecated Use {@link #forNumber(int)} instead. + */ + @java.lang.Deprecated + public static SourceCase valueOf(int value) { + return forNumber(value); + } + + public static SourceCase forNumber(int value) { + switch (value) { + case 1: + return AWS_KINESIS; + case 0: + return SOURCE_NOT_SET; + default: + return null; + } + } + + public int getNumber() { + return this.value; + } + }; + + public SourceCase getSourceCase() { + return SourceCase.forNumber(sourceCase_); + } + + public static final int AWS_KINESIS_FIELD_NUMBER = 1; + /** + * + * + * 
+   * Optional. Amazon Kinesis Data Streams.
+   *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + * + * @return Whether the awsKinesis field is set. + */ + @java.lang.Override + public boolean hasAwsKinesis() { + return sourceCase_ == 1; + } + /** + * + * + * 
+   * Optional. Amazon Kinesis Data Streams.
+   *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + * + * @return The awsKinesis. + */ + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis getAwsKinesis() { + if (sourceCase_ == 1) { + return (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_; + } + return com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance(); + } + /** + * + * + * 
+   * Optional. Amazon Kinesis Data Streams.
+   *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesisOrBuilder + getAwsKinesisOrBuilder() { + if (sourceCase_ == 1) { + return (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_; + } + return com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance(); + } + + private byte memoizedIsInitialized = -1; + + @java.lang.Override + public final boolean isInitialized() { + byte isInitialized = memoizedIsInitialized; + if (isInitialized == 1) return true; + if (isInitialized == 0) return false; + + memoizedIsInitialized = 1; + return true; + } + + @java.lang.Override + public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException { + if (sourceCase_ == 1) { + output.writeMessage(1, (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_); + } + getUnknownFields().writeTo(output); + } + + @java.lang.Override + public int getSerializedSize() { + int size = memoizedSize; + if (size != -1) return size; + + size = 0; + if (sourceCase_ == 1) { + size += + com.google.protobuf.CodedOutputStream.computeMessageSize( + 1, (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_); + } + size += getUnknownFields().getSerializedSize(); + memoizedSize = size; + return size; + } + + @java.lang.Override + public boolean equals(final java.lang.Object obj) { + if (obj == this) { + return true; + } + if (!(obj instanceof com.google.pubsub.v1.IngestionDataSourceSettings)) { + return super.equals(obj); + } + com.google.pubsub.v1.IngestionDataSourceSettings other = + (com.google.pubsub.v1.IngestionDataSourceSettings) obj; + + if (!getSourceCase().equals(other.getSourceCase())) return false; + switch (sourceCase_) { + case 1: + if (!getAwsKinesis().equals(other.getAwsKinesis())) return false; + break; + case 0: + default: + } + if (!getUnknownFields().equals(other.getUnknownFields())) return false; + return true; + } + + @java.lang.Override + public int hashCode() { + if (memoizedHashCode != 0) { + return memoizedHashCode; + } + int hash = 41; + hash = (19 * hash) + getDescriptor().hashCode(); + switch (sourceCase_) { + case 1: + hash = (37 * hash) + AWS_KINESIS_FIELD_NUMBER; + hash = (53 * hash) + getAwsKinesis().hashCode(); + break; + case 0: + default: + } + hash = (29 * hash) + getUnknownFields().hashCode(); + memoizedHashCode = hash; + return hash; + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom(java.nio.ByteBuffer data) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + com.google.protobuf.ByteString data) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + com.google.protobuf.ByteString data, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom(byte[] data) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + return PARSER.parseFrom(data, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + java.io.InputStream input) throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException( + PARSER, input, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseDelimitedFrom( + java.io.InputStream input) throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseDelimitedFrom( + java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException( + PARSER, input, extensionRegistry); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + com.google.protobuf.CodedInputStream input) throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings parseFrom( + com.google.protobuf.CodedInputStream input, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + return com.google.protobuf.GeneratedMessageV3.parseWithIOException( + PARSER, input, extensionRegistry); + } + + @java.lang.Override + public Builder newBuilderForType() { + return newBuilder(); + } + + public static Builder newBuilder() { + return DEFAULT_INSTANCE.toBuilder(); + } + + public static Builder newBuilder(com.google.pubsub.v1.IngestionDataSourceSettings prototype) { + return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype); + } + + @java.lang.Override + public Builder toBuilder() { + return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this); + } + + @java.lang.Override + protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) { + Builder builder = new Builder(parent); + return builder; + } + /** + * + * + * 
+   * Settings for an ingestion data source on a topic.
+   *
+ * + * Protobuf type {@code google.pubsub.v1.IngestionDataSourceSettings} + */ + public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder + implements + // @@protoc_insertion_point(builder_implements:google.pubsub.v1.IngestionDataSourceSettings) + com.google.pubsub.v1.IngestionDataSourceSettingsOrBuilder { + public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_descriptor; + } + + @java.lang.Override + protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable + internalGetFieldAccessorTable() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_fieldAccessorTable + .ensureFieldAccessorsInitialized( + com.google.pubsub.v1.IngestionDataSourceSettings.class, + com.google.pubsub.v1.IngestionDataSourceSettings.Builder.class); + } + + // Construct using com.google.pubsub.v1.IngestionDataSourceSettings.newBuilder() + private Builder() {} + + private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) { + super(parent); + } + + @java.lang.Override + public Builder clear() { + super.clear(); + bitField0_ = 0; + if (awsKinesisBuilder_ != null) { + awsKinesisBuilder_.clear(); + } + sourceCase_ = 0; + source_ = null; + return this; + } + + @java.lang.Override + public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() { + return com.google.pubsub.v1.PubsubProto + .internal_static_google_pubsub_v1_IngestionDataSourceSettings_descriptor; + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings getDefaultInstanceForType() { + return com.google.pubsub.v1.IngestionDataSourceSettings.getDefaultInstance(); + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings build() { + com.google.pubsub.v1.IngestionDataSourceSettings result = buildPartial(); + if (!result.isInitialized()) { + throw newUninitializedMessageException(result); + } + return result; + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings buildPartial() { + com.google.pubsub.v1.IngestionDataSourceSettings result = + new com.google.pubsub.v1.IngestionDataSourceSettings(this); + if (bitField0_ != 0) { + buildPartial0(result); + } + buildPartialOneofs(result); + onBuilt(); + return result; + } + + private void buildPartial0(com.google.pubsub.v1.IngestionDataSourceSettings result) { + int from_bitField0_ = bitField0_; + } + + private void buildPartialOneofs(com.google.pubsub.v1.IngestionDataSourceSettings result) { + result.sourceCase_ = sourceCase_; + result.source_ = this.source_; + if (sourceCase_ == 1 && awsKinesisBuilder_ != null) { + result.source_ = awsKinesisBuilder_.build(); + } + } + + @java.lang.Override + public Builder clone() { + return super.clone(); + } + + @java.lang.Override + public Builder setField( + com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) { + return super.setField(field, value); + } + + @java.lang.Override + public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) { + return super.clearField(field); + } + + @java.lang.Override + public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) { + return super.clearOneof(oneof); + } + + @java.lang.Override + public Builder setRepeatedField( + com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) { + return super.setRepeatedField(field, index, value); + } + + @java.lang.Override + public Builder addRepeatedField( + com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) { + return super.addRepeatedField(field, value); + } + + @java.lang.Override + public Builder mergeFrom(com.google.protobuf.Message other) { + if (other instanceof com.google.pubsub.v1.IngestionDataSourceSettings) { + return mergeFrom((com.google.pubsub.v1.IngestionDataSourceSettings) other); + } else { + super.mergeFrom(other); + return this; + } + } + + public Builder mergeFrom(com.google.pubsub.v1.IngestionDataSourceSettings other) { + if (other == com.google.pubsub.v1.IngestionDataSourceSettings.getDefaultInstance()) + return this; + switch (other.getSourceCase()) { + case AWS_KINESIS: + { + mergeAwsKinesis(other.getAwsKinesis()); + break; + } + case SOURCE_NOT_SET: + { + break; + } + } + this.mergeUnknownFields(other.getUnknownFields()); + onChanged(); + return this; + } + + @java.lang.Override + public final boolean isInitialized() { + return true; + } + + @java.lang.Override + public Builder mergeFrom( + com.google.protobuf.CodedInputStream input, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws java.io.IOException { + if (extensionRegistry == null) { + throw new java.lang.NullPointerException(); + } + try { + boolean done = false; + while (!done) { + int tag = input.readTag(); + switch (tag) { + case 0: + done = true; + break; + case 10: + { + input.readMessage(getAwsKinesisFieldBuilder().getBuilder(), extensionRegistry); + sourceCase_ = 1; + break; + } // case 10 + default: + { + if (!super.parseUnknownField(input, extensionRegistry, tag)) { + done = true; // was an endgroup tag + } + break; + } // default: + } // switch (tag) + } // while (!done) + } catch (com.google.protobuf.InvalidProtocolBufferException e) { + throw e.unwrapIOException(); + } finally { + onChanged(); + } // finally + return this; + } + + private int sourceCase_ = 0; + private java.lang.Object source_; + + public SourceCase getSourceCase() { + return SourceCase.forNumber(sourceCase_); + } + + public Builder clearSource() { + sourceCase_ = 0; + source_ = null; + onChanged(); + return this; + } + + private int bitField0_; + + private com.google.protobuf.SingleFieldBuilderV3< + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.Builder, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesisOrBuilder> + awsKinesisBuilder_; + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + * + * @return Whether the awsKinesis field is set. + */ + @java.lang.Override + public boolean hasAwsKinesis() { + return sourceCase_ == 1; + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + * + * @return The awsKinesis. + */ + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis getAwsKinesis() { + if (awsKinesisBuilder_ == null) { + if (sourceCase_ == 1) { + return (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_; + } + return com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance(); + } else { + if (sourceCase_ == 1) { + return awsKinesisBuilder_.getMessage(); + } + return com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance(); + } + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + public Builder setAwsKinesis( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis value) { + if (awsKinesisBuilder_ == null) { + if (value == null) { + throw new NullPointerException(); + } + source_ = value; + onChanged(); + } else { + awsKinesisBuilder_.setMessage(value); + } + sourceCase_ = 1; + return this; + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + public Builder setAwsKinesis( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.Builder builderForValue) { + if (awsKinesisBuilder_ == null) { + source_ = builderForValue.build(); + onChanged(); + } else { + awsKinesisBuilder_.setMessage(builderForValue.build()); + } + sourceCase_ = 1; + return this; + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + public Builder mergeAwsKinesis( + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis value) { + if (awsKinesisBuilder_ == null) { + if (sourceCase_ == 1 + && source_ + != com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis + .getDefaultInstance()) { + source_ = + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.newBuilder( + (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_) + .mergeFrom(value) + .buildPartial(); + } else { + source_ = value; + } + onChanged(); + } else { + if (sourceCase_ == 1) { + awsKinesisBuilder_.mergeFrom(value); + } else { + awsKinesisBuilder_.setMessage(value); + } + } + sourceCase_ = 1; + return this; + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + public Builder clearAwsKinesis() { + if (awsKinesisBuilder_ == null) { + if (sourceCase_ == 1) { + sourceCase_ = 0; + source_ = null; + onChanged(); + } + } else { + if (sourceCase_ == 1) { + sourceCase_ = 0; + source_ = null; + } + awsKinesisBuilder_.clear(); + } + return this; + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.Builder + getAwsKinesisBuilder() { + return getAwsKinesisFieldBuilder().getBuilder(); + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesisOrBuilder + getAwsKinesisOrBuilder() { + if ((sourceCase_ == 1) && (awsKinesisBuilder_ != null)) { + return awsKinesisBuilder_.getMessageOrBuilder(); + } else { + if (sourceCase_ == 1) { + return (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_; + } + return com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance(); + } + } + /** + * + * + * 
+     * Optional. Amazon Kinesis Data Streams.
+     *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + private com.google.protobuf.SingleFieldBuilderV3< + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.Builder, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesisOrBuilder> + getAwsKinesisFieldBuilder() { + if (awsKinesisBuilder_ == null) { + if (!(sourceCase_ == 1)) { + source_ = + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.getDefaultInstance(); + } + awsKinesisBuilder_ = + new com.google.protobuf.SingleFieldBuilderV3< + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis.Builder, + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesisOrBuilder>( + (com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis) source_, + getParentForChildren(), + isClean()); + source_ = null; + } + sourceCase_ = 1; + onChanged(); + return awsKinesisBuilder_; + } + + @java.lang.Override + public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) { + return super.setUnknownFields(unknownFields); + } + + @java.lang.Override + public final Builder mergeUnknownFields( + final com.google.protobuf.UnknownFieldSet unknownFields) { + return super.mergeUnknownFields(unknownFields); + } + + // @@protoc_insertion_point(builder_scope:google.pubsub.v1.IngestionDataSourceSettings) + } + + // @@protoc_insertion_point(class_scope:google.pubsub.v1.IngestionDataSourceSettings) + private static final com.google.pubsub.v1.IngestionDataSourceSettings DEFAULT_INSTANCE; + + static { + DEFAULT_INSTANCE = new com.google.pubsub.v1.IngestionDataSourceSettings(); + } + + public static com.google.pubsub.v1.IngestionDataSourceSettings getDefaultInstance() { + return DEFAULT_INSTANCE; + } + + private static final com.google.protobuf.Parser PARSER = + new com.google.protobuf.AbstractParser() { + @java.lang.Override + public IngestionDataSourceSettings parsePartialFrom( + com.google.protobuf.CodedInputStream input, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + Builder builder = newBuilder(); + try { + builder.mergeFrom(input, extensionRegistry); + } catch (com.google.protobuf.InvalidProtocolBufferException e) { + throw e.setUnfinishedMessage(builder.buildPartial()); + } catch (com.google.protobuf.UninitializedMessageException e) { + throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial()); + } catch (java.io.IOException e) { + throw new com.google.protobuf.InvalidProtocolBufferException(e) + .setUnfinishedMessage(builder.buildPartial()); + } + return builder.buildPartial(); + } + }; + + public static com.google.protobuf.Parser parser() { + return PARSER; + } + + @java.lang.Override + public com.google.protobuf.Parser getParserForType() { + return PARSER; + } + + @java.lang.Override + public com.google.pubsub.v1.IngestionDataSourceSettings getDefaultInstanceForType() { + return DEFAULT_INSTANCE; + } +} diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/IngestionDataSourceSettingsOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/IngestionDataSourceSettingsOrBuilder.java new file mode 100644 index 000000000..a343777ad --- /dev/null +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/IngestionDataSourceSettingsOrBuilder.java @@ -0,0 +1,68 @@ +/* + * Copyright 2024 Google LLC + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +// Generated by the protocol buffer compiler. DO NOT EDIT! +// source: google/pubsub/v1/pubsub.proto + +package com.google.pubsub.v1; + +public interface IngestionDataSourceSettingsOrBuilder + extends + // @@protoc_insertion_point(interface_extends:google.pubsub.v1.IngestionDataSourceSettings) + com.google.protobuf.MessageOrBuilder { + + /** + * + * + * 
+   * Optional. Amazon Kinesis Data Streams.
+   *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + * + * @return Whether the awsKinesis field is set. + */ + boolean hasAwsKinesis(); + /** + * + * + * 
+   * Optional. Amazon Kinesis Data Streams.
+   *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + * + * @return The awsKinesis. + */ + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis getAwsKinesis(); + /** + * + * + * 
+   * Optional. Amazon Kinesis Data Streams.
+   *
+ * + * + * .google.pubsub.v1.IngestionDataSourceSettings.AwsKinesis aws_kinesis = 1 [(.google.api.field_behavior) = OPTIONAL]; + * + */ + com.google.pubsub.v1.IngestionDataSourceSettings.AwsKinesisOrBuilder getAwsKinesisOrBuilder(); + + com.google.pubsub.v1.IngestionDataSourceSettings.SourceCase getSourceCase(); +} diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequest.java index cba091850..2831126cf 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequestOrBuilder.java index 13e6188f6..dbe66052f 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponse.java index da0e793f1..924db9436 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponseOrBuilder.java index 49517becb..062f6c84b 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemaRevisionsResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequest.java index 11cb59d07..557437614 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequestOrBuilder.java index 9c69b0a4b..d8728e999 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponse.java index 969592443..44683e3f5 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponseOrBuilder.java index ca5c661c1..bbdfbc82d 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSchemasResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java index d2b19ce97..79ec013a9 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -126,10 +126,10 @@ public com.google.protobuf.ByteString getProjectBytes() { * * * 
-   * Maximum number of snapshots to return.
+   * Optional. Maximum number of snapshots to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -146,12 +146,12 @@ public int getPageSize() { * * * 
-   * The value returned by the last `ListSnapshotsResponse`; indicates that this
-   * is a continuation of a prior `ListSnapshots` call, and that the system
-   * should return the next page of data.
+   * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+   * that this is a continuation of a prior `ListSnapshots` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -171,12 +171,12 @@ public java.lang.String getPageToken() { * * * 
-   * The value returned by the last `ListSnapshotsResponse`; indicates that this
-   * is a continuation of a prior `ListSnapshots` call, and that the system
-   * should return the next page of data.
+   * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+   * that this is a continuation of a prior `ListSnapshots` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -706,10 +706,10 @@ public Builder setProjectBytes(com.google.protobuf.ByteString value) { * * * 
-     * Maximum number of snapshots to return.
+     * Optional. Maximum number of snapshots to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -721,10 +721,10 @@ public int getPageSize() { * * * 
-     * Maximum number of snapshots to return.
+     * Optional. Maximum number of snapshots to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageSize to set. * @return This builder for chaining. @@ -740,10 +740,10 @@ public Builder setPageSize(int value) { * * * 
-     * Maximum number of snapshots to return.
+     * Optional. Maximum number of snapshots to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -759,12 +759,12 @@ public Builder clearPageSize() { * * * 
-     * The value returned by the last `ListSnapshotsResponse`; indicates that this
-     * is a continuation of a prior `ListSnapshots` call, and that the system
-     * should return the next page of data.
+     * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+     * that this is a continuation of a prior `ListSnapshots` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -783,12 +783,12 @@ public java.lang.String getPageToken() { * * * 
-     * The value returned by the last `ListSnapshotsResponse`; indicates that this
-     * is a continuation of a prior `ListSnapshots` call, and that the system
-     * should return the next page of data.
+     * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+     * that this is a continuation of a prior `ListSnapshots` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -807,12 +807,12 @@ public com.google.protobuf.ByteString getPageTokenBytes() { * * * 
-     * The value returned by the last `ListSnapshotsResponse`; indicates that this
-     * is a continuation of a prior `ListSnapshots` call, and that the system
-     * should return the next page of data.
+     * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+     * that this is a continuation of a prior `ListSnapshots` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageToken to set. * @return This builder for chaining. @@ -830,12 +830,12 @@ public Builder setPageToken(java.lang.String value) { * * * 
-     * The value returned by the last `ListSnapshotsResponse`; indicates that this
-     * is a continuation of a prior `ListSnapshots` call, and that the system
-     * should return the next page of data.
+     * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+     * that this is a continuation of a prior `ListSnapshots` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -849,12 +849,12 @@ public Builder clearPageToken() { * * * 
-     * The value returned by the last `ListSnapshotsResponse`; indicates that this
-     * is a continuation of a prior `ListSnapshots` call, and that the system
-     * should return the next page of data.
+     * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+     * that this is a continuation of a prior `ListSnapshots` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for pageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequestOrBuilder.java index 36487bebd..05f0505ad 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -58,10 +58,10 @@ public interface ListSnapshotsRequestOrBuilder * * * 
-   * Maximum number of snapshots to return.
+   * Optional. Maximum number of snapshots to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -71,12 +71,12 @@ public interface ListSnapshotsRequestOrBuilder * * * 
-   * The value returned by the last `ListSnapshotsResponse`; indicates that this
-   * is a continuation of a prior `ListSnapshots` call, and that the system
-   * should return the next page of data.
+   * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+   * that this is a continuation of a prior `ListSnapshots` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -85,12 +85,12 @@ public interface ListSnapshotsRequestOrBuilder * * * 
-   * The value returned by the last `ListSnapshotsResponse`; indicates that this
-   * is a continuation of a prior `ListSnapshots` call, and that the system
-   * should return the next page of data.
+   * Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+   * that this is a continuation of a prior `ListSnapshots` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java index cc42bfb6c..1c9846664 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -71,10 +71,12 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List getSnapshotsList() { @@ -84,10 +86,12 @@ public java.util.List getSnapshotsList() { * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List @@ -98,10 +102,12 @@ public java.util.List getSnapshotsList() { * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public int getSnapshotsCount() { @@ -111,10 +117,12 @@ public int getSnapshotsCount() { * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.Snapshot getSnapshots(int index) { @@ -124,10 +132,12 @@ public com.google.pubsub.v1.Snapshot getSnapshots(int index) { * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.SnapshotOrBuilder getSnapshotsOrBuilder(int index) { @@ -142,11 +152,12 @@ public com.google.pubsub.v1.SnapshotOrBuilder getSnapshotsOrBuilder(int index) { * * * 
-   * If not empty, indicates that there may be more snapshot that match the
-   * request; this value should be passed in a new `ListSnapshotsRequest`.
+   * Optional. If not empty, indicates that there may be more snapshot that
+   * match the request; this value should be passed in a new
+   * `ListSnapshotsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -166,11 +177,12 @@ public java.lang.String getNextPageToken() { * * * 
-   * If not empty, indicates that there may be more snapshot that match the
-   * request; this value should be passed in a new `ListSnapshotsRequest`.
+   * Optional. If not empty, indicates that there may be more snapshot that
+   * match the request; this value should be passed in a new
+   * `ListSnapshotsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -618,10 +630,12 @@ private void ensureSnapshotsIsMutable() { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getSnapshotsList() { if (snapshotsBuilder_ == null) { @@ -634,10 +648,12 @@ public java.util.List getSnapshotsList() { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public int getSnapshotsCount() { if (snapshotsBuilder_ == null) { @@ -650,10 +666,12 @@ public int getSnapshotsCount() { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Snapshot getSnapshots(int index) { if (snapshotsBuilder_ == null) { @@ -666,10 +684,12 @@ public com.google.pubsub.v1.Snapshot getSnapshots(int index) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setSnapshots(int index, com.google.pubsub.v1.Snapshot value) { if (snapshotsBuilder_ == null) { @@ -688,10 +708,12 @@ public Builder setSnapshots(int index, com.google.pubsub.v1.Snapshot value) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setSnapshots(int index, com.google.pubsub.v1.Snapshot.Builder builderForValue) { if (snapshotsBuilder_ == null) { @@ -707,10 +729,12 @@ public Builder setSnapshots(int index, com.google.pubsub.v1.Snapshot.Builder bui * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSnapshots(com.google.pubsub.v1.Snapshot value) { if (snapshotsBuilder_ == null) { @@ -729,10 +753,12 @@ public Builder addSnapshots(com.google.pubsub.v1.Snapshot value) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSnapshots(int index, com.google.pubsub.v1.Snapshot value) { if (snapshotsBuilder_ == null) { @@ -751,10 +777,12 @@ public Builder addSnapshots(int index, com.google.pubsub.v1.Snapshot value) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSnapshots(com.google.pubsub.v1.Snapshot.Builder builderForValue) { if (snapshotsBuilder_ == null) { @@ -770,10 +798,12 @@ public Builder addSnapshots(com.google.pubsub.v1.Snapshot.Builder builderForValu * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSnapshots(int index, com.google.pubsub.v1.Snapshot.Builder builderForValue) { if (snapshotsBuilder_ == null) { @@ -789,10 +819,12 @@ public Builder addSnapshots(int index, com.google.pubsub.v1.Snapshot.Builder bui * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addAllSnapshots( java.lang.Iterable values) { @@ -809,10 +841,12 @@ public Builder addAllSnapshots( * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearSnapshots() { if (snapshotsBuilder_ == null) { @@ -828,10 +862,12 @@ public Builder clearSnapshots() { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder removeSnapshots(int index) { if (snapshotsBuilder_ == null) { @@ -847,10 +883,12 @@ public Builder removeSnapshots(int index) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Snapshot.Builder getSnapshotsBuilder(int index) { return getSnapshotsFieldBuilder().getBuilder(index); @@ -859,10 +897,12 @@ public com.google.pubsub.v1.Snapshot.Builder getSnapshotsBuilder(int index) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.SnapshotOrBuilder getSnapshotsOrBuilder(int index) { if (snapshotsBuilder_ == null) { @@ -875,10 +915,12 @@ public com.google.pubsub.v1.SnapshotOrBuilder getSnapshotsOrBuilder(int index) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getSnapshotsOrBuilderList() { @@ -892,10 +934,12 @@ public com.google.pubsub.v1.SnapshotOrBuilder getSnapshotsOrBuilder(int index) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Snapshot.Builder addSnapshotsBuilder() { return getSnapshotsFieldBuilder() @@ -905,10 +949,12 @@ public com.google.pubsub.v1.Snapshot.Builder addSnapshotsBuilder() { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Snapshot.Builder addSnapshotsBuilder(int index) { return getSnapshotsFieldBuilder() @@ -918,10 +964,12 @@ public com.google.pubsub.v1.Snapshot.Builder addSnapshotsBuilder(int index) { * * * 
-     * The resulting snapshots.
+     * Optional. The resulting snapshots.
      *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getSnapshotsBuilderList() { return getSnapshotsFieldBuilder().getBuilderList(); @@ -949,11 +997,12 @@ public java.util.List getSnapshotsBuilder * * * 
-     * If not empty, indicates that there may be more snapshot that match the
-     * request; this value should be passed in a new `ListSnapshotsRequest`.
+     * Optional. If not empty, indicates that there may be more snapshot that
+     * match the request; this value should be passed in a new
+     * `ListSnapshotsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -972,11 +1021,12 @@ public java.lang.String getNextPageToken() { * * * 
-     * If not empty, indicates that there may be more snapshot that match the
-     * request; this value should be passed in a new `ListSnapshotsRequest`.
+     * Optional. If not empty, indicates that there may be more snapshot that
+     * match the request; this value should be passed in a new
+     * `ListSnapshotsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -995,11 +1045,12 @@ public com.google.protobuf.ByteString getNextPageTokenBytes() { * * * 
-     * If not empty, indicates that there may be more snapshot that match the
-     * request; this value should be passed in a new `ListSnapshotsRequest`.
+     * Optional. If not empty, indicates that there may be more snapshot that
+     * match the request; this value should be passed in a new
+     * `ListSnapshotsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The nextPageToken to set. * @return This builder for chaining. @@ -1017,11 +1068,12 @@ public Builder setNextPageToken(java.lang.String value) { * * * 
-     * If not empty, indicates that there may be more snapshot that match the
-     * request; this value should be passed in a new `ListSnapshotsRequest`.
+     * Optional. If not empty, indicates that there may be more snapshot that
+     * match the request; this value should be passed in a new
+     * `ListSnapshotsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -1035,11 +1087,12 @@ public Builder clearNextPageToken() { * * * 
-     * If not empty, indicates that there may be more snapshot that match the
-     * request; this value should be passed in a new `ListSnapshotsRequest`.
+     * Optional. If not empty, indicates that there may be more snapshot that
+     * match the request; this value should be passed in a new
+     * `ListSnapshotsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for nextPageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponseOrBuilder.java index 4559682d5..0c3fc0c72 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSnapshotsResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,50 +27,60 @@ public interface ListSnapshotsResponseOrBuilder * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getSnapshotsList(); /** * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.Snapshot getSnapshots(int index); /** * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ int getSnapshotsCount(); /** * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getSnapshotsOrBuilderList(); /** * * * 
-   * The resulting snapshots.
+   * Optional. The resulting snapshots.
    *
* - * repeated .google.pubsub.v1.Snapshot snapshots = 1; + * + * repeated .google.pubsub.v1.Snapshot snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.SnapshotOrBuilder getSnapshotsOrBuilder(int index); @@ -78,11 +88,12 @@ public interface ListSnapshotsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more snapshot that match the
-   * request; this value should be passed in a new `ListSnapshotsRequest`.
+   * Optional. If not empty, indicates that there may be more snapshot that
+   * match the request; this value should be passed in a new
+   * `ListSnapshotsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -91,11 +102,12 @@ public interface ListSnapshotsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more snapshot that match the
-   * request; this value should be passed in a new `ListSnapshotsRequest`.
+   * Optional. If not empty, indicates that there may be more snapshot that
+   * match the request; this value should be passed in a new
+   * `ListSnapshotsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequest.java index 63bbc9cd4..9097f6578 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -126,10 +126,10 @@ public com.google.protobuf.ByteString getProjectBytes() { * * * 
-   * Maximum number of subscriptions to return.
+   * Optional. Maximum number of subscriptions to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -146,12 +146,12 @@ public int getPageSize() { * * * 
-   * The value returned by the last `ListSubscriptionsResponse`; indicates that
-   * this is a continuation of a prior `ListSubscriptions` call, and that the
-   * system should return the next page of data.
+   * Optional. The value returned by the last `ListSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListSubscriptions` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -171,12 +171,12 @@ public java.lang.String getPageToken() { * * * 
-   * The value returned by the last `ListSubscriptionsResponse`; indicates that
-   * this is a continuation of a prior `ListSubscriptions` call, and that the
-   * system should return the next page of data.
+   * Optional. The value returned by the last `ListSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListSubscriptions` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -706,10 +706,10 @@ public Builder setProjectBytes(com.google.protobuf.ByteString value) { * * * 
-     * Maximum number of subscriptions to return.
+     * Optional. Maximum number of subscriptions to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -721,10 +721,10 @@ public int getPageSize() { * * * 
-     * Maximum number of subscriptions to return.
+     * Optional. Maximum number of subscriptions to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageSize to set. * @return This builder for chaining. @@ -740,10 +740,10 @@ public Builder setPageSize(int value) { * * * 
-     * Maximum number of subscriptions to return.
+     * Optional. Maximum number of subscriptions to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -759,12 +759,12 @@ public Builder clearPageSize() { * * * 
-     * The value returned by the last `ListSubscriptionsResponse`; indicates that
-     * this is a continuation of a prior `ListSubscriptions` call, and that the
-     * system should return the next page of data.
+     * Optional. The value returned by the last `ListSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListSubscriptions` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -783,12 +783,12 @@ public java.lang.String getPageToken() { * * * 
-     * The value returned by the last `ListSubscriptionsResponse`; indicates that
-     * this is a continuation of a prior `ListSubscriptions` call, and that the
-     * system should return the next page of data.
+     * Optional. The value returned by the last `ListSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListSubscriptions` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -807,12 +807,12 @@ public com.google.protobuf.ByteString getPageTokenBytes() { * * * 
-     * The value returned by the last `ListSubscriptionsResponse`; indicates that
-     * this is a continuation of a prior `ListSubscriptions` call, and that the
-     * system should return the next page of data.
+     * Optional. The value returned by the last `ListSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListSubscriptions` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageToken to set. * @return This builder for chaining. @@ -830,12 +830,12 @@ public Builder setPageToken(java.lang.String value) { * * * 
-     * The value returned by the last `ListSubscriptionsResponse`; indicates that
-     * this is a continuation of a prior `ListSubscriptions` call, and that the
-     * system should return the next page of data.
+     * Optional. The value returned by the last `ListSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListSubscriptions` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -849,12 +849,12 @@ public Builder clearPageToken() { * * * 
-     * The value returned by the last `ListSubscriptionsResponse`; indicates that
-     * this is a continuation of a prior `ListSubscriptions` call, and that the
-     * system should return the next page of data.
+     * Optional. The value returned by the last `ListSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListSubscriptions` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for pageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequestOrBuilder.java index db2839f67..d557e4be4 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -58,10 +58,10 @@ public interface ListSubscriptionsRequestOrBuilder * * * 
-   * Maximum number of subscriptions to return.
+   * Optional. Maximum number of subscriptions to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -71,12 +71,12 @@ public interface ListSubscriptionsRequestOrBuilder * * * 
-   * The value returned by the last `ListSubscriptionsResponse`; indicates that
-   * this is a continuation of a prior `ListSubscriptions` call, and that the
-   * system should return the next page of data.
+   * Optional. The value returned by the last `ListSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListSubscriptions` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -85,12 +85,12 @@ public interface ListSubscriptionsRequestOrBuilder * * * 
-   * The value returned by the last `ListSubscriptionsResponse`; indicates that
-   * this is a continuation of a prior `ListSubscriptions` call, and that the
-   * system should return the next page of data.
+   * Optional. The value returned by the last `ListSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListSubscriptions` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponse.java index 629620e65..98d425317 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -71,10 +71,12 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List getSubscriptionsList() { @@ -84,10 +86,12 @@ public java.util.List getSubscriptionsList() * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List @@ -98,10 +102,12 @@ public java.util.List getSubscriptionsList() * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public int getSubscriptionsCount() { @@ -111,10 +117,12 @@ public int getSubscriptionsCount() { * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.Subscription getSubscriptions(int index) { @@ -124,10 +132,12 @@ public com.google.pubsub.v1.Subscription getSubscriptions(int index) { * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.SubscriptionOrBuilder getSubscriptionsOrBuilder(int index) { @@ -142,12 +152,12 @@ public com.google.pubsub.v1.SubscriptionOrBuilder getSubscriptionsOrBuilder(int * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -167,12 +177,12 @@ public java.lang.String getNextPageToken() { * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -621,10 +631,12 @@ private void ensureSubscriptionsIsMutable() { * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getSubscriptionsList() { if (subscriptionsBuilder_ == null) { @@ -637,10 +649,12 @@ public java.util.List getSubscriptionsList() * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public int getSubscriptionsCount() { if (subscriptionsBuilder_ == null) { @@ -653,10 +667,12 @@ public int getSubscriptionsCount() { * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Subscription getSubscriptions(int index) { if (subscriptionsBuilder_ == null) { @@ -669,10 +685,12 @@ public com.google.pubsub.v1.Subscription getSubscriptions(int index) { * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setSubscriptions(int index, com.google.pubsub.v1.Subscription value) { if (subscriptionsBuilder_ == null) { @@ -691,10 +709,12 @@ public Builder setSubscriptions(int index, com.google.pubsub.v1.Subscription val * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setSubscriptions( int index, com.google.pubsub.v1.Subscription.Builder builderForValue) { @@ -711,10 +731,12 @@ public Builder setSubscriptions( * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSubscriptions(com.google.pubsub.v1.Subscription value) { if (subscriptionsBuilder_ == null) { @@ -733,10 +755,12 @@ public Builder addSubscriptions(com.google.pubsub.v1.Subscription value) { * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSubscriptions(int index, com.google.pubsub.v1.Subscription value) { if (subscriptionsBuilder_ == null) { @@ -755,10 +779,12 @@ public Builder addSubscriptions(int index, com.google.pubsub.v1.Subscription val * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSubscriptions(com.google.pubsub.v1.Subscription.Builder builderForValue) { if (subscriptionsBuilder_ == null) { @@ -774,10 +800,12 @@ public Builder addSubscriptions(com.google.pubsub.v1.Subscription.Builder builde * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addSubscriptions( int index, com.google.pubsub.v1.Subscription.Builder builderForValue) { @@ -794,10 +822,12 @@ public Builder addSubscriptions( * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addAllSubscriptions( java.lang.Iterable values) { @@ -814,10 +844,12 @@ public Builder addAllSubscriptions( * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearSubscriptions() { if (subscriptionsBuilder_ == null) { @@ -833,10 +865,12 @@ public Builder clearSubscriptions() { * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder removeSubscriptions(int index) { if (subscriptionsBuilder_ == null) { @@ -852,10 +886,12 @@ public Builder removeSubscriptions(int index) { * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Subscription.Builder getSubscriptionsBuilder(int index) { return getSubscriptionsFieldBuilder().getBuilder(index); @@ -864,10 +900,12 @@ public com.google.pubsub.v1.Subscription.Builder getSubscriptionsBuilder(int ind * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.SubscriptionOrBuilder getSubscriptionsOrBuilder(int index) { if (subscriptionsBuilder_ == null) { @@ -880,10 +918,12 @@ public com.google.pubsub.v1.SubscriptionOrBuilder getSubscriptionsOrBuilder(int * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getSubscriptionsOrBuilderList() { @@ -897,10 +937,12 @@ public com.google.pubsub.v1.SubscriptionOrBuilder getSubscriptionsOrBuilder(int * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Subscription.Builder addSubscriptionsBuilder() { return getSubscriptionsFieldBuilder() @@ -910,10 +952,12 @@ public com.google.pubsub.v1.Subscription.Builder addSubscriptionsBuilder() { * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Subscription.Builder addSubscriptionsBuilder(int index) { return getSubscriptionsFieldBuilder() @@ -923,10 +967,12 @@ public com.google.pubsub.v1.Subscription.Builder addSubscriptionsBuilder(int ind * * * 
-     * The subscriptions that match the request.
+     * Optional. The subscriptions that match the request.
      *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getSubscriptionsBuilderList() { return getSubscriptionsFieldBuilder().getBuilderList(); @@ -957,12 +1003,12 @@ public java.util.List getSubscription * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -981,12 +1027,12 @@ public java.lang.String getNextPageToken() { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -1005,12 +1051,12 @@ public com.google.protobuf.ByteString getNextPageTokenBytes() { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The nextPageToken to set. * @return This builder for chaining. @@ -1028,12 +1074,12 @@ public Builder setNextPageToken(java.lang.String value) { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -1047,12 +1093,12 @@ public Builder clearNextPageToken() { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for nextPageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponseOrBuilder.java index 439c431a5..74d60d6a7 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListSubscriptionsResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,40 +27,48 @@ public interface ListSubscriptionsResponseOrBuilder * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getSubscriptionsList(); /** * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.Subscription getSubscriptions(int index); /** * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ int getSubscriptionsCount(); /** * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getSubscriptionsOrBuilderList(); @@ -68,10 +76,12 @@ public interface ListSubscriptionsResponseOrBuilder * * * 
-   * The subscriptions that match the request.
+   * Optional. The subscriptions that match the request.
    *
* - * repeated .google.pubsub.v1.Subscription subscriptions = 1; + * + * repeated .google.pubsub.v1.Subscription subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.SubscriptionOrBuilder getSubscriptionsOrBuilder(int index); @@ -79,12 +89,12 @@ public interface ListSubscriptionsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -93,12 +103,12 @@ public interface ListSubscriptionsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java index 103e28b75..b3418a718 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -126,10 +126,10 @@ public com.google.protobuf.ByteString getTopicBytes() { * * * 
-   * Maximum number of snapshot names to return.
+   * Optional. Maximum number of snapshot names to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -146,12 +146,12 @@ public int getPageSize() { * * * 
-   * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSnapshots` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -171,12 +171,12 @@ public java.lang.String getPageToken() { * * * 
-   * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSnapshots` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -706,10 +706,10 @@ public Builder setTopicBytes(com.google.protobuf.ByteString value) { * * * 
-     * Maximum number of snapshot names to return.
+     * Optional. Maximum number of snapshot names to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -721,10 +721,10 @@ public int getPageSize() { * * * 
-     * Maximum number of snapshot names to return.
+     * Optional. Maximum number of snapshot names to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageSize to set. * @return This builder for chaining. @@ -740,10 +740,10 @@ public Builder setPageSize(int value) { * * * 
-     * Maximum number of snapshot names to return.
+     * Optional. Maximum number of snapshot names to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -759,12 +759,12 @@ public Builder clearPageSize() { * * * 
-     * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSnapshots` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -783,12 +783,12 @@ public java.lang.String getPageToken() { * * * 
-     * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSnapshots` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -807,12 +807,12 @@ public com.google.protobuf.ByteString getPageTokenBytes() { * * * 
-     * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSnapshots` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageToken to set. * @return This builder for chaining. @@ -830,12 +830,12 @@ public Builder setPageToken(java.lang.String value) { * * * 
-     * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSnapshots` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -849,12 +849,12 @@ public Builder clearPageToken() { * * * 
-     * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSnapshots` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+     * and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for pageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequestOrBuilder.java index d965d0d29..505e00fe2 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -58,10 +58,10 @@ public interface ListTopicSnapshotsRequestOrBuilder * * * 
-   * Maximum number of snapshot names to return.
+   * Optional. Maximum number of snapshot names to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -71,12 +71,12 @@ public interface ListTopicSnapshotsRequestOrBuilder * * * 
-   * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSnapshots` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -85,12 +85,12 @@ public interface ListTopicSnapshotsRequestOrBuilder * * * 
-   * The value returned by the last `ListTopicSnapshotsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSnapshots` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+   * and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java index 9d0eb36e1..2b6561aa6 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -72,10 +72,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return A list containing the snapshots. */ @@ -86,10 +86,10 @@ public com.google.protobuf.ProtocolStringList getSnapshotsList() { * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The count of snapshots. */ @@ -100,10 +100,10 @@ public int getSnapshotsCount() { * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the element to return. * @return The snapshots at the given index. @@ -115,10 +115,10 @@ public java.lang.String getSnapshots(int index) { * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the value to return. * @return The bytes of the snapshots at the given index. @@ -135,12 +135,12 @@ public com.google.protobuf.ByteString getSnapshotsBytes(int index) { * * * 
-   * If not empty, indicates that there may be more snapshots that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more snapshots that
+   * match the request; this value should be passed in a new
    * `ListTopicSnapshotsRequest` to get more snapshots.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -160,12 +160,12 @@ public java.lang.String getNextPageToken() { * * * 
-   * If not empty, indicates that there may be more snapshots that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more snapshots that
+   * match the request; this value should be passed in a new
    * `ListTopicSnapshotsRequest` to get more snapshots.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -575,10 +575,10 @@ private void ensureSnapshotsIsMutable() { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return A list containing the snapshots. */ @@ -590,10 +590,10 @@ public com.google.protobuf.ProtocolStringList getSnapshotsList() { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The count of snapshots. */ @@ -604,10 +604,10 @@ public int getSnapshotsCount() { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the element to return. * @return The snapshots at the given index. @@ -619,10 +619,10 @@ public java.lang.String getSnapshots(int index) { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the value to return. * @return The bytes of the snapshots at the given index. @@ -634,10 +634,10 @@ public com.google.protobuf.ByteString getSnapshotsBytes(int index) { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index to set the value at. * @param value The snapshots to set. @@ -657,10 +657,10 @@ public Builder setSnapshots(int index, java.lang.String value) { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The snapshots to add. * @return This builder for chaining. @@ -679,10 +679,10 @@ public Builder addSnapshots(java.lang.String value) { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param values The snapshots to add. * @return This builder for chaining. @@ -698,10 +698,10 @@ public Builder addAllSnapshots(java.lang.Iterable values) { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -716,10 +716,10 @@ public Builder clearSnapshots() { * * * 
-     * The names of the snapshots that match the request.
+     * Optional. The names of the snapshots that match the request.
      *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes of the snapshots to add. * @return This builder for chaining. @@ -741,12 +741,12 @@ public Builder addSnapshotsBytes(com.google.protobuf.ByteString value) { * * * 
-     * If not empty, indicates that there may be more snapshots that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more snapshots that
+     * match the request; this value should be passed in a new
      * `ListTopicSnapshotsRequest` to get more snapshots.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -765,12 +765,12 @@ public java.lang.String getNextPageToken() { * * * 
-     * If not empty, indicates that there may be more snapshots that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more snapshots that
+     * match the request; this value should be passed in a new
      * `ListTopicSnapshotsRequest` to get more snapshots.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -789,12 +789,12 @@ public com.google.protobuf.ByteString getNextPageTokenBytes() { * * * 
-     * If not empty, indicates that there may be more snapshots that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more snapshots that
+     * match the request; this value should be passed in a new
      * `ListTopicSnapshotsRequest` to get more snapshots.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The nextPageToken to set. * @return This builder for chaining. @@ -812,12 +812,12 @@ public Builder setNextPageToken(java.lang.String value) { * * * 
-     * If not empty, indicates that there may be more snapshots that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more snapshots that
+     * match the request; this value should be passed in a new
      * `ListTopicSnapshotsRequest` to get more snapshots.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -831,12 +831,12 @@ public Builder clearNextPageToken() { * * * 
-     * If not empty, indicates that there may be more snapshots that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more snapshots that
+     * match the request; this value should be passed in a new
      * `ListTopicSnapshotsRequest` to get more snapshots.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for nextPageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponseOrBuilder.java index b24d10865..abbe62fa5 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSnapshotsResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,10 +27,10 @@ public interface ListTopicSnapshotsResponseOrBuilder * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return A list containing the snapshots. */ @@ -39,10 +39,10 @@ public interface ListTopicSnapshotsResponseOrBuilder * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The count of snapshots. */ @@ -51,10 +51,10 @@ public interface ListTopicSnapshotsResponseOrBuilder * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the element to return. * @return The snapshots at the given index. @@ -64,10 +64,10 @@ public interface ListTopicSnapshotsResponseOrBuilder * * * 
-   * The names of the snapshots that match the request.
+   * Optional. The names of the snapshots that match the request.
    *
* - * repeated string snapshots = 1; + * repeated string snapshots = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the value to return. * @return The bytes of the snapshots at the given index. @@ -78,12 +78,12 @@ public interface ListTopicSnapshotsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more snapshots that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more snapshots that
+   * match the request; this value should be passed in a new
    * `ListTopicSnapshotsRequest` to get more snapshots.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -92,12 +92,12 @@ public interface ListTopicSnapshotsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more snapshots that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more snapshots that
+   * match the request; this value should be passed in a new
    * `ListTopicSnapshotsRequest` to get more snapshots.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequest.java index 737bd00b7..01ba987d2 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -126,10 +126,10 @@ public com.google.protobuf.ByteString getTopicBytes() { * * * 
-   * Maximum number of subscription names to return.
+   * Optional. Maximum number of subscription names to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -146,12 +146,12 @@ public int getPageSize() { * * * 
-   * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+   * call, and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -171,12 +171,12 @@ public java.lang.String getPageToken() { * * * 
-   * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+   * call, and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -707,10 +707,10 @@ public Builder setTopicBytes(com.google.protobuf.ByteString value) { * * * 
-     * Maximum number of subscription names to return.
+     * Optional. Maximum number of subscription names to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -722,10 +722,10 @@ public int getPageSize() { * * * 
-     * Maximum number of subscription names to return.
+     * Optional. Maximum number of subscription names to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageSize to set. * @return This builder for chaining. @@ -741,10 +741,10 @@ public Builder setPageSize(int value) { * * * 
-     * Maximum number of subscription names to return.
+     * Optional. Maximum number of subscription names to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -760,12 +760,12 @@ public Builder clearPageSize() { * * * 
-     * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+     * call, and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -784,12 +784,12 @@ public java.lang.String getPageToken() { * * * 
-     * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+     * call, and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -808,12 +808,12 @@ public com.google.protobuf.ByteString getPageTokenBytes() { * * * 
-     * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+     * call, and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageToken to set. * @return This builder for chaining. @@ -831,12 +831,12 @@ public Builder setPageToken(java.lang.String value) { * * * 
-     * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+     * call, and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -850,12 +850,12 @@ public Builder clearPageToken() { * * * 
-     * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-     * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-     * that the system should return the next page of data.
+     * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+     * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+     * call, and that the system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for pageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequestOrBuilder.java index d6bc07531..bf8a6cd5a 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -58,10 +58,10 @@ public interface ListTopicSubscriptionsRequestOrBuilder * * * 
-   * Maximum number of subscription names to return.
+   * Optional. Maximum number of subscription names to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -71,12 +71,12 @@ public interface ListTopicSubscriptionsRequestOrBuilder * * * 
-   * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+   * call, and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -85,12 +85,12 @@ public interface ListTopicSubscriptionsRequestOrBuilder * * * 
-   * The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-   * that this is a continuation of a prior `ListTopicSubscriptions` call, and
-   * that the system should return the next page of data.
+   * Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+   * indicates that this is a continuation of a prior `ListTopicSubscriptions`
+   * call, and that the system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponse.java index f270eed8d..e139fec30 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -73,10 +73,13 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @return A list containing the subscriptions. */ @@ -87,10 +90,13 @@ public com.google.protobuf.ProtocolStringList getSubscriptionsList() { * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @return The count of subscriptions. */ @@ -101,10 +107,13 @@ public int getSubscriptionsCount() { * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param index The index of the element to return. * @return The subscriptions at the given index. @@ -116,10 +125,13 @@ public java.lang.String getSubscriptions(int index) { * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param index The index of the value to return. * @return The bytes of the subscriptions at the given index. @@ -136,12 +148,12 @@ public com.google.protobuf.ByteString getSubscriptionsBytes(int index) { * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListTopicSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -161,12 +173,12 @@ public java.lang.String getNextPageToken() { * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListTopicSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -576,10 +588,13 @@ private void ensureSubscriptionsIsMutable() { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @return A list containing the subscriptions. */ @@ -591,10 +606,13 @@ public com.google.protobuf.ProtocolStringList getSubscriptionsList() { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @return The count of subscriptions. */ @@ -605,10 +623,13 @@ public int getSubscriptionsCount() { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param index The index of the element to return. * @return The subscriptions at the given index. @@ -620,10 +641,13 @@ public java.lang.String getSubscriptions(int index) { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param index The index of the value to return. * @return The bytes of the subscriptions at the given index. @@ -635,10 +659,13 @@ public com.google.protobuf.ByteString getSubscriptionsBytes(int index) { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param index The index to set the value at. * @param value The subscriptions to set. @@ -658,10 +685,13 @@ public Builder setSubscriptions(int index, java.lang.String value) { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param value The subscriptions to add. * @return This builder for chaining. @@ -680,10 +710,13 @@ public Builder addSubscriptions(java.lang.String value) { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param values The subscriptions to add. * @return This builder for chaining. @@ -699,10 +732,13 @@ public Builder addAllSubscriptions(java.lang.Iterable values) * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @return This builder for chaining. */ @@ -717,10 +753,13 @@ public Builder clearSubscriptions() { * * * 
-     * The names of subscriptions attached to the topic specified in the request.
+     * Optional. The names of subscriptions attached to the topic specified in the
+     * request.
      *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param value The bytes of the subscriptions to add. * @return This builder for chaining. @@ -742,12 +781,12 @@ public Builder addSubscriptionsBytes(com.google.protobuf.ByteString value) { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListTopicSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -766,12 +805,12 @@ public java.lang.String getNextPageToken() { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListTopicSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -790,12 +829,12 @@ public com.google.protobuf.ByteString getNextPageTokenBytes() { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListTopicSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The nextPageToken to set. * @return This builder for chaining. @@ -813,12 +852,12 @@ public Builder setNextPageToken(java.lang.String value) { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListTopicSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -832,12 +871,12 @@ public Builder clearNextPageToken() { * * * 
-     * If not empty, indicates that there may be more subscriptions that match
-     * the request; this value should be passed in a new
+     * Optional. If not empty, indicates that there may be more subscriptions that
+     * match the request; this value should be passed in a new
      * `ListTopicSubscriptionsRequest` to get more subscriptions.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for nextPageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponseOrBuilder.java index d8c6f021e..942228db7 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicSubscriptionsResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,10 +27,13 @@ public interface ListTopicSubscriptionsResponseOrBuilder * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @return A list containing the subscriptions. */ @@ -39,10 +42,13 @@ public interface ListTopicSubscriptionsResponseOrBuilder * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @return The count of subscriptions. */ @@ -51,10 +57,13 @@ public interface ListTopicSubscriptionsResponseOrBuilder * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param index The index of the element to return. * @return The subscriptions at the given index. @@ -64,10 +73,13 @@ public interface ListTopicSubscriptionsResponseOrBuilder * * * 
-   * The names of subscriptions attached to the topic specified in the request.
+   * Optional. The names of subscriptions attached to the topic specified in the
+   * request.
    *
* - * repeated string subscriptions = 1 [(.google.api.resource_reference) = { ... } + * + * repeated string subscriptions = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... } + * * * @param index The index of the value to return. * @return The bytes of the subscriptions at the given index. @@ -78,12 +90,12 @@ public interface ListTopicSubscriptionsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListTopicSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -92,12 +104,12 @@ public interface ListTopicSubscriptionsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more subscriptions that match
-   * the request; this value should be passed in a new
+   * Optional. If not empty, indicates that there may be more subscriptions that
+   * match the request; this value should be passed in a new
    * `ListTopicSubscriptionsRequest` to get more subscriptions.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequest.java index 5c2e9d64b..0bb992da2 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -126,10 +126,10 @@ public com.google.protobuf.ByteString getProjectBytes() { * * * 
-   * Maximum number of topics to return.
+   * Optional. Maximum number of topics to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -146,12 +146,12 @@ public int getPageSize() { * * * 
-   * The value returned by the last `ListTopicsResponse`; indicates that this is
-   * a continuation of a prior `ListTopics` call, and that the system should
-   * return the next page of data.
+   * Optional. The value returned by the last `ListTopicsResponse`; indicates
+   * that this is a continuation of a prior `ListTopics` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -171,12 +171,12 @@ public java.lang.String getPageToken() { * * * 
-   * The value returned by the last `ListTopicsResponse`; indicates that this is
-   * a continuation of a prior `ListTopics` call, and that the system should
-   * return the next page of data.
+   * Optional. The value returned by the last `ListTopicsResponse`; indicates
+   * that this is a continuation of a prior `ListTopics` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -705,10 +705,10 @@ public Builder setProjectBytes(com.google.protobuf.ByteString value) { * * * 
-     * Maximum number of topics to return.
+     * Optional. Maximum number of topics to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -720,10 +720,10 @@ public int getPageSize() { * * * 
-     * Maximum number of topics to return.
+     * Optional. Maximum number of topics to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageSize to set. * @return This builder for chaining. @@ -739,10 +739,10 @@ public Builder setPageSize(int value) { * * * 
-     * Maximum number of topics to return.
+     * Optional. Maximum number of topics to return.
      *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -758,12 +758,12 @@ public Builder clearPageSize() { * * * 
-     * The value returned by the last `ListTopicsResponse`; indicates that this is
-     * a continuation of a prior `ListTopics` call, and that the system should
-     * return the next page of data.
+     * Optional. The value returned by the last `ListTopicsResponse`; indicates
+     * that this is a continuation of a prior `ListTopics` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -782,12 +782,12 @@ public java.lang.String getPageToken() { * * * 
-     * The value returned by the last `ListTopicsResponse`; indicates that this is
-     * a continuation of a prior `ListTopics` call, and that the system should
-     * return the next page of data.
+     * Optional. The value returned by the last `ListTopicsResponse`; indicates
+     * that this is a continuation of a prior `ListTopics` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ @@ -806,12 +806,12 @@ public com.google.protobuf.ByteString getPageTokenBytes() { * * * 
-     * The value returned by the last `ListTopicsResponse`; indicates that this is
-     * a continuation of a prior `ListTopics` call, and that the system should
-     * return the next page of data.
+     * Optional. The value returned by the last `ListTopicsResponse`; indicates
+     * that this is a continuation of a prior `ListTopics` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pageToken to set. * @return This builder for chaining. @@ -829,12 +829,12 @@ public Builder setPageToken(java.lang.String value) { * * * 
-     * The value returned by the last `ListTopicsResponse`; indicates that this is
-     * a continuation of a prior `ListTopics` call, and that the system should
-     * return the next page of data.
+     * Optional. The value returned by the last `ListTopicsResponse`; indicates
+     * that this is a continuation of a prior `ListTopics` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -848,12 +848,12 @@ public Builder clearPageToken() { * * * 
-     * The value returned by the last `ListTopicsResponse`; indicates that this is
-     * a continuation of a prior `ListTopics` call, and that the system should
-     * return the next page of data.
+     * Optional. The value returned by the last `ListTopicsResponse`; indicates
+     * that this is a continuation of a prior `ListTopics` call, and that the
+     * system should return the next page of data.
      *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for pageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequestOrBuilder.java index 3e0d2ffb0..8abf06b96 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -58,10 +58,10 @@ public interface ListTopicsRequestOrBuilder * * * 
-   * Maximum number of topics to return.
+   * Optional. Maximum number of topics to return.
    *
* - * int32 page_size = 2; + * int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageSize. */ @@ -71,12 +71,12 @@ public interface ListTopicsRequestOrBuilder * * * 
-   * The value returned by the last `ListTopicsResponse`; indicates that this is
-   * a continuation of a prior `ListTopics` call, and that the system should
-   * return the next page of data.
+   * Optional. The value returned by the last `ListTopicsResponse`; indicates
+   * that this is a continuation of a prior `ListTopics` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pageToken. */ @@ -85,12 +85,12 @@ public interface ListTopicsRequestOrBuilder * * * 
-   * The value returned by the last `ListTopicsResponse`; indicates that this is
-   * a continuation of a prior `ListTopics` call, and that the system should
-   * return the next page of data.
+   * Optional. The value returned by the last `ListTopicsResponse`; indicates
+   * that this is a continuation of a prior `ListTopics` call, and that the
+   * system should return the next page of data.
    *
* - * string page_token = 3; + * string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponse.java index b3f73a27d..d4541e1a5 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -71,10 +71,11 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List getTopicsList() { @@ -84,10 +85,11 @@ public java.util.List getTopicsList() { * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List getTopicsOrBuilderList() { @@ -97,10 +99,11 @@ public java.util.List getTopicsOr * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public int getTopicsCount() { @@ -110,10 +113,11 @@ public int getTopicsCount() { * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.Topic getTopics(int index) { @@ -123,10 +127,11 @@ public com.google.pubsub.v1.Topic getTopics(int index) { * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.TopicOrBuilder getTopicsOrBuilder(int index) { @@ -141,11 +146,11 @@ public com.google.pubsub.v1.TopicOrBuilder getTopicsOrBuilder(int index) { * * * 
-   * If not empty, indicates that there may be more topics that match the
-   * request; this value should be passed in a new `ListTopicsRequest`.
+   * Optional. If not empty, indicates that there may be more topics that match
+   * the request; this value should be passed in a new `ListTopicsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -165,11 +170,11 @@ public java.lang.String getNextPageToken() { * * * 
-   * If not empty, indicates that there may be more topics that match the
-   * request; this value should be passed in a new `ListTopicsRequest`.
+   * Optional. If not empty, indicates that there may be more topics that match
+   * the request; this value should be passed in a new `ListTopicsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -615,10 +620,11 @@ private void ensureTopicsIsMutable() { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getTopicsList() { if (topicsBuilder_ == null) { @@ -631,10 +637,11 @@ public java.util.List getTopicsList() { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public int getTopicsCount() { if (topicsBuilder_ == null) { @@ -647,10 +654,11 @@ public int getTopicsCount() { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Topic getTopics(int index) { if (topicsBuilder_ == null) { @@ -663,10 +671,11 @@ public com.google.pubsub.v1.Topic getTopics(int index) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setTopics(int index, com.google.pubsub.v1.Topic value) { if (topicsBuilder_ == null) { @@ -685,10 +694,11 @@ public Builder setTopics(int index, com.google.pubsub.v1.Topic value) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setTopics(int index, com.google.pubsub.v1.Topic.Builder builderForValue) { if (topicsBuilder_ == null) { @@ -704,10 +714,11 @@ public Builder setTopics(int index, com.google.pubsub.v1.Topic.Builder builderFo * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addTopics(com.google.pubsub.v1.Topic value) { if (topicsBuilder_ == null) { @@ -726,10 +737,11 @@ public Builder addTopics(com.google.pubsub.v1.Topic value) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addTopics(int index, com.google.pubsub.v1.Topic value) { if (topicsBuilder_ == null) { @@ -748,10 +760,11 @@ public Builder addTopics(int index, com.google.pubsub.v1.Topic value) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addTopics(com.google.pubsub.v1.Topic.Builder builderForValue) { if (topicsBuilder_ == null) { @@ -767,10 +780,11 @@ public Builder addTopics(com.google.pubsub.v1.Topic.Builder builderForValue) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addTopics(int index, com.google.pubsub.v1.Topic.Builder builderForValue) { if (topicsBuilder_ == null) { @@ -786,10 +800,11 @@ public Builder addTopics(int index, com.google.pubsub.v1.Topic.Builder builderFo * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addAllTopics(java.lang.Iterable values) { if (topicsBuilder_ == null) { @@ -805,10 +820,11 @@ public Builder addAllTopics(java.lang.Iterable - * The resulting topics. + * Optional. The resulting topics. * * - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearTopics() { if (topicsBuilder_ == null) { @@ -824,10 +840,11 @@ public Builder clearTopics() { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder removeTopics(int index) { if (topicsBuilder_ == null) { @@ -843,10 +860,11 @@ public Builder removeTopics(int index) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Topic.Builder getTopicsBuilder(int index) { return getTopicsFieldBuilder().getBuilder(index); @@ -855,10 +873,11 @@ public com.google.pubsub.v1.Topic.Builder getTopicsBuilder(int index) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.TopicOrBuilder getTopicsOrBuilder(int index) { if (topicsBuilder_ == null) { @@ -871,10 +890,11 @@ public com.google.pubsub.v1.TopicOrBuilder getTopicsOrBuilder(int index) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getTopicsOrBuilderList() { if (topicsBuilder_ != null) { @@ -887,10 +907,11 @@ public java.util.List getTopicsOr * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Topic.Builder addTopicsBuilder() { return getTopicsFieldBuilder().addBuilder(com.google.pubsub.v1.Topic.getDefaultInstance()); @@ -899,10 +920,11 @@ public com.google.pubsub.v1.Topic.Builder addTopicsBuilder() { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.Topic.Builder addTopicsBuilder(int index) { return getTopicsFieldBuilder() @@ -912,10 +934,11 @@ public com.google.pubsub.v1.Topic.Builder addTopicsBuilder(int index) { * * * 
-     * The resulting topics.
+     * Optional. The resulting topics.
      *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getTopicsBuilderList() { return getTopicsFieldBuilder().getBuilderList(); @@ -943,11 +966,11 @@ public java.util.List getTopicsBuilderList() * * * 
-     * If not empty, indicates that there may be more topics that match the
-     * request; this value should be passed in a new `ListTopicsRequest`.
+     * Optional. If not empty, indicates that there may be more topics that match
+     * the request; this value should be passed in a new `ListTopicsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -966,11 +989,11 @@ public java.lang.String getNextPageToken() { * * * 
-     * If not empty, indicates that there may be more topics that match the
-     * request; this value should be passed in a new `ListTopicsRequest`.
+     * Optional. If not empty, indicates that there may be more topics that match
+     * the request; this value should be passed in a new `ListTopicsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ @@ -989,11 +1012,11 @@ public com.google.protobuf.ByteString getNextPageTokenBytes() { * * * 
-     * If not empty, indicates that there may be more topics that match the
-     * request; this value should be passed in a new `ListTopicsRequest`.
+     * Optional. If not empty, indicates that there may be more topics that match
+     * the request; this value should be passed in a new `ListTopicsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The nextPageToken to set. * @return This builder for chaining. @@ -1011,11 +1034,11 @@ public Builder setNextPageToken(java.lang.String value) { * * * 
-     * If not empty, indicates that there may be more topics that match the
-     * request; this value should be passed in a new `ListTopicsRequest`.
+     * Optional. If not empty, indicates that there may be more topics that match
+     * the request; this value should be passed in a new `ListTopicsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -1029,11 +1052,11 @@ public Builder clearNextPageToken() { * * * 
-     * If not empty, indicates that there may be more topics that match the
-     * request; this value should be passed in a new `ListTopicsRequest`.
+     * Optional. If not empty, indicates that there may be more topics that match
+     * the request; this value should be passed in a new `ListTopicsRequest`.
      *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for nextPageToken to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponseOrBuilder.java index fd03ece34..42d7bcb44 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ListTopicsResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,50 +27,55 @@ public interface ListTopicsResponseOrBuilder * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getTopicsList(); /** * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.Topic getTopics(int index); /** * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ int getTopicsCount(); /** * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getTopicsOrBuilderList(); /** * * * 
-   * The resulting topics.
+   * Optional. The resulting topics.
    *
* - * repeated .google.pubsub.v1.Topic topics = 1; + * repeated .google.pubsub.v1.Topic topics = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.TopicOrBuilder getTopicsOrBuilder(int index); @@ -78,11 +83,11 @@ public interface ListTopicsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more topics that match the
-   * request; this value should be passed in a new `ListTopicsRequest`.
+   * Optional. If not empty, indicates that there may be more topics that match
+   * the request; this value should be passed in a new `ListTopicsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The nextPageToken. */ @@ -91,11 +96,11 @@ public interface ListTopicsResponseOrBuilder * * * 
-   * If not empty, indicates that there may be more topics that match the
-   * request; this value should be passed in a new `ListTopicsRequest`.
+   * Optional. If not empty, indicates that there may be more topics that match
+   * the request; this value should be passed in a new `ListTopicsRequest`.
    *
* - * string next_page_token = 2; + * string next_page_token = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for nextPageToken. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java index 06c6e9aba..eb2f9ffbf 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicy.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -71,15 +71,17 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return A list containing the allowedPersistenceRegions. */ @@ -90,15 +92,17 @@ public com.google.protobuf.ProtocolStringList getAllowedPersistenceRegionsList() * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The count of allowedPersistenceRegions. */ @@ -109,15 +113,17 @@ public int getAllowedPersistenceRegionsCount() { * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param index The index of the element to return. * @return The allowedPersistenceRegions at the given index. @@ -129,15 +135,17 @@ public java.lang.String getAllowedPersistenceRegions(int index) { * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param index The index of the value to return. * @return The bytes of the allowedPersistenceRegions at the given index. @@ -146,6 +154,28 @@ public com.google.protobuf.ByteString getAllowedPersistenceRegionsBytes(int inde return allowedPersistenceRegions_.getByteString(index); } + public static final int ENFORCE_IN_TRANSIT_FIELD_NUMBER = 2; + private boolean enforceInTransit_ = false; + /** + * + * + * 
+   * Optional. If true, `allowed_persistence_regions` is also used to enforce
+   * in-transit guarantees for messages. That is, Pub/Sub will fail
+   * Publish operations on this topic and subscribe operations
+   * on any subscription attached to this topic in any region that is
+   * not in `allowed_persistence_regions`.
+   *
+ * + * bool enforce_in_transit = 2 [(.google.api.field_behavior) = OPTIONAL]; + * + * @return The enforceInTransit. + */ + @java.lang.Override + public boolean getEnforceInTransit() { + return enforceInTransit_; + } + private byte memoizedIsInitialized = -1; @java.lang.Override @@ -164,6 +194,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io com.google.protobuf.GeneratedMessageV3.writeString( output, 1, allowedPersistenceRegions_.getRaw(i)); } + if (enforceInTransit_ != false) { + output.writeBool(2, enforceInTransit_); + } getUnknownFields().writeTo(output); } @@ -181,6 +214,9 @@ public int getSerializedSize() { size += dataSize; size += 1 * getAllowedPersistenceRegionsList().size(); } + if (enforceInTransit_ != false) { + size += com.google.protobuf.CodedOutputStream.computeBoolSize(2, enforceInTransit_); + } size += getUnknownFields().getSerializedSize(); memoizedSize = size; return size; @@ -199,6 +235,7 @@ public boolean equals(final java.lang.Object obj) { if (!getAllowedPersistenceRegionsList().equals(other.getAllowedPersistenceRegionsList())) return false; + if (getEnforceInTransit() != other.getEnforceInTransit()) return false; if (!getUnknownFields().equals(other.getUnknownFields())) return false; return true; } @@ -214,6 +251,8 @@ public int hashCode() { hash = (37 * hash) + ALLOWED_PERSISTENCE_REGIONS_FIELD_NUMBER; hash = (53 * hash) + getAllowedPersistenceRegionsList().hashCode(); } + hash = (37 * hash) + ENFORCE_IN_TRANSIT_FIELD_NUMBER; + hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getEnforceInTransit()); hash = (29 * hash) + getUnknownFields().hashCode(); memoizedHashCode = hash; return hash; @@ -354,6 +393,7 @@ public Builder clear() { super.clear(); bitField0_ = 0; allowedPersistenceRegions_ = com.google.protobuf.LazyStringArrayList.emptyList(); + enforceInTransit_ = false; return this; } @@ -394,6 +434,9 @@ private void buildPartial0(com.google.pubsub.v1.MessageStoragePolicy result) { allowedPersistenceRegions_.makeImmutable(); result.allowedPersistenceRegions_ = allowedPersistenceRegions_; } + if (((from_bitField0_ & 0x00000002) != 0)) { + result.enforceInTransit_ = enforceInTransit_; + } } @java.lang.Override @@ -451,6 +494,9 @@ public Builder mergeFrom(com.google.pubsub.v1.MessageStoragePolicy other) { } onChanged(); } + if (other.getEnforceInTransit() != false) { + setEnforceInTransit(other.getEnforceInTransit()); + } this.mergeUnknownFields(other.getUnknownFields()); onChanged(); return this; @@ -484,6 +530,12 @@ public Builder mergeFrom( allowedPersistenceRegions_.add(s); break; } // case 10 + case 16: + { + enforceInTransit_ = input.readBool(); + bitField0_ |= 0x00000002; + break; + } // case 16 default: { if (!super.parseUnknownField(input, extensionRegistry, tag)) { @@ -517,15 +569,17 @@ private void ensureAllowedPersistenceRegionsIsMutable() { * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return A list containing the allowedPersistenceRegions. */ @@ -537,15 +591,17 @@ public com.google.protobuf.ProtocolStringList getAllowedPersistenceRegionsList() * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The count of allowedPersistenceRegions. */ @@ -556,15 +612,17 @@ public int getAllowedPersistenceRegionsCount() { * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param index The index of the element to return. * @return The allowedPersistenceRegions at the given index. @@ -576,15 +634,17 @@ public java.lang.String getAllowedPersistenceRegions(int index) { * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param index The index of the value to return. * @return The bytes of the allowedPersistenceRegions at the given index. @@ -596,15 +656,17 @@ public com.google.protobuf.ByteString getAllowedPersistenceRegionsBytes(int inde * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param index The index to set the value at. * @param value The allowedPersistenceRegions to set. @@ -624,15 +686,17 @@ public Builder setAllowedPersistenceRegions(int index, java.lang.String value) { * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param value The allowedPersistenceRegions to add. * @return This builder for chaining. @@ -651,15 +715,17 @@ public Builder addAllowedPersistenceRegions(java.lang.String value) { * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param values The allowedPersistenceRegions to add. * @return This builder for chaining. @@ -675,15 +741,17 @@ public Builder addAllAllowedPersistenceRegions(java.lang.Iterable - * A list of IDs of Google Cloud regions where messages that are published - * to the topic may be persisted in storage. Messages published by publishers - * running in non-allowed Google Cloud regions (or running outside of Google - * Cloud altogether) are routed for storage in one of the allowed regions. - * An empty list means that no regions are allowed, and is not a valid - * configuration. + * Optional. A list of IDs of Google Cloud regions where messages that are + * published to the topic may be persisted in storage. Messages published by + * publishers running in non-allowed Google Cloud regions (or running outside + * of Google Cloud altogether) are routed for storage in one of the allowed + * regions. An empty list means that no regions are allowed, and is not a + * valid configuration. * * - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return This builder for chaining. */ @@ -698,15 +766,17 @@ public Builder clearAllowedPersistenceRegions() { * * * 
-     * A list of IDs of Google Cloud regions where messages that are published
-     * to the topic may be persisted in storage. Messages published by publishers
-     * running in non-allowed Google Cloud regions (or running outside of Google
-     * Cloud altogether) are routed for storage in one of the allowed regions.
-     * An empty list means that no regions are allowed, and is not a valid
-     * configuration.
+     * Optional. A list of IDs of Google Cloud regions where messages that are
+     * published to the topic may be persisted in storage. Messages published by
+     * publishers running in non-allowed Google Cloud regions (or running outside
+     * of Google Cloud altogether) are routed for storage in one of the allowed
+     * regions. An empty list means that no regions are allowed, and is not a
+     * valid configuration.
      *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param value The bytes of the allowedPersistenceRegions to add. * @return This builder for chaining. @@ -723,6 +793,71 @@ public Builder addAllowedPersistenceRegionsBytes(com.google.protobuf.ByteString return this; } + private boolean enforceInTransit_; + /** + * + * + * 
+     * Optional. If true, `allowed_persistence_regions` is also used to enforce
+     * in-transit guarantees for messages. That is, Pub/Sub will fail
+     * Publish operations on this topic and subscribe operations
+     * on any subscription attached to this topic in any region that is
+     * not in `allowed_persistence_regions`.
+     *
+ * + * bool enforce_in_transit = 2 [(.google.api.field_behavior) = OPTIONAL]; + * + * @return The enforceInTransit. + */ + @java.lang.Override + public boolean getEnforceInTransit() { + return enforceInTransit_; + } + /** + * + * + * 
+     * Optional. If true, `allowed_persistence_regions` is also used to enforce
+     * in-transit guarantees for messages. That is, Pub/Sub will fail
+     * Publish operations on this topic and subscribe operations
+     * on any subscription attached to this topic in any region that is
+     * not in `allowed_persistence_regions`.
+     *
+ * + * bool enforce_in_transit = 2 [(.google.api.field_behavior) = OPTIONAL]; + * + * @param value The enforceInTransit to set. + * @return This builder for chaining. + */ + public Builder setEnforceInTransit(boolean value) { + + enforceInTransit_ = value; + bitField0_ |= 0x00000002; + onChanged(); + return this; + } + /** + * + * + * 
+     * Optional. If true, `allowed_persistence_regions` is also used to enforce
+     * in-transit guarantees for messages. That is, Pub/Sub will fail
+     * Publish operations on this topic and subscribe operations
+     * on any subscription attached to this topic in any region that is
+     * not in `allowed_persistence_regions`.
+     *
+ * + * bool enforce_in_transit = 2 [(.google.api.field_behavior) = OPTIONAL]; + * + * @return This builder for chaining. + */ + public Builder clearEnforceInTransit() { + bitField0_ = (bitField0_ & ~0x00000002); + enforceInTransit_ = false; + onChanged(); + return this; + } + @java.lang.Override public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) { return super.setUnknownFields(unknownFields); diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java index 5f075aca0..bc798cf5b 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/MessageStoragePolicyOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,15 +27,17 @@ public interface MessageStoragePolicyOrBuilder * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return A list containing the allowedPersistenceRegions. */ @@ -44,15 +46,17 @@ public interface MessageStoragePolicyOrBuilder * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The count of allowedPersistenceRegions. */ @@ -61,15 +65,17 @@ public interface MessageStoragePolicyOrBuilder * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param index The index of the element to return. * @return The allowedPersistenceRegions at the given index. @@ -79,18 +85,37 @@ public interface MessageStoragePolicyOrBuilder * * * 
-   * A list of IDs of Google Cloud regions where messages that are published
-   * to the topic may be persisted in storage. Messages published by publishers
-   * running in non-allowed Google Cloud regions (or running outside of Google
-   * Cloud altogether) are routed for storage in one of the allowed regions.
-   * An empty list means that no regions are allowed, and is not a valid
-   * configuration.
+   * Optional. A list of IDs of Google Cloud regions where messages that are
+   * published to the topic may be persisted in storage. Messages published by
+   * publishers running in non-allowed Google Cloud regions (or running outside
+   * of Google Cloud altogether) are routed for storage in one of the allowed
+   * regions. An empty list means that no regions are allowed, and is not a
+   * valid configuration.
    *
* - * repeated string allowed_persistence_regions = 1; + * + * repeated string allowed_persistence_regions = 1 [(.google.api.field_behavior) = OPTIONAL]; + * * * @param index The index of the value to return. * @return The bytes of the allowedPersistenceRegions at the given index. */ com.google.protobuf.ByteString getAllowedPersistenceRegionsBytes(int index); + + /** + * + * + * 
+   * Optional. If true, `allowed_persistence_regions` is also used to enforce
+   * in-transit guarantees for messages. That is, Pub/Sub will fail
+   * Publish operations on this topic and subscribe operations
+   * on any subscription attached to this topic in any region that is
+   * not in `allowed_persistence_regions`.
+   *
+ * + * bool enforce_in_transit = 2 [(.google.api.field_behavior) = OPTIONAL]; + * + * @return The enforceInTransit. + */ + boolean getEnforceInTransit(); } diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java index 8348ebf3c..0e876c7b5 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -197,7 +197,8 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) { * 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). + * The maximum deadline you can specify in a single request is 600 seconds + * (10 minutes). * * * int32 ack_deadline_seconds = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -917,7 +918,8 @@ public Builder addAckIdsBytes(com.google.protobuf.ByteString value) { * 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). + * The maximum deadline you can specify in a single request is 600 seconds + * (10 minutes). * * * int32 ack_deadline_seconds = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -939,7 +941,8 @@ public int getAckDeadlineSeconds() { * 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). + * The maximum deadline you can specify in a single request is 600 seconds + * (10 minutes). * * * int32 ack_deadline_seconds = 3 [(.google.api.field_behavior) = REQUIRED]; @@ -965,7 +968,8 @@ public Builder setAckDeadlineSeconds(int value) { * 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). + * The maximum deadline you can specify in a single request is 600 seconds + * (10 minutes). * * * int32 ack_deadline_seconds = 3 [(.google.api.field_behavior) = REQUIRED]; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java index 8c0843c7d..ebc7adb12 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyAckDeadlineRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -116,7 +116,8 @@ public interface ModifyAckDeadlineRequestOrBuilder * 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). + * The maximum deadline you can specify in a single request is 600 seconds + * (10 minutes). * * * int32 ack_deadline_seconds = 3 [(.google.api.field_behavior) = REQUIRED]; diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequest.java index a1b5050ee..149b4c6b7 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequestOrBuilder.java index 96d5ca4c1..070e63226 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ModifyPushConfigRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequest.java index 2268fc162..69e13fab3 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequestOrBuilder.java index a0b5cde08..c4309802a 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponse.java index 0a0905e94..dcc525d03 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -71,12 +71,12 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return A list containing the messageIds. */ @@ -87,12 +87,12 @@ public com.google.protobuf.ProtocolStringList getMessageIdsList() { * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The count of messageIds. */ @@ -103,12 +103,12 @@ public int getMessageIdsCount() { * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the element to return. * @return The messageIds at the given index. @@ -120,12 +120,12 @@ public java.lang.String getMessageIds(int index) { * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the value to return. * @return The bytes of the messageIds at the given index. @@ -499,12 +499,12 @@ private void ensureMessageIdsIsMutable() { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return A list containing the messageIds. */ @@ -516,12 +516,12 @@ public com.google.protobuf.ProtocolStringList getMessageIdsList() { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The count of messageIds. */ @@ -532,12 +532,12 @@ public int getMessageIdsCount() { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the element to return. * @return The messageIds at the given index. @@ -549,12 +549,12 @@ public java.lang.String getMessageIds(int index) { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the value to return. * @return The bytes of the messageIds at the given index. @@ -566,12 +566,12 @@ public com.google.protobuf.ByteString getMessageIdsBytes(int index) { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index to set the value at. * @param value The messageIds to set. @@ -591,12 +591,12 @@ public Builder setMessageIds(int index, java.lang.String value) { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The messageIds to add. * @return This builder for chaining. @@ -615,12 +615,12 @@ public Builder addMessageIds(java.lang.String value) { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param values The messageIds to add. * @return This builder for chaining. @@ -636,12 +636,12 @@ public Builder addAllMessageIds(java.lang.Iterable values) { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -656,12 +656,12 @@ public Builder clearMessageIds() { * * * 
-     * The server-assigned ID of each published message, in the same order as
-     * the messages in the request. IDs are guaranteed to be unique within
-     * the topic.
+     * Optional. The server-assigned ID of each published message, in the same
+     * order as the messages in the request. IDs are guaranteed to be unique
+     * within the topic.
      *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes of the messageIds to add. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponseOrBuilder.java index 7d6f78725..a657c199d 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublishResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,12 +27,12 @@ public interface PublishResponseOrBuilder * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return A list containing the messageIds. */ @@ -41,12 +41,12 @@ public interface PublishResponseOrBuilder * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The count of messageIds. */ @@ -55,12 +55,12 @@ public interface PublishResponseOrBuilder * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the element to return. * @return The messageIds at the given index. @@ -70,12 +70,12 @@ public interface PublishResponseOrBuilder * * * 
-   * The server-assigned ID of each published message, in the same order as
-   * the messages in the request. IDs are guaranteed to be unique within
-   * the topic.
+   * Optional. The server-assigned ID of each published message, in the same
+   * order as the messages in the request. IDs are guaranteed to be unique
+   * within the topic.
    *
* - * repeated string message_ids = 1; + * repeated string message_ids = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param index The index of the value to return. * @return The bytes of the messageIds at the given index. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java index cab47a3c0..8f310f54c 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessage.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -88,11 +88,11 @@ protected com.google.protobuf.MapField internalGetMapField(int number) { * * * 
-   * The message data field. If this field is empty, the message must contain
-   * at least one attribute.
+   * Optional. The message data field. If this field is empty, the message must
+   * contain at least one attribute.
    *
* - * bytes data = 1; + * bytes data = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The data. */ @@ -131,12 +131,13 @@ public int getAttributesCount() { * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public boolean containsAttributes(java.lang.String key) { @@ -155,12 +156,13 @@ public java.util.Map getAttributes() { * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.Map getAttributesMap() { @@ -170,12 +172,13 @@ public java.util.Map getAttributesMap() { * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public /* nullable */ java.lang.String getAttributesOrDefault( @@ -192,12 +195,13 @@ public java.util.Map getAttributesMap() { * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.lang.String getAttributesOrThrow(java.lang.String key) { @@ -328,17 +332,17 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() { * * * 
-   * If non-empty, identifies related messages for which publish order should be
-   * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-   * messages published with the same non-empty `ordering_key` value will be
-   * delivered to subscribers in the order in which they are received by the
-   * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-   * must specify the same `ordering_key` value.
-   * For more information, see [ordering
+   * Optional. If non-empty, identifies related messages for which publish order
+   * should be respected. If a `Subscription` has `enable_message_ordering` set
+   * to `true`, messages published with the same non-empty `ordering_key` value
+   * will be delivered to subscribers in the order in which they are received by
+   * the Pub/Sub system. All `PubsubMessage`s published in a given
+   * `PublishRequest` must specify the same `ordering_key` value. For more
+   * information, see [ordering
    * messages](https://cloud.google.com/pubsub/docs/ordering).
    *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @return The orderingKey. */ @@ -358,17 +362,17 @@ public java.lang.String getOrderingKey() { * * * 
-   * If non-empty, identifies related messages for which publish order should be
-   * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-   * messages published with the same non-empty `ordering_key` value will be
-   * delivered to subscribers in the order in which they are received by the
-   * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-   * must specify the same `ordering_key` value.
-   * For more information, see [ordering
+   * Optional. If non-empty, identifies related messages for which publish order
+   * should be respected. If a `Subscription` has `enable_message_ordering` set
+   * to `true`, messages published with the same non-empty `ordering_key` value
+   * will be delivered to subscribers in the order in which they are received by
+   * the Pub/Sub system. All `PubsubMessage`s published in a given
+   * `PublishRequest` must specify the same `ordering_key` value. For more
+   * information, see [ordering
    * messages](https://cloud.google.com/pubsub/docs/ordering).
    *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for orderingKey. */ @@ -869,11 +873,11 @@ public Builder mergeFrom( * * * 
-     * The message data field. If this field is empty, the message must contain
-     * at least one attribute.
+     * Optional. The message data field. If this field is empty, the message must
+     * contain at least one attribute.
      *
* - * bytes data = 1; + * bytes data = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The data. */ @@ -885,11 +889,11 @@ public com.google.protobuf.ByteString getData() { * * * 
-     * The message data field. If this field is empty, the message must contain
-     * at least one attribute.
+     * Optional. The message data field. If this field is empty, the message must
+     * contain at least one attribute.
      *
* - * bytes data = 1; + * bytes data = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The data to set. * @return This builder for chaining. @@ -907,11 +911,11 @@ public Builder setData(com.google.protobuf.ByteString value) { * * * 
-     * The message data field. If this field is empty, the message must contain
-     * at least one attribute.
+     * Optional. The message data field. If this field is empty, the message must
+     * contain at least one attribute.
      *
* - * bytes data = 1; + * bytes data = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -954,12 +958,13 @@ public int getAttributesCount() { * * * 
-     * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data. This can be used to filter messages on the
+     * Optional. Attributes for this message. If this field is empty, the message
+     * must contain non-empty data. This can be used to filter messages on the
      * subscription.
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public boolean containsAttributes(java.lang.String key) { @@ -978,12 +983,13 @@ public java.util.Map getAttributes() { * * * 
-     * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data. This can be used to filter messages on the
+     * Optional. Attributes for this message. If this field is empty, the message
+     * must contain non-empty data. This can be used to filter messages on the
      * subscription.
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.Map getAttributesMap() { @@ -993,12 +999,13 @@ public java.util.Map getAttributesMap() { * * * 
-     * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data. This can be used to filter messages on the
+     * Optional. Attributes for this message. If this field is empty, the message
+     * must contain non-empty data. This can be used to filter messages on the
      * subscription.
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public /* nullable */ java.lang.String getAttributesOrDefault( @@ -1015,12 +1022,13 @@ public java.util.Map getAttributesMap() { * * * 
-     * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data. This can be used to filter messages on the
+     * Optional. Attributes for this message. If this field is empty, the message
+     * must contain non-empty data. This can be used to filter messages on the
      * subscription.
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.lang.String getAttributesOrThrow(java.lang.String key) { @@ -1043,12 +1051,13 @@ public Builder clearAttributes() { * * * 
-     * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data. This can be used to filter messages on the
+     * Optional. Attributes for this message. If this field is empty, the message
+     * must contain non-empty data. This can be used to filter messages on the
      * subscription.
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder removeAttributes(java.lang.String key) { if (key == null) { @@ -1067,12 +1076,13 @@ public java.util.Map getMutableAttributes() * * * 
-     * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data. This can be used to filter messages on the
+     * Optional. Attributes for this message. If this field is empty, the message
+     * must contain non-empty data. This can be used to filter messages on the
      * subscription.
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder putAttributes(java.lang.String key, java.lang.String value) { if (key == null) { @@ -1089,12 +1099,13 @@ public Builder putAttributes(java.lang.String key, java.lang.String value) { * * * 
-     * Attributes for this message. If this field is empty, the message must
-     * contain non-empty data. This can be used to filter messages on the
+     * Optional. Attributes for this message. If this field is empty, the message
+     * must contain non-empty data. This can be used to filter messages on the
      * subscription.
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder putAllAttributes(java.util.Map values) { internalGetMutableAttributes().getMutableMap().putAll(values); @@ -1429,17 +1440,17 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() { * * * 
-     * If non-empty, identifies related messages for which publish order should be
-     * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-     * messages published with the same non-empty `ordering_key` value will be
-     * delivered to subscribers in the order in which they are received by the
-     * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-     * must specify the same `ordering_key` value.
-     * For more information, see [ordering
+     * Optional. If non-empty, identifies related messages for which publish order
+     * should be respected. If a `Subscription` has `enable_message_ordering` set
+     * to `true`, messages published with the same non-empty `ordering_key` value
+     * will be delivered to subscribers in the order in which they are received by
+     * the Pub/Sub system. All `PubsubMessage`s published in a given
+     * `PublishRequest` must specify the same `ordering_key` value. For more
+     * information, see [ordering
      * messages](https://cloud.google.com/pubsub/docs/ordering).
      *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @return The orderingKey. */ @@ -1458,17 +1469,17 @@ public java.lang.String getOrderingKey() { * * * 
-     * If non-empty, identifies related messages for which publish order should be
-     * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-     * messages published with the same non-empty `ordering_key` value will be
-     * delivered to subscribers in the order in which they are received by the
-     * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-     * must specify the same `ordering_key` value.
-     * For more information, see [ordering
+     * Optional. If non-empty, identifies related messages for which publish order
+     * should be respected. If a `Subscription` has `enable_message_ordering` set
+     * to `true`, messages published with the same non-empty `ordering_key` value
+     * will be delivered to subscribers in the order in which they are received by
+     * the Pub/Sub system. All `PubsubMessage`s published in a given
+     * `PublishRequest` must specify the same `ordering_key` value. For more
+     * information, see [ordering
      * messages](https://cloud.google.com/pubsub/docs/ordering).
      *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for orderingKey. */ @@ -1487,17 +1498,17 @@ public com.google.protobuf.ByteString getOrderingKeyBytes() { * * * 
-     * If non-empty, identifies related messages for which publish order should be
-     * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-     * messages published with the same non-empty `ordering_key` value will be
-     * delivered to subscribers in the order in which they are received by the
-     * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-     * must specify the same `ordering_key` value.
-     * For more information, see [ordering
+     * Optional. If non-empty, identifies related messages for which publish order
+     * should be respected. If a `Subscription` has `enable_message_ordering` set
+     * to `true`, messages published with the same non-empty `ordering_key` value
+     * will be delivered to subscribers in the order in which they are received by
+     * the Pub/Sub system. All `PubsubMessage`s published in a given
+     * `PublishRequest` must specify the same `ordering_key` value. For more
+     * information, see [ordering
      * messages](https://cloud.google.com/pubsub/docs/ordering).
      *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The orderingKey to set. * @return This builder for chaining. @@ -1515,17 +1526,17 @@ public Builder setOrderingKey(java.lang.String value) { * * * 
-     * If non-empty, identifies related messages for which publish order should be
-     * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-     * messages published with the same non-empty `ordering_key` value will be
-     * delivered to subscribers in the order in which they are received by the
-     * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-     * must specify the same `ordering_key` value.
-     * For more information, see [ordering
+     * Optional. If non-empty, identifies related messages for which publish order
+     * should be respected. If a `Subscription` has `enable_message_ordering` set
+     * to `true`, messages published with the same non-empty `ordering_key` value
+     * will be delivered to subscribers in the order in which they are received by
+     * the Pub/Sub system. All `PubsubMessage`s published in a given
+     * `PublishRequest` must specify the same `ordering_key` value. For more
+     * information, see [ordering
      * messages](https://cloud.google.com/pubsub/docs/ordering).
      *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -1539,17 +1550,17 @@ public Builder clearOrderingKey() { * * * 
-     * If non-empty, identifies related messages for which publish order should be
-     * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-     * messages published with the same non-empty `ordering_key` value will be
-     * delivered to subscribers in the order in which they are received by the
-     * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-     * must specify the same `ordering_key` value.
-     * For more information, see [ordering
+     * Optional. If non-empty, identifies related messages for which publish order
+     * should be respected. If a `Subscription` has `enable_message_ordering` set
+     * to `true`, messages published with the same non-empty `ordering_key` value
+     * will be delivered to subscribers in the order in which they are received by
+     * the Pub/Sub system. All `PubsubMessage`s published in a given
+     * `PublishRequest` must specify the same `ordering_key` value. For more
+     * information, see [ordering
      * messages](https://cloud.google.com/pubsub/docs/ordering).
      *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for orderingKey to set. * @return This builder for chaining. diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java index 9e73913c8..2736aca97 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,11 +27,11 @@ public interface PubsubMessageOrBuilder * * * 
-   * The message data field. If this field is empty, the message must contain
-   * at least one attribute.
+   * Optional. The message data field. If this field is empty, the message must
+   * contain at least one attribute.
    *
* - * bytes data = 1; + * bytes data = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The data. */ @@ -41,24 +41,26 @@ public interface PubsubMessageOrBuilder * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ int getAttributesCount(); /** * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ boolean containsAttributes(java.lang.String key); /** Use {@link #getAttributesMap()} instead. */ @@ -68,24 +70,26 @@ public interface PubsubMessageOrBuilder * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.Map getAttributesMap(); /** * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ /* nullable */ java.lang.String getAttributesOrDefault( @@ -96,12 +100,13 @@ java.lang.String getAttributesOrDefault( * * * 
-   * Attributes for this message. If this field is empty, the message must
-   * contain non-empty data. This can be used to filter messages on the
+   * Optional. Attributes for this message. If this field is empty, the message
+   * must contain non-empty data. This can be used to filter messages on the
    * subscription.
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.lang.String getAttributesOrThrow(java.lang.String key); @@ -181,17 +186,17 @@ java.lang.String getAttributesOrDefault( * * * 
-   * If non-empty, identifies related messages for which publish order should be
-   * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-   * messages published with the same non-empty `ordering_key` value will be
-   * delivered to subscribers in the order in which they are received by the
-   * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-   * must specify the same `ordering_key` value.
-   * For more information, see [ordering
+   * Optional. If non-empty, identifies related messages for which publish order
+   * should be respected. If a `Subscription` has `enable_message_ordering` set
+   * to `true`, messages published with the same non-empty `ordering_key` value
+   * will be delivered to subscribers in the order in which they are received by
+   * the Pub/Sub system. All `PubsubMessage`s published in a given
+   * `PublishRequest` must specify the same `ordering_key` value. For more
+   * information, see [ordering
    * messages](https://cloud.google.com/pubsub/docs/ordering).
    *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @return The orderingKey. */ @@ -200,17 +205,17 @@ java.lang.String getAttributesOrDefault( * * * 
-   * If non-empty, identifies related messages for which publish order should be
-   * respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-   * messages published with the same non-empty `ordering_key` value will be
-   * delivered to subscribers in the order in which they are received by the
-   * Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-   * must specify the same `ordering_key` value.
-   * For more information, see [ordering
+   * Optional. If non-empty, identifies related messages for which publish order
+   * should be respected. If a `Subscription` has `enable_message_ordering` set
+   * to `true`, messages published with the same non-empty `ordering_key` value
+   * will be delivered to subscribers in the order in which they are received by
+   * the Pub/Sub system. All `PubsubMessage`s published in a given
+   * `PublishRequest` must specify the same `ordering_key` value. For more
+   * information, see [ordering
    * messages](https://cloud.google.com/pubsub/docs/ordering).
    *
* - * string ordering_key = 5; + * string ordering_key = 5 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for orderingKey. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java index b680117a0..971dec18f 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubProto.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -35,6 +35,14 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r internal_static_google_pubsub_v1_SchemaSettings_descriptor; static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internal_static_google_pubsub_v1_SchemaSettings_fieldAccessorTable; + static final com.google.protobuf.Descriptors.Descriptor + internal_static_google_pubsub_v1_IngestionDataSourceSettings_descriptor; + static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable + internal_static_google_pubsub_v1_IngestionDataSourceSettings_fieldAccessorTable; + static final com.google.protobuf.Descriptors.Descriptor + internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_descriptor; + static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable + internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_fieldAccessorTable; static final com.google.protobuf.Descriptors.Descriptor internal_static_google_pubsub_v1_Topic_descriptor; static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable @@ -284,330 +292,366 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "ogle/protobuf/empty.proto\032 google/protob" + "uf/field_mask.proto\032\037google/protobuf/tim" + "estamp.proto\032\035google/pubsub/v1/schema.pr" - + "oto\";\n\024MessageStoragePolicy\022#\n\033allowed_p" - + "ersistence_regions\030\001 \003(\t\"\252\001\n\016SchemaSetti" + + "oto\"c\n\024MessageStoragePolicy\022)\n\033allowed_p" + + "ersistence_regions\030\001 \003(\tB\004\342A\001\001\022 \n\022enforc" + + "e_in_transit\030\002 \001(\010B\004\342A\001\001\"\274\001\n\016SchemaSetti" + "ngs\0225\n\006schema\030\001 \001(\tB%\342A\001\002\372A\036\n\034pubsub.goo" - + "gleapis.com/Schema\022,\n\010encoding\030\002 \001(\0162\032.g" - + "oogle.pubsub.v1.Encoding\022\031\n\021first_revisi" - + "on_id\030\003 \001(\t\022\030\n\020last_revision_id\030\004 \001(\t\"\304\003" - + "\n\005Topic\022\022\n\004name\030\001 \001(\tB\004\342A\001\002\0223\n\006labels\030\002 " - + "\003(\0132#.google.pubsub.v1.Topic.LabelsEntry" - + "\022F\n\026message_storage_policy\030\003 \001(\0132&.googl" - + "e.pubsub.v1.MessageStoragePolicy\022\024\n\014kms_" - + "key_name\030\005 \001(\t\0229\n\017schema_settings\030\006 \001(\0132" - + " .google.pubsub.v1.SchemaSettings\022\025\n\rsat" - + "isfies_pzs\030\007 \001(\010\022=\n\032message_retention_du" - + "ration\030\010 \001(\0132\031.google.protobuf.Duration\032" - + "-\n\013LabelsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001" - + "(\t:\0028\001:T\352AQ\n\033pubsub.googleapis.com/Topic" - + "\022!projects/{project}/topics/{topic}\022\017_de" - + "leted-topic_\"\361\001\n\rPubsubMessage\022\014\n\004data\030\001" - + " \001(\014\022C\n\nattributes\030\002 \003(\0132/.google.pubsub" - + ".v1.PubsubMessage.AttributesEntry\022\022\n\nmes" - + "sage_id\030\003 \001(\t\0220\n\014publish_time\030\004 \001(\0132\032.go" - + "ogle.protobuf.Timestamp\022\024\n\014ordering_key\030" - + "\005 \001(\t\0321\n\017AttributesEntry\022\013\n\003key\030\001 \001(\t\022\r\n" - + "\005value\030\002 \001(\t:\0028\001\"F\n\017GetTopicRequest\0223\n\005t" - + "opic\030\001 \001(\tB$\342A\001\002\372A\035\n\033pubsub.googleapis.c" - + "om/Topic\"y\n\022UpdateTopicRequest\022,\n\005topic\030" - + "\001 \001(\0132\027.google.pubsub.v1.TopicB\004\342A\001\002\0225\n\013" - + "update_mask\030\002 \001(\0132\032.google.protobuf.Fiel" - + "dMaskB\004\342A\001\002\"~\n\016PublishRequest\0223\n\005topic\030\001" + + "gleapis.com/Schema\0222\n\010encoding\030\002 \001(\0162\032.g" + + "oogle.pubsub.v1.EncodingB\004\342A\001\001\022\037\n\021first_" + + "revision_id\030\003 \001(\tB\004\342A\001\001\022\036\n\020last_revision" + + "_id\030\004 \001(\tB\004\342A\001\001\"\360\003\n\033IngestionDataSourceS" + + "ettings\022U\n\013aws_kinesis\030\001 \001(\01328.google.pu" + + "bsub.v1.IngestionDataSourceSettings.AwsK" + + "inesisB\004\342A\001\001H\000\032\357\002\n\nAwsKinesis\022S\n\005state\030\001" + + " \001(\0162>.google.pubsub.v1.IngestionDataSou" + + "rceSettings.AwsKinesis.StateB\004\342A\001\003\022\030\n\nst" + + "ream_arn\030\002 \001(\tB\004\342A\001\002\022\032\n\014consumer_arn\030\003 \001" + + "(\tB\004\342A\001\002\022\032\n\014aws_role_arn\030\004 \001(\tB\004\342A\001\002\022!\n\023" + + "gcp_service_account\030\005 \001(\tB\004\342A\001\002\"\226\001\n\005Stat" + + "e\022\025\n\021STATE_UNSPECIFIED\020\000\022\n\n\006ACTIVE\020\001\022\035\n\031" + + "KINESIS_PERMISSION_DENIED\020\002\022\035\n\031PUBLISH_P" + + "ERMISSION_DENIED\020\003\022\024\n\020STREAM_NOT_FOUND\020\004" + + "\022\026\n\022CONSUMER_NOT_FOUND\020\005B\010\n\006source\"\303\005\n\005T" + + "opic\022\022\n\004name\030\001 \001(\tB\004\342A\001\002\0229\n\006labels\030\002 \003(\013" + + "2#.google.pubsub.v1.Topic.LabelsEntryB\004\342" + + "A\001\001\022L\n\026message_storage_policy\030\003 \001(\0132&.go" + + "ogle.pubsub.v1.MessageStoragePolicyB\004\342A\001" + + "\001\022\032\n\014kms_key_name\030\005 \001(\tB\004\342A\001\001\022?\n\017schema_" + + "settings\030\006 \001(\0132 .google.pubsub.v1.Schema" + + "SettingsB\004\342A\001\001\022\033\n\rsatisfies_pzs\030\007 \001(\010B\004\342" + + "A\001\001\022C\n\032message_retention_duration\030\010 \001(\0132" + + "\031.google.protobuf.DurationB\004\342A\001\001\0222\n\005stat" + + "e\030\t \001(\0162\035.google.pubsub.v1.Topic.StateB\004" + + "\342A\001\003\022[\n\036ingestion_data_source_settings\030\n" + + " \001(\0132-.google.pubsub.v1.IngestionDataSou" + + "rceSettingsB\004\342A\001\001\032-\n\013LabelsEntry\022\013\n\003key\030" + + "\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"H\n\005State\022\025\n\021STA" + + "TE_UNSPECIFIED\020\000\022\n\n\006ACTIVE\020\001\022\034\n\030INGESTIO" + + "N_RESOURCE_ERROR\020\002:T\352AQ\n\033pubsub.googleap" + + "is.com/Topic\022!projects/{project}/topics/" + + "{topic}\022\017_deleted-topic_\"\203\002\n\rPubsubMessa" + + "ge\022\022\n\004data\030\001 \001(\014B\004\342A\001\001\022I\n\nattributes\030\002 \003" + + "(\0132/.google.pubsub.v1.PubsubMessage.Attr" + + "ibutesEntryB\004\342A\001\001\022\022\n\nmessage_id\030\003 \001(\t\0220\n" + + "\014publish_time\030\004 \001(\0132\032.google.protobuf.Ti" + + "mestamp\022\032\n\014ordering_key\030\005 \001(\tB\004\342A\001\001\0321\n\017A" + + "ttributesEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001" + + "(\t:\0028\001\"F\n\017GetTopicRequest\0223\n\005topic\030\001 \001(\t" + + "B$\342A\001\002\372A\035\n\033pubsub.googleapis.com/Topic\"y" + + "\n\022UpdateTopicRequest\022,\n\005topic\030\001 \001(\0132\027.go" + + "ogle.pubsub.v1.TopicB\004\342A\001\002\0225\n\013update_mas" + + "k\030\002 \001(\0132\032.google.protobuf.FieldMaskB\004\342A\001" + + "\002\"~\n\016PublishRequest\0223\n\005topic\030\001 \001(\tB$\342A\001\002" + + "\372A\035\n\033pubsub.googleapis.com/Topic\0227\n\010mess" + + "ages\030\002 \003(\0132\037.google.pubsub.v1.PubsubMess" + + "ageB\004\342A\001\002\",\n\017PublishResponse\022\031\n\013message_" + + "ids\030\001 \003(\tB\004\342A\001\001\"\215\001\n\021ListTopicsRequest\022E\n" + + "\007project\030\001 \001(\tB4\342A\001\002\372A-\n+cloudresourcema" + + "nager.googleapis.com/Project\022\027\n\tpage_siz" + + "e\030\002 \001(\005B\004\342A\001\001\022\030\n\npage_token\030\003 \001(\tB\004\342A\001\001\"" + + "b\n\022ListTopicsResponse\022-\n\006topics\030\001 \003(\0132\027." + + "google.pubsub.v1.TopicB\004\342A\001\001\022\035\n\017next_pag" + + "e_token\030\002 \001(\tB\004\342A\001\001\"\207\001\n\035ListTopicSubscri" + + "ptionsRequest\0223\n\005topic\030\001 \001(\tB$\342A\001\002\372A\035\n\033p" + + "ubsub.googleapis.com/Topic\022\027\n\tpage_size\030" + + "\002 \001(\005B\004\342A\001\001\022\030\n\npage_token\030\003 \001(\tB\004\342A\001\001\"\203\001" + + "\n\036ListTopicSubscriptionsResponse\022B\n\rsubs" + + "criptions\030\001 \003(\tB+\342A\001\001\372A$\n\"pubsub.googlea" + + "pis.com/Subscription\022\035\n\017next_page_token\030" + + "\002 \001(\tB\004\342A\001\001\"\203\001\n\031ListTopicSnapshotsReques" + + "t\0223\n\005topic\030\001 \001(\tB$\342A\001\002\372A\035\n\033pubsub.google" + + "apis.com/Topic\022\027\n\tpage_size\030\002 \001(\005B\004\342A\001\001\022" + + "\030\n\npage_token\030\003 \001(\tB\004\342A\001\001\"T\n\032ListTopicSn" + + "apshotsResponse\022\027\n\tsnapshots\030\001 \003(\tB\004\342A\001\001" + + "\022\035\n\017next_page_token\030\002 \001(\tB\004\342A\001\001\"I\n\022Delet" + + "eTopicRequest\0223\n\005topic\030\001 \001(\tB$\342A\001\002\372A\035\n\033p" + + "ubsub.googleapis.com/Topic\"^\n\031DetachSubs" + + "criptionRequest\022A\n\014subscription\030\001 \001(\tB+\342" + + "A\001\002\372A$\n\"pubsub.googleapis.com/Subscripti" + + "on\"\034\n\032DetachSubscriptionResponse\"\201\t\n\014Sub" + + "scription\022\022\n\004name\030\001 \001(\tB\004\342A\001\002\0223\n\005topic\030\002" + " \001(\tB$\342A\001\002\372A\035\n\033pubsub.googleapis.com/Top" - + "ic\0227\n\010messages\030\002 \003(\0132\037.google.pubsub.v1." - + "PubsubMessageB\004\342A\001\002\"&\n\017PublishResponse\022\023" - + "\n\013message_ids\030\001 \003(\t\"\201\001\n\021ListTopicsReques" - + "t\022E\n\007project\030\001 \001(\tB4\342A\001\002\372A-\n+cloudresour" - + "cemanager.googleapis.com/Project\022\021\n\tpage" - + "_size\030\002 \001(\005\022\022\n\npage_token\030\003 \001(\t\"V\n\022ListT" - + "opicsResponse\022\'\n\006topics\030\001 \003(\0132\027.google.p" - + "ubsub.v1.Topic\022\027\n\017next_page_token\030\002 \001(\t\"" - + "{\n\035ListTopicSubscriptionsRequest\0223\n\005topi" - + "c\030\001 \001(\tB$\342A\001\002\372A\035\n\033pubsub.googleapis.com/" - + "Topic\022\021\n\tpage_size\030\002 \001(\005\022\022\n\npage_token\030\003" - + " \001(\t\"y\n\036ListTopicSubscriptionsResponse\022>" - + "\n\rsubscriptions\030\001 \003(\tB\'\372A$\n\"pubsub.googl" - + "eapis.com/Subscription\022\027\n\017next_page_toke" - + "n\030\002 \001(\t\"w\n\031ListTopicSnapshotsRequest\0223\n\005" - + "topic\030\001 \001(\tB$\342A\001\002\372A\035\n\033pubsub.googleapis." - + "com/Topic\022\021\n\tpage_size\030\002 \001(\005\022\022\n\npage_tok" - + "en\030\003 \001(\t\"H\n\032ListTopicSnapshotsResponse\022\021" - + "\n\tsnapshots\030\001 \003(\t\022\027\n\017next_page_token\030\002 \001" - + "(\t\"I\n\022DeleteTopicRequest\0223\n\005topic\030\001 \001(\tB" - + "$\342A\001\002\372A\035\n\033pubsub.googleapis.com/Topic\"^\n" - + "\031DetachSubscriptionRequest\022A\n\014subscripti" - + "on\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsub.googleapis.com" - + "/Subscription\"\034\n\032DetachSubscriptionRespo" - + "nse\"\255\010\n\014Subscription\022\022\n\004name\030\001 \001(\tB\004\342A\001\002" - + "\0223\n\005topic\030\002 \001(\tB$\342A\001\002\372A\035\n\033pubsub.googlea" - + "pis.com/Topic\0221\n\013push_config\030\004 \001(\0132\034.goo" - + "gle.pubsub.v1.PushConfig\0229\n\017bigquery_con" - + "fig\030\022 \001(\0132 .google.pubsub.v1.BigQueryCon" - + "fig\022B\n\024cloud_storage_config\030\026 \001(\0132$.goog" - + "le.pubsub.v1.CloudStorageConfig\022\034\n\024ack_d" - + "eadline_seconds\030\005 \001(\005\022\035\n\025retain_acked_me" - + "ssages\030\007 \001(\010\022=\n\032message_retention_durati" - + "on\030\010 \001(\0132\031.google.protobuf.Duration\022:\n\006l" - + "abels\030\t \003(\0132*.google.pubsub.v1.Subscript" - + "ion.LabelsEntry\022\037\n\027enable_message_orderi" - + "ng\030\n \001(\010\022=\n\021expiration_policy\030\013 \001(\0132\".go" - + "ogle.pubsub.v1.ExpirationPolicy\022\016\n\006filte" - + "r\030\014 \001(\t\022>\n\022dead_letter_policy\030\r \001(\0132\".go" - + "ogle.pubsub.v1.DeadLetterPolicy\0223\n\014retry" - + "_policy\030\016 \001(\0132\035.google.pubsub.v1.RetryPo" - + "licy\022\020\n\010detached\030\017 \001(\010\022$\n\034enable_exactly" - + "_once_delivery\030\020 \001(\010\022I\n topic_message_re" - + "tention_duration\030\021 \001(\0132\031.google.protobuf" - + ".DurationB\004\342A\001\003\0229\n\005state\030\023 \001(\0162$.google." - + "pubsub.v1.Subscription.StateB\004\342A\001\003\032-\n\013La" - + "belsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028" - + "\001\">\n\005State\022\025\n\021STATE_UNSPECIFIED\020\000\022\n\n\006ACT" - + "IVE\020\001\022\022\n\016RESOURCE_ERROR\020\002:X\352AU\n\"pubsub.g" - + "oogleapis.com/Subscription\022/projects/{pr" - + "oject}/subscriptions/{subscription}\"u\n\013R" - + "etryPolicy\0222\n\017minimum_backoff\030\001 \001(\0132\031.go" - + "ogle.protobuf.Duration\0222\n\017maximum_backof" - + "f\030\002 \001(\0132\031.google.protobuf.Duration\"L\n\020De" - + "adLetterPolicy\022\031\n\021dead_letter_topic\030\001 \001(" - + "\t\022\035\n\025max_delivery_attempts\030\002 \001(\005\":\n\020Expi" - + "rationPolicy\022&\n\003ttl\030\001 \001(\0132\031.google.proto" - + "buf.Duration\"\362\003\n\nPushConfig\022\025\n\rpush_endp" - + "oint\030\001 \001(\t\022@\n\nattributes\030\002 \003(\0132,.google." - + "pubsub.v1.PushConfig.AttributesEntry\022<\n\n" - + "oidc_token\030\003 \001(\0132&.google.pubsub.v1.Push" - + "Config.OidcTokenH\000\022D\n\016pubsub_wrapper\030\004 \001" - + "(\0132*.google.pubsub.v1.PushConfig.PubsubW" - + "rapperH\001\022<\n\nno_wrapper\030\005 \001(\0132&.google.pu" - + "bsub.v1.PushConfig.NoWrapperH\001\032<\n\tOidcTo" - + "ken\022\035\n\025service_account_email\030\001 \001(\t\022\020\n\010au" - + "dience\030\002 \001(\t\032\017\n\rPubsubWrapper\032#\n\tNoWrapp" - + "er\022\026\n\016write_metadata\030\001 \001(\010\0321\n\017Attributes" - + "Entry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001B\027\n" - + "\025authentication_methodB\t\n\007wrapper\"\270\002\n\016Bi" - + "gQueryConfig\022\r\n\005table\030\001 \001(\t\022\036\n\020use_topic" - + "_schema\030\002 \001(\010B\004\342A\001\001\022\026\n\016write_metadata\030\003 " - + "\001(\010\022\033\n\023drop_unknown_fields\030\004 \001(\010\022;\n\005stat" - + "e\030\005 \001(\0162&.google.pubsub.v1.BigQueryConfi" - + "g.StateB\004\342A\001\003\022\036\n\020use_table_schema\030\006 \001(\010B" - + "\004\342A\001\001\"e\n\005State\022\025\n\021STATE_UNSPECIFIED\020\000\022\n\n" - + "\006ACTIVE\020\001\022\025\n\021PERMISSION_DENIED\020\002\022\r\n\tNOT_" - + "FOUND\020\003\022\023\n\017SCHEMA_MISMATCH\020\004\"\210\004\n\022CloudSt" - + "orageConfig\022\024\n\006bucket\030\001 \001(\tB\004\342A\001\002\022\027\n\017fil" - + "ename_prefix\030\002 \001(\t\022\027\n\017filename_suffix\030\003 " - + "\001(\t\022F\n\013text_config\030\004 \001(\0132/.google.pubsub" - + ".v1.CloudStorageConfig.TextConfigH\000\022F\n\013a" - + "vro_config\030\005 \001(\0132/.google.pubsub.v1.Clou" - + "dStorageConfig.AvroConfigH\000\022/\n\014max_durat" - + "ion\030\006 \001(\0132\031.google.protobuf.Duration\022\021\n\t" - + "max_bytes\030\007 \001(\003\022?\n\005state\030\t \001(\0162*.google." - + "pubsub.v1.CloudStorageConfig.StateB\004\342A\001\003" - + "\032\014\n\nTextConfig\032$\n\nAvroConfig\022\026\n\016write_me" - + "tadata\030\001 \001(\010\"P\n\005State\022\025\n\021STATE_UNSPECIFI" - + "ED\020\000\022\n\n\006ACTIVE\020\001\022\025\n\021PERMISSION_DENIED\020\002\022" - + "\r\n\tNOT_FOUND\020\003B\017\n\routput_format\"m\n\017Recei" - + "vedMessage\022\016\n\006ack_id\030\001 \001(\t\0220\n\007message\030\002 " - + "\001(\0132\037.google.pubsub.v1.PubsubMessage\022\030\n\020" - + "delivery_attempt\030\003 \001(\005\"[\n\026GetSubscriptio" - + "nRequest\022A\n\014subscription\030\001 \001(\tB+\342A\001\002\372A$\n" - + "\"pubsub.googleapis.com/Subscription\"\216\001\n\031" - + "UpdateSubscriptionRequest\022:\n\014subscriptio" - + "n\030\001 \001(\0132\036.google.pubsub.v1.SubscriptionB" - + "\004\342A\001\002\0225\n\013update_mask\030\002 \001(\0132\032.google.prot" - + "obuf.FieldMaskB\004\342A\001\002\"\210\001\n\030ListSubscriptio" - + "nsRequest\022E\n\007project\030\001 \001(\tB4\342A\001\002\372A-\n+clo" - + "udresourcemanager.googleapis.com/Project" - + "\022\021\n\tpage_size\030\002 \001(\005\022\022\n\npage_token\030\003 \001(\t\"" - + "k\n\031ListSubscriptionsResponse\0225\n\rsubscrip" - + "tions\030\001 \003(\0132\036.google.pubsub.v1.Subscript" - + "ion\022\027\n\017next_page_token\030\002 \001(\t\"^\n\031DeleteSu" - + "bscriptionRequest\022A\n\014subscription\030\001 \001(\tB" - + "+\342A\001\002\372A$\n\"pubsub.googleapis.com/Subscrip" - + "tion\"\225\001\n\027ModifyPushConfigRequest\022A\n\014subs" - + "cription\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsub.googleap" - + "is.com/Subscription\0227\n\013push_config\030\002 \001(\013" - + "2\034.google.pubsub.v1.PushConfigB\004\342A\001\002\"\220\001\n" - + "\013PullRequest\022A\n\014subscription\030\001 \001(\tB+\342A\001\002" - + "\372A$\n\"pubsub.googleapis.com/Subscription\022" - + "\"\n\022return_immediately\030\002 \001(\010B\006\030\001\342A\001\001\022\032\n\014m" - + "ax_messages\030\003 \001(\005B\004\342A\001\002\"L\n\014PullResponse\022" - + "<\n\021received_messages\030\001 \003(\0132!.google.pubs" - + "ub.v1.ReceivedMessage\"\230\001\n\030ModifyAckDeadl" - + "ineRequest\022A\n\014subscription\030\001 \001(\tB+\342A\001\002\372A" - + "$\n\"pubsub.googleapis.com/Subscription\022\025\n" - + "\007ack_ids\030\004 \003(\tB\004\342A\001\002\022\"\n\024ack_deadline_sec" - + "onds\030\003 \001(\005B\004\342A\001\002\"n\n\022AcknowledgeRequest\022A" - + "\n\014subscription\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsub.go" - + "ogleapis.com/Subscription\022\025\n\007ack_ids\030\002 \003" - + "(\tB\004\342A\001\002\"\253\002\n\024StreamingPullRequest\022A\n\014sub" + + "ic\0227\n\013push_config\030\004 \001(\0132\034.google.pubsub." + + "v1.PushConfigB\004\342A\001\001\022?\n\017bigquery_config\030\022" + + " \001(\0132 .google.pubsub.v1.BigQueryConfigB\004" + + "\342A\001\001\022H\n\024cloud_storage_config\030\026 \001(\0132$.goo" + + "gle.pubsub.v1.CloudStorageConfigB\004\342A\001\001\022\"" + + "\n\024ack_deadline_seconds\030\005 \001(\005B\004\342A\001\001\022#\n\025re" + + "tain_acked_messages\030\007 \001(\010B\004\342A\001\001\022C\n\032messa" + + "ge_retention_duration\030\010 \001(\0132\031.google.pro" + + "tobuf.DurationB\004\342A\001\001\022@\n\006labels\030\t \003(\0132*.g" + + "oogle.pubsub.v1.Subscription.LabelsEntry" + + "B\004\342A\001\001\022%\n\027enable_message_ordering\030\n \001(\010B" + + "\004\342A\001\001\022C\n\021expiration_policy\030\013 \001(\0132\".googl" + + "e.pubsub.v1.ExpirationPolicyB\004\342A\001\001\022\024\n\006fi" + + "lter\030\014 \001(\tB\004\342A\001\001\022D\n\022dead_letter_policy\030\r" + + " \001(\0132\".google.pubsub.v1.DeadLetterPolicy" + + "B\004\342A\001\001\0229\n\014retry_policy\030\016 \001(\0132\035.google.pu" + + "bsub.v1.RetryPolicyB\004\342A\001\001\022\026\n\010detached\030\017 " + + "\001(\010B\004\342A\001\001\022*\n\034enable_exactly_once_deliver" + + "y\030\020 \001(\010B\004\342A\001\001\022I\n topic_message_retention" + + "_duration\030\021 \001(\0132\031.google.protobuf.Durati" + + "onB\004\342A\001\003\0229\n\005state\030\023 \001(\0162$.google.pubsub." + + "v1.Subscription.StateB\004\342A\001\003\032-\n\013LabelsEnt" + + "ry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\">\n\005St" + + "ate\022\025\n\021STATE_UNSPECIFIED\020\000\022\n\n\006ACTIVE\020\001\022\022" + + "\n\016RESOURCE_ERROR\020\002:X\352AU\n\"pubsub.googleap" + + "is.com/Subscription\022/projects/{project}/" + + "subscriptions/{subscription}\"\201\001\n\013RetryPo" + + "licy\0228\n\017minimum_backoff\030\001 \001(\0132\031.google.p" + + "rotobuf.DurationB\004\342A\001\001\0228\n\017maximum_backof" + + "f\030\002 \001(\0132\031.google.protobuf.DurationB\004\342A\001\001" + + "\"X\n\020DeadLetterPolicy\022\037\n\021dead_letter_topi" + + "c\030\001 \001(\tB\004\342A\001\001\022#\n\025max_delivery_attempts\030\002" + + " \001(\005B\004\342A\001\001\"@\n\020ExpirationPolicy\022,\n\003ttl\030\001 " + + "\001(\0132\031.google.protobuf.DurationB\004\342A\001\001\"\242\004\n" + + "\nPushConfig\022\033\n\rpush_endpoint\030\001 \001(\tB\004\342A\001\001" + + "\022F\n\nattributes\030\002 \003(\0132,.google.pubsub.v1." + + "PushConfig.AttributesEntryB\004\342A\001\001\022B\n\noidc" + + "_token\030\003 \001(\0132&.google.pubsub.v1.PushConf" + + "ig.OidcTokenB\004\342A\001\001H\000\022J\n\016pubsub_wrapper\030\004" + + " \001(\0132*.google.pubsub.v1.PushConfig.Pubsu" + + "bWrapperB\004\342A\001\001H\001\022B\n\nno_wrapper\030\005 \001(\0132&.g" + + "oogle.pubsub.v1.PushConfig.NoWrapperB\004\342A" + + "\001\001H\001\032H\n\tOidcToken\022#\n\025service_account_ema" + + "il\030\001 \001(\tB\004\342A\001\001\022\026\n\010audience\030\002 \001(\tB\004\342A\001\001\032\017" + + "\n\rPubsubWrapper\032)\n\tNoWrapper\022\034\n\016write_me" + + "tadata\030\001 \001(\010B\004\342A\001\001\0321\n\017AttributesEntry\022\013\n" + + "\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001B\027\n\025authent" + + "ication_methodB\t\n\007wrapper\"\360\002\n\016BigQueryCo" + + "nfig\022\023\n\005table\030\001 \001(\tB\004\342A\001\001\022\036\n\020use_topic_s" + + "chema\030\002 \001(\010B\004\342A\001\001\022\034\n\016write_metadata\030\003 \001(" + + "\010B\004\342A\001\001\022!\n\023drop_unknown_fields\030\004 \001(\010B\004\342A" + + "\001\001\022;\n\005state\030\005 \001(\0162&.google.pubsub.v1.Big" + + "QueryConfig.StateB\004\342A\001\003\022\036\n\020use_table_sch" + + "ema\030\006 \001(\010B\004\342A\001\001\"\212\001\n\005State\022\025\n\021STATE_UNSPE" + + "CIFIED\020\000\022\n\n\006ACTIVE\020\001\022\025\n\021PERMISSION_DENIE" + + "D\020\002\022\r\n\tNOT_FOUND\020\003\022\023\n\017SCHEMA_MISMATCH\020\004\022" + + "#\n\037IN_TRANSIT_LOCATION_RESTRICTION\020\005\"\327\004\n" + + "\022CloudStorageConfig\022\024\n\006bucket\030\001 \001(\tB\004\342A\001" + + "\002\022\035\n\017filename_prefix\030\002 \001(\tB\004\342A\001\001\022\035\n\017file" + + "name_suffix\030\003 \001(\tB\004\342A\001\001\022L\n\013text_config\030\004" + + " \001(\0132/.google.pubsub.v1.CloudStorageConf" + + "ig.TextConfigB\004\342A\001\001H\000\022L\n\013avro_config\030\005 \001" + + "(\0132/.google.pubsub.v1.CloudStorageConfig" + + ".AvroConfigB\004\342A\001\001H\000\0225\n\014max_duration\030\006 \001(" + + "\0132\031.google.protobuf.DurationB\004\342A\001\001\022\027\n\tma" + + "x_bytes\030\007 \001(\003B\004\342A\001\001\022?\n\005state\030\t \001(\0162*.goo" + + "gle.pubsub.v1.CloudStorageConfig.StateB\004" + + "\342A\001\003\032\014\n\nTextConfig\032*\n\nAvroConfig\022\034\n\016writ" + + "e_metadata\030\001 \001(\010B\004\342A\001\001\"u\n\005State\022\025\n\021STATE" + + "_UNSPECIFIED\020\000\022\n\n\006ACTIVE\020\001\022\025\n\021PERMISSION" + + "_DENIED\020\002\022\r\n\tNOT_FOUND\020\003\022#\n\037IN_TRANSIT_L" + + "OCATION_RESTRICTION\020\004B\017\n\routput_format\"\177" + + "\n\017ReceivedMessage\022\024\n\006ack_id\030\001 \001(\tB\004\342A\001\001\022" + + "6\n\007message\030\002 \001(\0132\037.google.pubsub.v1.Pubs" + + "ubMessageB\004\342A\001\001\022\036\n\020delivery_attempt\030\003 \001(" + + "\005B\004\342A\001\001\"[\n\026GetSubscriptionRequest\022A\n\014sub" + "scription\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsub.googlea" - + "pis.com/Subscription\022\017\n\007ack_ids\030\002 \003(\t\022\037\n" - + "\027modify_deadline_seconds\030\003 \003(\005\022\037\n\027modify" - + "_deadline_ack_ids\030\004 \003(\t\022)\n\033stream_ack_de" - + "adline_seconds\030\005 \001(\005B\004\342A\001\002\022\021\n\tclient_id\030" - + "\006 \001(\t\022 \n\030max_outstanding_messages\030\007 \001(\003\022" - + "\035\n\025max_outstanding_bytes\030\010 \001(\003\"\335\005\n\025Strea" - + "mingPullResponse\022<\n\021received_messages\030\001 " - + "\003(\0132!.google.pubsub.v1.ReceivedMessage\022a" - + "\n\030acknowledge_confirmation\030\005 \001(\0132?.googl" - + "e.pubsub.v1.StreamingPullResponse.Acknow" - + "ledgeConfirmation\022o\n modify_ack_deadline" - + "_confirmation\030\003 \001(\0132E.google.pubsub.v1.S" - + "treamingPullResponse.ModifyAckDeadlineCo" - + "nfirmation\022_\n\027subscription_properties\030\004 " - + "\001(\0132>.google.pubsub.v1.StreamingPullResp" - + "onse.SubscriptionProperties\032\200\001\n\027Acknowle" - + "dgeConfirmation\022\017\n\007ack_ids\030\001 \003(\t\022\027\n\017inva" - + "lid_ack_ids\030\002 \003(\t\022\031\n\021unordered_ack_ids\030\003" - + " \003(\t\022 \n\030temporary_failed_ack_ids\030\004 \003(\t\032k" - + "\n\035ModifyAckDeadlineConfirmation\022\017\n\007ack_i" - + "ds\030\001 \003(\t\022\027\n\017invalid_ack_ids\030\002 \003(\t\022 \n\030tem" - + "porary_failed_ack_ids\030\003 \003(\t\032a\n\026Subscript" - + "ionProperties\022%\n\035exactly_once_delivery_e" - + "nabled\030\001 \001(\010\022 \n\030message_ordering_enabled" - + "\030\002 \001(\010\"\205\002\n\025CreateSnapshotRequest\0225\n\004name" + + "pis.com/Subscription\"\216\001\n\031UpdateSubscript" + + "ionRequest\022:\n\014subscription\030\001 \001(\0132\036.googl" + + "e.pubsub.v1.SubscriptionB\004\342A\001\002\0225\n\013update" + + "_mask\030\002 \001(\0132\032.google.protobuf.FieldMaskB" + + "\004\342A\001\002\"\224\001\n\030ListSubscriptionsRequest\022E\n\007pr" + + "oject\030\001 \001(\tB4\342A\001\002\372A-\n+cloudresourcemanag" + + "er.googleapis.com/Project\022\027\n\tpage_size\030\002" + + " \001(\005B\004\342A\001\001\022\030\n\npage_token\030\003 \001(\tB\004\342A\001\001\"w\n\031" + + "ListSubscriptionsResponse\022;\n\rsubscriptio" + + "ns\030\001 \003(\0132\036.google.pubsub.v1.Subscription" + + "B\004\342A\001\001\022\035\n\017next_page_token\030\002 \001(\tB\004\342A\001\001\"^\n" + + "\031DeleteSubscriptionRequest\022A\n\014subscripti" + + "on\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsub.googleapis.com" + + "/Subscription\"\225\001\n\027ModifyPushConfigReques" + + "t\022A\n\014subscription\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsub" + + ".googleapis.com/Subscription\0227\n\013push_con" + + "fig\030\002 \001(\0132\034.google.pubsub.v1.PushConfigB" + + "\004\342A\001\002\"\220\001\n\013PullRequest\022A\n\014subscription\030\001 " + + "\001(\tB+\342A\001\002\372A$\n\"pubsub.googleapis.com/Subs" + + "cription\022\"\n\022return_immediately\030\002 \001(\010B\006\030\001" + + "\342A\001\001\022\032\n\014max_messages\030\003 \001(\005B\004\342A\001\002\"R\n\014Pull" + + "Response\022B\n\021received_messages\030\001 \003(\0132!.go" + + "ogle.pubsub.v1.ReceivedMessageB\004\342A\001\001\"\230\001\n" + + "\030ModifyAckDeadlineRequest\022A\n\014subscriptio" + + "n\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsub.googleapis.com/" + + "Subscription\022\025\n\007ack_ids\030\004 \003(\tB\004\342A\001\002\022\"\n\024a" + + "ck_deadline_seconds\030\003 \001(\005B\004\342A\001\002\"n\n\022Ackno" + + "wledgeRequest\022A\n\014subscription\030\001 \001(\tB+\342A\001" + + "\002\372A$\n\"pubsub.googleapis.com/Subscription" + + "\022\025\n\007ack_ids\030\002 \003(\tB\004\342A\001\002\"\317\002\n\024StreamingPul" + + "lRequest\022A\n\014subscription\030\001 \001(\tB+\342A\001\002\372A$\n" + + "\"pubsub.googleapis.com/Subscription\022\025\n\007a" + + "ck_ids\030\002 \003(\tB\004\342A\001\001\022%\n\027modify_deadline_se" + + "conds\030\003 \003(\005B\004\342A\001\001\022%\n\027modify_deadline_ack" + + "_ids\030\004 \003(\tB\004\342A\001\001\022)\n\033stream_ack_deadline_" + + "seconds\030\005 \001(\005B\004\342A\001\002\022\027\n\tclient_id\030\006 \001(\tB\004" + + "\342A\001\001\022&\n\030max_outstanding_messages\030\007 \001(\003B\004" + + "\342A\001\001\022#\n\025max_outstanding_bytes\030\010 \001(\003B\004\342A\001" + + "\001\"\253\006\n\025StreamingPullResponse\022B\n\021received_" + + "messages\030\001 \003(\0132!.google.pubsub.v1.Receiv" + + "edMessageB\004\342A\001\001\022g\n\030acknowledge_confirmat" + + "ion\030\005 \001(\0132?.google.pubsub.v1.StreamingPu" + + "llResponse.AcknowledgeConfirmationB\004\342A\001\001" + + "\022u\n modify_ack_deadline_confirmation\030\003 \001" + + "(\0132E.google.pubsub.v1.StreamingPullRespo" + + "nse.ModifyAckDeadlineConfirmationB\004\342A\001\001\022" + + "e\n\027subscription_properties\030\004 \001(\0132>.googl" + + "e.pubsub.v1.StreamingPullResponse.Subscr" + + "iptionPropertiesB\004\342A\001\001\032\230\001\n\027AcknowledgeCo" + + "nfirmation\022\025\n\007ack_ids\030\001 \003(\tB\004\342A\001\001\022\035\n\017inv" + + "alid_ack_ids\030\002 \003(\tB\004\342A\001\001\022\037\n\021unordered_ac" + + "k_ids\030\003 \003(\tB\004\342A\001\001\022&\n\030temporary_failed_ac" + + "k_ids\030\004 \003(\tB\004\342A\001\001\032}\n\035ModifyAckDeadlineCo" + + "nfirmation\022\025\n\007ack_ids\030\001 \003(\tB\004\342A\001\001\022\035\n\017inv" + + "alid_ack_ids\030\002 \003(\tB\004\342A\001\001\022&\n\030temporary_fa" + + "iled_ack_ids\030\003 \003(\tB\004\342A\001\001\032m\n\026Subscription" + + "Properties\022+\n\035exactly_once_delivery_enab" + + "led\030\001 \001(\010B\004\342A\001\001\022&\n\030message_ordering_enab" + + "led\030\002 \001(\010B\004\342A\001\001\"\213\002\n\025CreateSnapshotReques" + + "t\0225\n\004name\030\001 \001(\tB\'\342A\001\002\372A \n\036pubsub.googlea" + + "pis.com/Snapshot\022A\n\014subscription\030\002 \001(\tB+" + + "\342A\001\002\372A$\n\"pubsub.googleapis.com/Subscript" + + "ion\022I\n\006labels\030\003 \003(\01323.google.pubsub.v1.C" + + "reateSnapshotRequest.LabelsEntryB\004\342A\001\001\032-" + + "\n\013LabelsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(" + + "\t:\0028\001\"\202\001\n\025UpdateSnapshotRequest\0222\n\010snaps" + + "hot\030\001 \001(\0132\032.google.pubsub.v1.SnapshotB\004\342" + + "A\001\002\0225\n\013update_mask\030\002 \001(\0132\032.google.protob" + + "uf.FieldMaskB\004\342A\001\002\"\305\002\n\010Snapshot\022\022\n\004name\030" + + "\001 \001(\tB\004\342A\001\001\0223\n\005topic\030\002 \001(\tB$\342A\001\001\372A\035\n\033pub" + + "sub.googleapis.com/Topic\0225\n\013expire_time\030" + + "\003 \001(\0132\032.google.protobuf.TimestampB\004\342A\001\001\022" + + "<\n\006labels\030\004 \003(\0132&.google.pubsub.v1.Snaps" + + "hot.LabelsEntryB\004\342A\001\001\032-\n\013LabelsEntry\022\013\n\003" + + "key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001:L\352AI\n\036pubsu" + + "b.googleapis.com/Snapshot\022\'projects/{pro" + + "ject}/snapshots/{snapshot}\"O\n\022GetSnapsho" + + "tRequest\0229\n\010snapshot\030\001 \001(\tB\'\342A\001\002\372A \n\036pub" + + "sub.googleapis.com/Snapshot\"\220\001\n\024ListSnap" + + "shotsRequest\022E\n\007project\030\001 \001(\tB4\342A\001\002\372A-\n+" + + "cloudresourcemanager.googleapis.com/Proj" + + "ect\022\027\n\tpage_size\030\002 \001(\005B\004\342A\001\001\022\030\n\npage_tok" + + "en\030\003 \001(\tB\004\342A\001\001\"k\n\025ListSnapshotsResponse\022" + + "3\n\tsnapshots\030\001 \003(\0132\032.google.pubsub.v1.Sn" + + "apshotB\004\342A\001\001\022\035\n\017next_page_token\030\002 \001(\tB\004\342" + + "A\001\001\"R\n\025DeleteSnapshotRequest\0229\n\010snapshot" + "\030\001 \001(\tB\'\342A\001\002\372A \n\036pubsub.googleapis.com/S" - + "napshot\022A\n\014subscription\030\002 \001(\tB+\342A\001\002\372A$\n\"" - + "pubsub.googleapis.com/Subscription\022C\n\006la" - + "bels\030\003 \003(\01323.google.pubsub.v1.CreateSnap" - + "shotRequest.LabelsEntry\032-\n\013LabelsEntry\022\013" - + "\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\202\001\n\025Updat" - + "eSnapshotRequest\0222\n\010snapshot\030\001 \001(\0132\032.goo" - + "gle.pubsub.v1.SnapshotB\004\342A\001\002\0225\n\013update_m" - + "ask\030\002 \001(\0132\032.google.protobuf.FieldMaskB\004\342" - + "A\001\002\"\257\002\n\010Snapshot\022\014\n\004name\030\001 \001(\t\022/\n\005topic\030" - + "\002 \001(\tB \372A\035\n\033pubsub.googleapis.com/Topic\022" - + "/\n\013expire_time\030\003 \001(\0132\032.google.protobuf.T" - + "imestamp\0226\n\006labels\030\004 \003(\0132&.google.pubsub" - + ".v1.Snapshot.LabelsEntry\032-\n\013LabelsEntry\022" - + "\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001:L\352AI\n\036pu" - + "bsub.googleapis.com/Snapshot\022\'projects/{" - + "project}/snapshots/{snapshot}\"O\n\022GetSnap" - + "shotRequest\0229\n\010snapshot\030\001 \001(\tB\'\342A\001\002\372A \n\036" - + "pubsub.googleapis.com/Snapshot\"\204\001\n\024ListS" - + "napshotsRequest\022E\n\007project\030\001 \001(\tB4\342A\001\002\372A" - + "-\n+cloudresourcemanager.googleapis.com/P" - + "roject\022\021\n\tpage_size\030\002 \001(\005\022\022\n\npage_token\030" - + "\003 \001(\t\"_\n\025ListSnapshotsResponse\022-\n\tsnapsh" - + "ots\030\001 \003(\0132\032.google.pubsub.v1.Snapshot\022\027\n" - + "\017next_page_token\030\002 \001(\t\"R\n\025DeleteSnapshot" - + "Request\0229\n\010snapshot\030\001 \001(\tB\'\342A\001\002\372A \n\036pubs" - + "ub.googleapis.com/Snapshot\"\277\001\n\013SeekReque" - + "st\022A\n\014subscription\030\001 \001(\tB+\342A\001\002\372A$\n\"pubsu" - + "b.googleapis.com/Subscription\022*\n\004time\030\002 " - + "\001(\0132\032.google.protobuf.TimestampH\000\0227\n\010sna" - + "pshot\030\003 \001(\tB#\372A \n\036pubsub.googleapis.com/" - + "SnapshotH\000B\010\n\006target\"\016\n\014SeekResponse2\270\013\n" - + "\tPublisher\022q\n\013CreateTopic\022\027.google.pubsu" - + "b.v1.Topic\032\027.google.pubsub.v1.Topic\"0\332A\004" - + "name\202\323\344\223\002#\032\036/v1/{name=projects/*/topics/" - + "*}:\001*\022\221\001\n\013UpdateTopic\022$.google.pubsub.v1" - + ".UpdateTopicRequest\032\027.google.pubsub.v1.T" - + "opic\"C\332A\021topic,update_mask\202\323\344\223\002)2$/v1/{t" - + "opic.name=projects/*/topics/*}:\001*\022\223\001\n\007Pu" - + "blish\022 .google.pubsub.v1.PublishRequest\032" - + "!.google.pubsub.v1.PublishResponse\"C\332A\016t" - + "opic,messages\202\323\344\223\002,\"\'/v1/{topic=projects" - + "/*/topics/*}:publish:\001*\022w\n\010GetTopic\022!.go" - + "ogle.pubsub.v1.GetTopicRequest\032\027.google." - + "pubsub.v1.Topic\"/\332A\005topic\202\323\344\223\002!\022\037/v1/{to" - + "pic=projects/*/topics/*}\022\212\001\n\nListTopics\022" - + "#.google.pubsub.v1.ListTopicsRequest\032$.g" - + "oogle.pubsub.v1.ListTopicsResponse\"1\332A\007p" - + "roject\202\323\344\223\002!\022\037/v1/{project=projects/*}/t" - + "opics\022\272\001\n\026ListTopicSubscriptions\022/.googl" - + "e.pubsub.v1.ListTopicSubscriptionsReques" - + "t\0320.google.pubsub.v1.ListTopicSubscripti" - + "onsResponse\"=\332A\005topic\202\323\344\223\002/\022-/v1/{topic=" - + "projects/*/topics/*}/subscriptions\022\252\001\n\022L" - + "istTopicSnapshots\022+.google.pubsub.v1.Lis" - + "tTopicSnapshotsRequest\032,.google.pubsub.v" - + "1.ListTopicSnapshotsResponse\"9\332A\005topic\202\323" - + "\344\223\002+\022)/v1/{topic=projects/*/topics/*}/sn" - + "apshots\022|\n\013DeleteTopic\022$.google.pubsub.v" - + "1.DeleteTopicRequest\032\026.google.protobuf.E" - + "mpty\"/\332A\005topic\202\323\344\223\002!*\037/v1/{topic=project" - + "s/*/topics/*}\022\255\001\n\022DetachSubscription\022+.g" - + "oogle.pubsub.v1.DetachSubscriptionReques" - + "t\032,.google.pubsub.v1.DetachSubscriptionR" - + "esponse\"<\202\323\344\223\0026\"4/v1/{subscription=proje" - + "cts/*/subscriptions/*}:detach\032p\312A\025pubsub" - + ".googleapis.com\322AUhttps://www.googleapis" - + ".com/auth/cloud-platform,https://www.goo" - + "gleapis.com/auth/pubsub2\322\025\n\nSubscriber\022\264" - + "\001\n\022CreateSubscription\022\036.google.pubsub.v1" - + ".Subscription\032\036.google.pubsub.v1.Subscri" - + "ption\"^\332A+name,topic,push_config,ack_dea" - + "dline_seconds\202\323\344\223\002*\032%/v1/{name=projects/" - + "*/subscriptions/*}:\001*\022\241\001\n\017GetSubscriptio" - + "n\022(.google.pubsub.v1.GetSubscriptionRequ" - + "est\032\036.google.pubsub.v1.Subscription\"D\332A\014" - + "subscription\202\323\344\223\002/\022-/v1/{subscription=pr" - + "ojects/*/subscriptions/*}\022\273\001\n\022UpdateSubs" - + "cription\022+.google.pubsub.v1.UpdateSubscr" - + "iptionRequest\032\036.google.pubsub.v1.Subscri" - + "ption\"X\332A\030subscription,update_mask\202\323\344\223\0027" - + "22/v1/{subscription.name=projects/*/subs" - + "criptions/*}:\001*\022\246\001\n\021ListSubscriptions\022*." - + "google.pubsub.v1.ListSubscriptionsReques" - + "t\032+.google.pubsub.v1.ListSubscriptionsRe" - + "sponse\"8\332A\007project\202\323\344\223\002(\022&/v1/{project=p" - + "rojects/*}/subscriptions\022\237\001\n\022DeleteSubsc" - + "ription\022+.google.pubsub.v1.DeleteSubscri" - + "ptionRequest\032\026.google.protobuf.Empty\"D\332A" - + "\014subscription\202\323\344\223\002/*-/v1/{subscription=p" - + "rojects/*/subscriptions/*}\022\317\001\n\021ModifyAck" - + "Deadline\022*.google.pubsub.v1.ModifyAckDea" - + "dlineRequest\032\026.google.protobuf.Empty\"v\332A" - + ")subscription,ack_ids,ack_deadline_secon" - + "ds\202\323\344\223\002D\"?/v1/{subscription=projects/*/s" - + "ubscriptions/*}:modifyAckDeadline:\001*\022\250\001\n" - + "\013Acknowledge\022$.google.pubsub.v1.Acknowle" - + "dgeRequest\032\026.google.protobuf.Empty\"[\332A\024s" - + "ubscription,ack_ids\202\323\344\223\002>\"9/v1/{subscrip" - + "tion=projects/*/subscriptions/*}:acknowl" - + "edge:\001*\022\320\001\n\004Pull\022\035.google.pubsub.v1.Pull" - + "Request\032\036.google.pubsub.v1.PullResponse\"" - + "\210\001\332A,subscription,return_immediately,max" - + "_messages\332A\031subscription,max_messages\202\323\344" - + "\223\0027\"2/v1/{subscription=projects/*/subscr" - + "iptions/*}:pull:\001*\022f\n\rStreamingPull\022&.go" - + "ogle.pubsub.v1.StreamingPullRequest\032\'.go" - + "ogle.pubsub.v1.StreamingPullResponse\"\000(\001" - + "0\001\022\273\001\n\020ModifyPushConfig\022).google.pubsub." - + "v1.ModifyPushConfigRequest\032\026.google.prot" - + "obuf.Empty\"d\332A\030subscription,push_config\202" - + "\323\344\223\002C\">/v1/{subscription=projects/*/subs" - + "criptions/*}:modifyPushConfig:\001*\022\211\001\n\013Get" - + "Snapshot\022$.google.pubsub.v1.GetSnapshotR" - + "equest\032\032.google.pubsub.v1.Snapshot\"8\332A\010s" - + "napshot\202\323\344\223\002\'\022%/v1/{snapshot=projects/*/" - + "snapshots/*}\022\226\001\n\rListSnapshots\022&.google." - + "pubsub.v1.ListSnapshotsRequest\032\'.google." - + "pubsub.v1.ListSnapshotsResponse\"4\332A\007proj" - + "ect\202\323\344\223\002$\022\"/v1/{project=projects/*}/snap" - + "shots\022\227\001\n\016CreateSnapshot\022\'.google.pubsub" - + ".v1.CreateSnapshotRequest\032\032.google.pubsu" - + "b.v1.Snapshot\"@\332A\021name,subscription\202\323\344\223\002" - + "&\032!/v1/{name=projects/*/snapshots/*}:\001*\022" - + "\243\001\n\016UpdateSnapshot\022\'.google.pubsub.v1.Up" - + "dateSnapshotRequest\032\032.google.pubsub.v1.S" - + "napshot\"L\332A\024snapshot,update_mask\202\323\344\223\002/2*" - + "/v1/{snapshot.name=projects/*/snapshots/" - + "*}:\001*\022\213\001\n\016DeleteSnapshot\022\'.google.pubsub" - + ".v1.DeleteSnapshotRequest\032\026.google.proto" - + "buf.Empty\"8\332A\010snapshot\202\323\344\223\002\'*%/v1/{snaps" - + "hot=projects/*/snapshots/*}\022\204\001\n\004Seek\022\035.g" - + "oogle.pubsub.v1.SeekRequest\032\036.google.pub" - + "sub.v1.SeekResponse\"=\202\323\344\223\0027\"2/v1/{subscr" - + "iption=projects/*/subscriptions/*}:seek:" - + "\001*\032p\312A\025pubsub.googleapis.com\322AUhttps://w" - + "ww.googleapis.com/auth/cloud-platform,ht" - + "tps://www.googleapis.com/auth/pubsubB\252\001\n" - + "\024com.google.pubsub.v1B\013PubsubProtoP\001Z2cl" - + "oud.google.com/go/pubsub/apiv1/pubsubpb;" - + "pubsubpb\370\001\001\252\002\026Google.Cloud.PubSub.V1\312\002\026G" - + "oogle\\Cloud\\PubSub\\V1\352\002\031Google::Cloud::P" - + "ubSub::V1b\006proto3" + + "napshot\"\311\001\n\013SeekRequest\022A\n\014subscription\030" + + "\001 \001(\tB+\342A\001\002\372A$\n\"pubsub.googleapis.com/Su" + + "bscription\0220\n\004time\030\002 \001(\0132\032.google.protob" + + "uf.TimestampB\004\342A\001\001H\000\022;\n\010snapshot\030\003 \001(\tB\'" + + "\342A\001\001\372A \n\036pubsub.googleapis.com/SnapshotH" + + "\000B\010\n\006target\"\016\n\014SeekResponse2\270\013\n\tPublishe" + + "r\022q\n\013CreateTopic\022\027.google.pubsub.v1.Topi" + + "c\032\027.google.pubsub.v1.Topic\"0\332A\004name\202\323\344\223\002" + + "#\032\036/v1/{name=projects/*/topics/*}:\001*\022\221\001\n" + + "\013UpdateTopic\022$.google.pubsub.v1.UpdateTo" + + "picRequest\032\027.google.pubsub.v1.Topic\"C\332A\021" + + "topic,update_mask\202\323\344\223\002)2$/v1/{topic.name" + + "=projects/*/topics/*}:\001*\022\223\001\n\007Publish\022 .g" + + "oogle.pubsub.v1.PublishRequest\032!.google." + + "pubsub.v1.PublishResponse\"C\332A\016topic,mess" + + "ages\202\323\344\223\002,\"\'/v1/{topic=projects/*/topics" + + "/*}:publish:\001*\022w\n\010GetTopic\022!.google.pubs" + + "ub.v1.GetTopicRequest\032\027.google.pubsub.v1" + + ".Topic\"/\332A\005topic\202\323\344\223\002!\022\037/v1/{topic=proje" + + "cts/*/topics/*}\022\212\001\n\nListTopics\022#.google." + + "pubsub.v1.ListTopicsRequest\032$.google.pub" + + "sub.v1.ListTopicsResponse\"1\332A\007project\202\323\344" + + "\223\002!\022\037/v1/{project=projects/*}/topics\022\272\001\n" + + "\026ListTopicSubscriptions\022/.google.pubsub." + + "v1.ListTopicSubscriptionsRequest\0320.googl" + + "e.pubsub.v1.ListTopicSubscriptionsRespon" + + "se\"=\332A\005topic\202\323\344\223\002/\022-/v1/{topic=projects/" + + "*/topics/*}/subscriptions\022\252\001\n\022ListTopicS" + + "napshots\022+.google.pubsub.v1.ListTopicSna" + + "pshotsRequest\032,.google.pubsub.v1.ListTop" + + "icSnapshotsResponse\"9\332A\005topic\202\323\344\223\002+\022)/v1" + + "/{topic=projects/*/topics/*}/snapshots\022|" + + "\n\013DeleteTopic\022$.google.pubsub.v1.DeleteT" + + "opicRequest\032\026.google.protobuf.Empty\"/\332A\005" + + "topic\202\323\344\223\002!*\037/v1/{topic=projects/*/topic" + + "s/*}\022\255\001\n\022DetachSubscription\022+.google.pub" + + "sub.v1.DetachSubscriptionRequest\032,.googl" + + "e.pubsub.v1.DetachSubscriptionResponse\"<" + + "\202\323\344\223\0026\"4/v1/{subscription=projects/*/sub" + + "scriptions/*}:detach\032p\312A\025pubsub.googleap" + + "is.com\322AUhttps://www.googleapis.com/auth" + + "/cloud-platform,https://www.googleapis.c" + + "om/auth/pubsub2\322\025\n\nSubscriber\022\264\001\n\022Create" + + "Subscription\022\036.google.pubsub.v1.Subscrip" + + "tion\032\036.google.pubsub.v1.Subscription\"^\332A" + + "+name,topic,push_config,ack_deadline_sec" + + "onds\202\323\344\223\002*\032%/v1/{name=projects/*/subscri" + + "ptions/*}:\001*\022\241\001\n\017GetSubscription\022(.googl" + + "e.pubsub.v1.GetSubscriptionRequest\032\036.goo" + + "gle.pubsub.v1.Subscription\"D\332A\014subscript" + + "ion\202\323\344\223\002/\022-/v1/{subscription=projects/*/" + + "subscriptions/*}\022\273\001\n\022UpdateSubscription\022" + + "+.google.pubsub.v1.UpdateSubscriptionReq" + + "uest\032\036.google.pubsub.v1.Subscription\"X\332A" + + "\030subscription,update_mask\202\323\344\223\002722/v1/{su" + + "bscription.name=projects/*/subscriptions" + + "/*}:\001*\022\246\001\n\021ListSubscriptions\022*.google.pu" + + "bsub.v1.ListSubscriptionsRequest\032+.googl" + + "e.pubsub.v1.ListSubscriptionsResponse\"8\332" + + "A\007project\202\323\344\223\002(\022&/v1/{project=projects/*" + + "}/subscriptions\022\237\001\n\022DeleteSubscription\022+" + + ".google.pubsub.v1.DeleteSubscriptionRequ" + + "est\032\026.google.protobuf.Empty\"D\332A\014subscrip" + + "tion\202\323\344\223\002/*-/v1/{subscription=projects/*" + + "/subscriptions/*}\022\317\001\n\021ModifyAckDeadline\022" + + "*.google.pubsub.v1.ModifyAckDeadlineRequ" + + "est\032\026.google.protobuf.Empty\"v\332A)subscrip" + + "tion,ack_ids,ack_deadline_seconds\202\323\344\223\002D\"" + + "?/v1/{subscription=projects/*/subscripti" + + "ons/*}:modifyAckDeadline:\001*\022\250\001\n\013Acknowle" + + "dge\022$.google.pubsub.v1.AcknowledgeReques" + + "t\032\026.google.protobuf.Empty\"[\332A\024subscripti" + + "on,ack_ids\202\323\344\223\002>\"9/v1/{subscription=proj" + + "ects/*/subscriptions/*}:acknowledge:\001*\022\320" + + "\001\n\004Pull\022\035.google.pubsub.v1.PullRequest\032\036" + + ".google.pubsub.v1.PullResponse\"\210\001\332A,subs" + + "cription,return_immediately,max_messages" + + "\332A\031subscription,max_messages\202\323\344\223\0027\"2/v1/" + + "{subscription=projects/*/subscriptions/*" + + "}:pull:\001*\022f\n\rStreamingPull\022&.google.pubs" + + "ub.v1.StreamingPullRequest\032\'.google.pubs" + + "ub.v1.StreamingPullResponse\"\000(\0010\001\022\273\001\n\020Mo" + + "difyPushConfig\022).google.pubsub.v1.Modify" + + "PushConfigRequest\032\026.google.protobuf.Empt" + + "y\"d\332A\030subscription,push_config\202\323\344\223\002C\">/v" + + "1/{subscription=projects/*/subscriptions" + + "/*}:modifyPushConfig:\001*\022\211\001\n\013GetSnapshot\022" + + "$.google.pubsub.v1.GetSnapshotRequest\032\032." + + "google.pubsub.v1.Snapshot\"8\332A\010snapshot\202\323" + + "\344\223\002\'\022%/v1/{snapshot=projects/*/snapshots" + + "/*}\022\226\001\n\rListSnapshots\022&.google.pubsub.v1" + + ".ListSnapshotsRequest\032\'.google.pubsub.v1" + + ".ListSnapshotsResponse\"4\332A\007project\202\323\344\223\002$" + + "\022\"/v1/{project=projects/*}/snapshots\022\227\001\n" + + "\016CreateSnapshot\022\'.google.pubsub.v1.Creat" + + "eSnapshotRequest\032\032.google.pubsub.v1.Snap" + + "shot\"@\332A\021name,subscription\202\323\344\223\002&\032!/v1/{n" + + "ame=projects/*/snapshots/*}:\001*\022\243\001\n\016Updat" + + "eSnapshot\022\'.google.pubsub.v1.UpdateSnaps" + + "hotRequest\032\032.google.pubsub.v1.Snapshot\"L" + + "\332A\024snapshot,update_mask\202\323\344\223\002/2*/v1/{snap" + + "shot.name=projects/*/snapshots/*}:\001*\022\213\001\n" + + "\016DeleteSnapshot\022\'.google.pubsub.v1.Delet" + + "eSnapshotRequest\032\026.google.protobuf.Empty" + + "\"8\332A\010snapshot\202\323\344\223\002\'*%/v1/{snapshot=proje" + + "cts/*/snapshots/*}\022\204\001\n\004Seek\022\035.google.pub" + + "sub.v1.SeekRequest\032\036.google.pubsub.v1.Se" + + "ekResponse\"=\202\323\344\223\0027\"2/v1/{subscription=pr" + + "ojects/*/subscriptions/*}:seek:\001*\032p\312A\025pu" + + "bsub.googleapis.com\322AUhttps://www.google" + + "apis.com/auth/cloud-platform,https://www" + + ".googleapis.com/auth/pubsubB\252\001\n\024com.goog" + + "le.pubsub.v1B\013PubsubProtoP\001Z2cloud.googl" + + "e.com/go/pubsub/apiv1/pubsubpb;pubsubpb\370" + + "\001\001\252\002\026Google.Cloud.PubSub.V1\312\002\026Google\\Clo" + + "ud\\PubSub\\V1\352\002\031Google::Cloud::PubSub::V1" + + "b\006proto3" }; descriptor = com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom( @@ -629,7 +673,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_MessageStoragePolicy_descriptor, new java.lang.String[] { - "AllowedPersistenceRegions", + "AllowedPersistenceRegions", "EnforceInTransit", }); internal_static_google_pubsub_v1_SchemaSettings_descriptor = getDescriptor().getMessageTypes().get(1); @@ -639,7 +683,25 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { new java.lang.String[] { "Schema", "Encoding", "FirstRevisionId", "LastRevisionId", }); - internal_static_google_pubsub_v1_Topic_descriptor = getDescriptor().getMessageTypes().get(2); + internal_static_google_pubsub_v1_IngestionDataSourceSettings_descriptor = + getDescriptor().getMessageTypes().get(2); + internal_static_google_pubsub_v1_IngestionDataSourceSettings_fieldAccessorTable = + new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( + internal_static_google_pubsub_v1_IngestionDataSourceSettings_descriptor, + new java.lang.String[] { + "AwsKinesis", "Source", + }); + internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_descriptor = + internal_static_google_pubsub_v1_IngestionDataSourceSettings_descriptor + .getNestedTypes() + .get(0); + internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_fieldAccessorTable = + new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( + internal_static_google_pubsub_v1_IngestionDataSourceSettings_AwsKinesis_descriptor, + new java.lang.String[] { + "State", "StreamArn", "ConsumerArn", "AwsRoleArn", "GcpServiceAccount", + }); + internal_static_google_pubsub_v1_Topic_descriptor = getDescriptor().getMessageTypes().get(3); internal_static_google_pubsub_v1_Topic_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_Topic_descriptor, @@ -651,6 +713,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "SchemaSettings", "SatisfiesPzs", "MessageRetentionDuration", + "State", + "IngestionDataSourceSettings", }); internal_static_google_pubsub_v1_Topic_LabelsEntry_descriptor = internal_static_google_pubsub_v1_Topic_descriptor.getNestedTypes().get(0); @@ -661,7 +725,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Key", "Value", }); internal_static_google_pubsub_v1_PubsubMessage_descriptor = - getDescriptor().getMessageTypes().get(3); + getDescriptor().getMessageTypes().get(4); internal_static_google_pubsub_v1_PubsubMessage_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_PubsubMessage_descriptor, @@ -677,7 +741,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Key", "Value", }); internal_static_google_pubsub_v1_GetTopicRequest_descriptor = - getDescriptor().getMessageTypes().get(4); + getDescriptor().getMessageTypes().get(5); internal_static_google_pubsub_v1_GetTopicRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_GetTopicRequest_descriptor, @@ -685,7 +749,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Topic", }); internal_static_google_pubsub_v1_UpdateTopicRequest_descriptor = - getDescriptor().getMessageTypes().get(5); + getDescriptor().getMessageTypes().get(6); internal_static_google_pubsub_v1_UpdateTopicRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_UpdateTopicRequest_descriptor, @@ -693,7 +757,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Topic", "UpdateMask", }); internal_static_google_pubsub_v1_PublishRequest_descriptor = - getDescriptor().getMessageTypes().get(6); + getDescriptor().getMessageTypes().get(7); internal_static_google_pubsub_v1_PublishRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_PublishRequest_descriptor, @@ -701,7 +765,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Topic", "Messages", }); internal_static_google_pubsub_v1_PublishResponse_descriptor = - getDescriptor().getMessageTypes().get(7); + getDescriptor().getMessageTypes().get(8); internal_static_google_pubsub_v1_PublishResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_PublishResponse_descriptor, @@ -709,7 +773,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "MessageIds", }); internal_static_google_pubsub_v1_ListTopicsRequest_descriptor = - getDescriptor().getMessageTypes().get(8); + getDescriptor().getMessageTypes().get(9); internal_static_google_pubsub_v1_ListTopicsRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListTopicsRequest_descriptor, @@ -717,7 +781,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Project", "PageSize", "PageToken", }); internal_static_google_pubsub_v1_ListTopicsResponse_descriptor = - getDescriptor().getMessageTypes().get(9); + getDescriptor().getMessageTypes().get(10); internal_static_google_pubsub_v1_ListTopicsResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListTopicsResponse_descriptor, @@ -725,7 +789,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Topics", "NextPageToken", }); internal_static_google_pubsub_v1_ListTopicSubscriptionsRequest_descriptor = - getDescriptor().getMessageTypes().get(10); + getDescriptor().getMessageTypes().get(11); internal_static_google_pubsub_v1_ListTopicSubscriptionsRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListTopicSubscriptionsRequest_descriptor, @@ -733,7 +797,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Topic", "PageSize", "PageToken", }); internal_static_google_pubsub_v1_ListTopicSubscriptionsResponse_descriptor = - getDescriptor().getMessageTypes().get(11); + getDescriptor().getMessageTypes().get(12); internal_static_google_pubsub_v1_ListTopicSubscriptionsResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListTopicSubscriptionsResponse_descriptor, @@ -741,7 +805,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscriptions", "NextPageToken", }); internal_static_google_pubsub_v1_ListTopicSnapshotsRequest_descriptor = - getDescriptor().getMessageTypes().get(12); + getDescriptor().getMessageTypes().get(13); internal_static_google_pubsub_v1_ListTopicSnapshotsRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListTopicSnapshotsRequest_descriptor, @@ -749,7 +813,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Topic", "PageSize", "PageToken", }); internal_static_google_pubsub_v1_ListTopicSnapshotsResponse_descriptor = - getDescriptor().getMessageTypes().get(13); + getDescriptor().getMessageTypes().get(14); internal_static_google_pubsub_v1_ListTopicSnapshotsResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListTopicSnapshotsResponse_descriptor, @@ -757,7 +821,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Snapshots", "NextPageToken", }); internal_static_google_pubsub_v1_DeleteTopicRequest_descriptor = - getDescriptor().getMessageTypes().get(14); + getDescriptor().getMessageTypes().get(15); internal_static_google_pubsub_v1_DeleteTopicRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_DeleteTopicRequest_descriptor, @@ -765,7 +829,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Topic", }); internal_static_google_pubsub_v1_DetachSubscriptionRequest_descriptor = - getDescriptor().getMessageTypes().get(15); + getDescriptor().getMessageTypes().get(16); internal_static_google_pubsub_v1_DetachSubscriptionRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_DetachSubscriptionRequest_descriptor, @@ -773,13 +837,13 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", }); internal_static_google_pubsub_v1_DetachSubscriptionResponse_descriptor = - getDescriptor().getMessageTypes().get(16); + getDescriptor().getMessageTypes().get(17); internal_static_google_pubsub_v1_DetachSubscriptionResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_DetachSubscriptionResponse_descriptor, new java.lang.String[] {}); internal_static_google_pubsub_v1_Subscription_descriptor = - getDescriptor().getMessageTypes().get(17); + getDescriptor().getMessageTypes().get(18); internal_static_google_pubsub_v1_Subscription_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_Subscription_descriptor, @@ -812,7 +876,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Key", "Value", }); internal_static_google_pubsub_v1_RetryPolicy_descriptor = - getDescriptor().getMessageTypes().get(18); + getDescriptor().getMessageTypes().get(19); internal_static_google_pubsub_v1_RetryPolicy_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_RetryPolicy_descriptor, @@ -820,7 +884,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "MinimumBackoff", "MaximumBackoff", }); internal_static_google_pubsub_v1_DeadLetterPolicy_descriptor = - getDescriptor().getMessageTypes().get(19); + getDescriptor().getMessageTypes().get(20); internal_static_google_pubsub_v1_DeadLetterPolicy_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_DeadLetterPolicy_descriptor, @@ -828,7 +892,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "DeadLetterTopic", "MaxDeliveryAttempts", }); internal_static_google_pubsub_v1_ExpirationPolicy_descriptor = - getDescriptor().getMessageTypes().get(20); + getDescriptor().getMessageTypes().get(21); internal_static_google_pubsub_v1_ExpirationPolicy_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ExpirationPolicy_descriptor, @@ -836,7 +900,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Ttl", }); internal_static_google_pubsub_v1_PushConfig_descriptor = - getDescriptor().getMessageTypes().get(21); + getDescriptor().getMessageTypes().get(22); internal_static_google_pubsub_v1_PushConfig_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_PushConfig_descriptor, @@ -880,7 +944,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Key", "Value", }); internal_static_google_pubsub_v1_BigQueryConfig_descriptor = - getDescriptor().getMessageTypes().get(22); + getDescriptor().getMessageTypes().get(23); internal_static_google_pubsub_v1_BigQueryConfig_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_BigQueryConfig_descriptor, @@ -893,7 +957,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "UseTableSchema", }); internal_static_google_pubsub_v1_CloudStorageConfig_descriptor = - getDescriptor().getMessageTypes().get(23); + getDescriptor().getMessageTypes().get(24); internal_static_google_pubsub_v1_CloudStorageConfig_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_CloudStorageConfig_descriptor, @@ -923,7 +987,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "WriteMetadata", }); internal_static_google_pubsub_v1_ReceivedMessage_descriptor = - getDescriptor().getMessageTypes().get(24); + getDescriptor().getMessageTypes().get(25); internal_static_google_pubsub_v1_ReceivedMessage_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ReceivedMessage_descriptor, @@ -931,7 +995,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "AckId", "Message", "DeliveryAttempt", }); internal_static_google_pubsub_v1_GetSubscriptionRequest_descriptor = - getDescriptor().getMessageTypes().get(25); + getDescriptor().getMessageTypes().get(26); internal_static_google_pubsub_v1_GetSubscriptionRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_GetSubscriptionRequest_descriptor, @@ -939,7 +1003,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", }); internal_static_google_pubsub_v1_UpdateSubscriptionRequest_descriptor = - getDescriptor().getMessageTypes().get(26); + getDescriptor().getMessageTypes().get(27); internal_static_google_pubsub_v1_UpdateSubscriptionRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_UpdateSubscriptionRequest_descriptor, @@ -947,7 +1011,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", "UpdateMask", }); internal_static_google_pubsub_v1_ListSubscriptionsRequest_descriptor = - getDescriptor().getMessageTypes().get(27); + getDescriptor().getMessageTypes().get(28); internal_static_google_pubsub_v1_ListSubscriptionsRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListSubscriptionsRequest_descriptor, @@ -955,7 +1019,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Project", "PageSize", "PageToken", }); internal_static_google_pubsub_v1_ListSubscriptionsResponse_descriptor = - getDescriptor().getMessageTypes().get(28); + getDescriptor().getMessageTypes().get(29); internal_static_google_pubsub_v1_ListSubscriptionsResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListSubscriptionsResponse_descriptor, @@ -963,7 +1027,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscriptions", "NextPageToken", }); internal_static_google_pubsub_v1_DeleteSubscriptionRequest_descriptor = - getDescriptor().getMessageTypes().get(29); + getDescriptor().getMessageTypes().get(30); internal_static_google_pubsub_v1_DeleteSubscriptionRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_DeleteSubscriptionRequest_descriptor, @@ -971,7 +1035,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", }); internal_static_google_pubsub_v1_ModifyPushConfigRequest_descriptor = - getDescriptor().getMessageTypes().get(30); + getDescriptor().getMessageTypes().get(31); internal_static_google_pubsub_v1_ModifyPushConfigRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ModifyPushConfigRequest_descriptor, @@ -979,7 +1043,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", "PushConfig", }); internal_static_google_pubsub_v1_PullRequest_descriptor = - getDescriptor().getMessageTypes().get(31); + getDescriptor().getMessageTypes().get(32); internal_static_google_pubsub_v1_PullRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_PullRequest_descriptor, @@ -987,7 +1051,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", "ReturnImmediately", "MaxMessages", }); internal_static_google_pubsub_v1_PullResponse_descriptor = - getDescriptor().getMessageTypes().get(32); + getDescriptor().getMessageTypes().get(33); internal_static_google_pubsub_v1_PullResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_PullResponse_descriptor, @@ -995,7 +1059,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "ReceivedMessages", }); internal_static_google_pubsub_v1_ModifyAckDeadlineRequest_descriptor = - getDescriptor().getMessageTypes().get(33); + getDescriptor().getMessageTypes().get(34); internal_static_google_pubsub_v1_ModifyAckDeadlineRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ModifyAckDeadlineRequest_descriptor, @@ -1003,7 +1067,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", "AckIds", "AckDeadlineSeconds", }); internal_static_google_pubsub_v1_AcknowledgeRequest_descriptor = - getDescriptor().getMessageTypes().get(34); + getDescriptor().getMessageTypes().get(35); internal_static_google_pubsub_v1_AcknowledgeRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_AcknowledgeRequest_descriptor, @@ -1011,7 +1075,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", "AckIds", }); internal_static_google_pubsub_v1_StreamingPullRequest_descriptor = - getDescriptor().getMessageTypes().get(35); + getDescriptor().getMessageTypes().get(36); internal_static_google_pubsub_v1_StreamingPullRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_StreamingPullRequest_descriptor, @@ -1026,7 +1090,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "MaxOutstandingBytes", }); internal_static_google_pubsub_v1_StreamingPullResponse_descriptor = - getDescriptor().getMessageTypes().get(36); + getDescriptor().getMessageTypes().get(37); internal_static_google_pubsub_v1_StreamingPullResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_StreamingPullResponse_descriptor, @@ -1061,7 +1125,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "ExactlyOnceDeliveryEnabled", "MessageOrderingEnabled", }); internal_static_google_pubsub_v1_CreateSnapshotRequest_descriptor = - getDescriptor().getMessageTypes().get(37); + getDescriptor().getMessageTypes().get(38); internal_static_google_pubsub_v1_CreateSnapshotRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_CreateSnapshotRequest_descriptor, @@ -1077,7 +1141,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Key", "Value", }); internal_static_google_pubsub_v1_UpdateSnapshotRequest_descriptor = - getDescriptor().getMessageTypes().get(38); + getDescriptor().getMessageTypes().get(39); internal_static_google_pubsub_v1_UpdateSnapshotRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_UpdateSnapshotRequest_descriptor, @@ -1085,7 +1149,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Snapshot", "UpdateMask", }); internal_static_google_pubsub_v1_Snapshot_descriptor = - getDescriptor().getMessageTypes().get(39); + getDescriptor().getMessageTypes().get(40); internal_static_google_pubsub_v1_Snapshot_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_Snapshot_descriptor, @@ -1101,7 +1165,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Key", "Value", }); internal_static_google_pubsub_v1_GetSnapshotRequest_descriptor = - getDescriptor().getMessageTypes().get(40); + getDescriptor().getMessageTypes().get(41); internal_static_google_pubsub_v1_GetSnapshotRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_GetSnapshotRequest_descriptor, @@ -1109,7 +1173,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Snapshot", }); internal_static_google_pubsub_v1_ListSnapshotsRequest_descriptor = - getDescriptor().getMessageTypes().get(41); + getDescriptor().getMessageTypes().get(42); internal_static_google_pubsub_v1_ListSnapshotsRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListSnapshotsRequest_descriptor, @@ -1117,7 +1181,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Project", "PageSize", "PageToken", }); internal_static_google_pubsub_v1_ListSnapshotsResponse_descriptor = - getDescriptor().getMessageTypes().get(42); + getDescriptor().getMessageTypes().get(43); internal_static_google_pubsub_v1_ListSnapshotsResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_ListSnapshotsResponse_descriptor, @@ -1125,7 +1189,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Snapshots", "NextPageToken", }); internal_static_google_pubsub_v1_DeleteSnapshotRequest_descriptor = - getDescriptor().getMessageTypes().get(43); + getDescriptor().getMessageTypes().get(44); internal_static_google_pubsub_v1_DeleteSnapshotRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_DeleteSnapshotRequest_descriptor, @@ -1133,7 +1197,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Snapshot", }); internal_static_google_pubsub_v1_SeekRequest_descriptor = - getDescriptor().getMessageTypes().get(44); + getDescriptor().getMessageTypes().get(45); internal_static_google_pubsub_v1_SeekRequest_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_SeekRequest_descriptor, @@ -1141,7 +1205,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "Subscription", "Time", "Snapshot", "Target", }); internal_static_google_pubsub_v1_SeekResponse_descriptor = - getDescriptor().getMessageTypes().get(45); + getDescriptor().getMessageTypes().get(46); internal_static_google_pubsub_v1_SeekResponse_fieldAccessorTable = new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_pubsub_v1_SeekResponse_descriptor, new java.lang.String[] {}); diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequest.java index 30c5431b8..7375cea5d 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequest.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequest.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -136,7 +136,7 @@ public com.google.protobuf.ByteString getSubscriptionBytes() { * * * @deprecated google.pubsub.v1.PullRequest.return_immediately is deprecated. See - * google/pubsub/v1/pubsub.proto;l=1233 + * google/pubsub/v1/pubsub.proto;l=1359 * @return The returnImmediately. */ @java.lang.Override @@ -687,7 +687,7 @@ public Builder setSubscriptionBytes(com.google.protobuf.ByteString value) { * * * @deprecated google.pubsub.v1.PullRequest.return_immediately is deprecated. See - * google/pubsub/v1/pubsub.proto;l=1233 + * google/pubsub/v1/pubsub.proto;l=1359 * @return The returnImmediately. */ @java.lang.Override @@ -713,7 +713,7 @@ public boolean getReturnImmediately() { * * * @deprecated google.pubsub.v1.PullRequest.return_immediately is deprecated. See - * google/pubsub/v1/pubsub.proto;l=1233 + * google/pubsub/v1/pubsub.proto;l=1359 * @param value The returnImmediately to set. * @return This builder for chaining. */ @@ -743,7 +743,7 @@ public Builder setReturnImmediately(boolean value) { * * * @deprecated google.pubsub.v1.PullRequest.return_immediately is deprecated. See - * google/pubsub/v1/pubsub.proto;l=1233 + * google/pubsub/v1/pubsub.proto;l=1359 * @return This builder for chaining. */ @java.lang.Deprecated diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequestOrBuilder.java index 9f9ccf387..4f2b226c5 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequestOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullRequestOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -71,7 +71,7 @@ public interface PullRequestOrBuilder * * * @deprecated google.pubsub.v1.PullRequest.return_immediately is deprecated. See - * google/pubsub/v1/pubsub.proto;l=1233 + * google/pubsub/v1/pubsub.proto;l=1359 * @return The returnImmediately. */ @java.lang.Deprecated diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponse.java index 65b827fd0..2b6824183 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponse.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponse.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -70,14 +70,16 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List getReceivedMessagesList() { @@ -87,14 +89,16 @@ public java.util.List getReceivedMessagesL * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.List @@ -105,14 +109,16 @@ public java.util.List getReceivedMessagesL * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public int getReceivedMessagesCount() { @@ -122,14 +128,16 @@ public int getReceivedMessagesCount() { * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) { @@ -139,14 +147,16 @@ public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) { * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilder(int index) { @@ -559,14 +569,16 @@ private void ensureReceivedMessagesIsMutable() { * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getReceivedMessagesList() { if (receivedMessagesBuilder_ == null) { @@ -579,14 +591,16 @@ public java.util.List getReceivedMessagesL * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public int getReceivedMessagesCount() { if (receivedMessagesBuilder_ == null) { @@ -599,14 +613,16 @@ public int getReceivedMessagesCount() { * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) { if (receivedMessagesBuilder_ == null) { @@ -619,14 +635,16 @@ public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) { * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessage value) { if (receivedMessagesBuilder_ == null) { @@ -645,14 +663,16 @@ public Builder setReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessa * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setReceivedMessages( int index, com.google.pubsub.v1.ReceivedMessage.Builder builderForValue) { @@ -669,14 +689,16 @@ public Builder setReceivedMessages( * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addReceivedMessages(com.google.pubsub.v1.ReceivedMessage value) { if (receivedMessagesBuilder_ == null) { @@ -695,14 +717,16 @@ public Builder addReceivedMessages(com.google.pubsub.v1.ReceivedMessage value) { * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessage value) { if (receivedMessagesBuilder_ == null) { @@ -721,14 +745,16 @@ public Builder addReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessa * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addReceivedMessages( com.google.pubsub.v1.ReceivedMessage.Builder builderForValue) { @@ -745,14 +771,16 @@ public Builder addReceivedMessages( * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addReceivedMessages( int index, com.google.pubsub.v1.ReceivedMessage.Builder builderForValue) { @@ -769,14 +797,16 @@ public Builder addReceivedMessages( * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder addAllReceivedMessages( java.lang.Iterable values) { @@ -793,14 +823,16 @@ public Builder addAllReceivedMessages( * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearReceivedMessages() { if (receivedMessagesBuilder_ == null) { @@ -816,14 +848,16 @@ public Builder clearReceivedMessages() { * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder removeReceivedMessages(int index) { if (receivedMessagesBuilder_ == null) { @@ -839,14 +873,16 @@ public Builder removeReceivedMessages(int index) { * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.ReceivedMessage.Builder getReceivedMessagesBuilder(int index) { return getReceivedMessagesFieldBuilder().getBuilder(index); @@ -855,14 +891,16 @@ public com.google.pubsub.v1.ReceivedMessage.Builder getReceivedMessagesBuilder(i * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilder(int index) { if (receivedMessagesBuilder_ == null) { @@ -875,14 +913,16 @@ public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilde * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getReceivedMessagesOrBuilderList() { @@ -896,14 +936,16 @@ public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilde * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder() { return getReceivedMessagesFieldBuilder() @@ -913,14 +955,16 @@ public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder() * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder(int index) { return getReceivedMessagesFieldBuilder() @@ -930,14 +974,16 @@ public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder(i * * * 
-     * Received Pub/Sub messages. The list will be empty if there are no more
-     * messages available in the backlog, or if no messages could be returned
+     * Optional. Received Pub/Sub messages. The list will be empty if there are no
+     * more messages available in the backlog, or if no messages could be returned
      * before the request timeout. For JSON, the response can be entirely
      * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
      * even if there are more messages available in the backlog.
      *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ public java.util.List getReceivedMessagesBuilderList() { diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponseOrBuilder.java index 16d1f7e5a..39112729e 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponseOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PullResponseOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,56 +27,64 @@ public interface PullResponseOrBuilder * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getReceivedMessagesList(); /** * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index); /** * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ int getReceivedMessagesCount(); /** * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.List getReceivedMessagesOrBuilderList(); @@ -84,14 +92,16 @@ public interface PullResponseOrBuilder * * * 
-   * Received Pub/Sub messages. The list will be empty if there are no more
-   * messages available in the backlog, or if no messages could be returned
+   * Optional. Received Pub/Sub messages. The list will be empty if there are no
+   * more messages available in the backlog, or if no messages could be returned
    * before the request timeout. For JSON, the response can be entirely
    * empty. The Pub/Sub system may return fewer than the `maxMessages` requested
    * even if there are more messages available in the backlog.
    *
* - * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1; + * + * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilder(int index); } diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfig.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfig.java index 7124ca38f..074068dc4 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfig.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfig.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -80,14 +80,14 @@ public interface OidcTokenOrBuilder * * * 
-     * [Service account
+     * Optional. [Service account
      * email](https://cloud.google.com/iam/docs/service-accounts)
      * used for generating the OIDC token. For more information
      * on setting up authentication, see
      * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
      *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The serviceAccountEmail. */ @@ -96,14 +96,14 @@ public interface OidcTokenOrBuilder * * * 
-     * [Service account
+     * Optional. [Service account
      * email](https://cloud.google.com/iam/docs/service-accounts)
      * used for generating the OIDC token. For more information
      * on setting up authentication, see
      * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
      *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for serviceAccountEmail. */ @@ -113,15 +113,16 @@ public interface OidcTokenOrBuilder * * * 
-     * Audience to be used when generating OIDC token. The audience claim
-     * identifies the recipients that the JWT is intended for. The audience
-     * value is a single case-sensitive string. Having multiple values (array)
-     * for the audience field is not supported. More info about the OIDC JWT
-     * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-     * Note: if not specified, the Push endpoint URL will be used.
+     * Optional. Audience to be used when generating OIDC token. The audience
+     * claim identifies the recipients that the JWT is intended for. The
+     * audience value is a single case-sensitive string. Having multiple values
+     * (array) for the audience field is not supported. More info about the OIDC
+     * JWT token audience here:
+     * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+     * the Push endpoint URL will be used.
      *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The audience. */ @@ -130,15 +131,16 @@ public interface OidcTokenOrBuilder * * * 
-     * Audience to be used when generating OIDC token. The audience claim
-     * identifies the recipients that the JWT is intended for. The audience
-     * value is a single case-sensitive string. Having multiple values (array)
-     * for the audience field is not supported. More info about the OIDC JWT
-     * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-     * Note: if not specified, the Push endpoint URL will be used.
+     * Optional. Audience to be used when generating OIDC token. The audience
+     * claim identifies the recipients that the JWT is intended for. The
+     * audience value is a single case-sensitive string. Having multiple values
+     * (array) for the audience field is not supported. More info about the OIDC
+     * JWT token audience here:
+     * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+     * the Push endpoint URL will be used.
      *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for audience. */ @@ -199,14 +201,14 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-     * [Service account
+     * Optional. [Service account
      * email](https://cloud.google.com/iam/docs/service-accounts)
      * used for generating the OIDC token. For more information
      * on setting up authentication, see
      * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
      *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The serviceAccountEmail. */ @@ -226,14 +228,14 @@ public java.lang.String getServiceAccountEmail() { * * * 
-     * [Service account
+     * Optional. [Service account
      * email](https://cloud.google.com/iam/docs/service-accounts)
      * used for generating the OIDC token. For more information
      * on setting up authentication, see
      * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
      *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for serviceAccountEmail. */ @@ -258,15 +260,16 @@ public com.google.protobuf.ByteString getServiceAccountEmailBytes() { * * * 
-     * Audience to be used when generating OIDC token. The audience claim
-     * identifies the recipients that the JWT is intended for. The audience
-     * value is a single case-sensitive string. Having multiple values (array)
-     * for the audience field is not supported. More info about the OIDC JWT
-     * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-     * Note: if not specified, the Push endpoint URL will be used.
+     * Optional. Audience to be used when generating OIDC token. The audience
+     * claim identifies the recipients that the JWT is intended for. The
+     * audience value is a single case-sensitive string. Having multiple values
+     * (array) for the audience field is not supported. More info about the OIDC
+     * JWT token audience here:
+     * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+     * the Push endpoint URL will be used.
      *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The audience. */ @@ -286,15 +289,16 @@ public java.lang.String getAudience() { * * * 
-     * Audience to be used when generating OIDC token. The audience claim
-     * identifies the recipients that the JWT is intended for. The audience
-     * value is a single case-sensitive string. Having multiple values (array)
-     * for the audience field is not supported. More info about the OIDC JWT
-     * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-     * Note: if not specified, the Push endpoint URL will be used.
+     * Optional. Audience to be used when generating OIDC token. The audience
+     * claim identifies the recipients that the JWT is intended for. The
+     * audience value is a single case-sensitive string. Having multiple values
+     * (array) for the audience field is not supported. More info about the OIDC
+     * JWT token audience here:
+     * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+     * the Push endpoint URL will be used.
      *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for audience. */ @@ -687,14 +691,14 @@ public Builder mergeFrom( * * * 
-       * [Service account
+       * Optional. [Service account
        * email](https://cloud.google.com/iam/docs/service-accounts)
        * used for generating the OIDC token. For more information
        * on setting up authentication, see
        * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
        *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The serviceAccountEmail. */ @@ -713,14 +717,14 @@ public java.lang.String getServiceAccountEmail() { * * * 
-       * [Service account
+       * Optional. [Service account
        * email](https://cloud.google.com/iam/docs/service-accounts)
        * used for generating the OIDC token. For more information
        * on setting up authentication, see
        * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
        *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for serviceAccountEmail. */ @@ -739,14 +743,14 @@ public com.google.protobuf.ByteString getServiceAccountEmailBytes() { * * * 
-       * [Service account
+       * Optional. [Service account
        * email](https://cloud.google.com/iam/docs/service-accounts)
        * used for generating the OIDC token. For more information
        * on setting up authentication, see
        * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
        *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The serviceAccountEmail to set. * @return This builder for chaining. @@ -764,14 +768,14 @@ public Builder setServiceAccountEmail(java.lang.String value) { * * * 
-       * [Service account
+       * Optional. [Service account
        * email](https://cloud.google.com/iam/docs/service-accounts)
        * used for generating the OIDC token. For more information
        * on setting up authentication, see
        * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
        *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -785,14 +789,14 @@ public Builder clearServiceAccountEmail() { * * * 
-       * [Service account
+       * Optional. [Service account
        * email](https://cloud.google.com/iam/docs/service-accounts)
        * used for generating the OIDC token. For more information
        * on setting up authentication, see
        * [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
        *
* - * string service_account_email = 1; + * string service_account_email = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for serviceAccountEmail to set. * @return This builder for chaining. @@ -813,15 +817,16 @@ public Builder setServiceAccountEmailBytes(com.google.protobuf.ByteString value) * * * 
-       * Audience to be used when generating OIDC token. The audience claim
-       * identifies the recipients that the JWT is intended for. The audience
-       * value is a single case-sensitive string. Having multiple values (array)
-       * for the audience field is not supported. More info about the OIDC JWT
-       * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-       * Note: if not specified, the Push endpoint URL will be used.
+       * Optional. Audience to be used when generating OIDC token. The audience
+       * claim identifies the recipients that the JWT is intended for. The
+       * audience value is a single case-sensitive string. Having multiple values
+       * (array) for the audience field is not supported. More info about the OIDC
+       * JWT token audience here:
+       * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+       * the Push endpoint URL will be used.
        *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The audience. */ @@ -840,15 +845,16 @@ public java.lang.String getAudience() { * * * 
-       * Audience to be used when generating OIDC token. The audience claim
-       * identifies the recipients that the JWT is intended for. The audience
-       * value is a single case-sensitive string. Having multiple values (array)
-       * for the audience field is not supported. More info about the OIDC JWT
-       * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-       * Note: if not specified, the Push endpoint URL will be used.
+       * Optional. Audience to be used when generating OIDC token. The audience
+       * claim identifies the recipients that the JWT is intended for. The
+       * audience value is a single case-sensitive string. Having multiple values
+       * (array) for the audience field is not supported. More info about the OIDC
+       * JWT token audience here:
+       * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+       * the Push endpoint URL will be used.
        *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for audience. */ @@ -867,15 +873,16 @@ public com.google.protobuf.ByteString getAudienceBytes() { * * * 
-       * Audience to be used when generating OIDC token. The audience claim
-       * identifies the recipients that the JWT is intended for. The audience
-       * value is a single case-sensitive string. Having multiple values (array)
-       * for the audience field is not supported. More info about the OIDC JWT
-       * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-       * Note: if not specified, the Push endpoint URL will be used.
+       * Optional. Audience to be used when generating OIDC token. The audience
+       * claim identifies the recipients that the JWT is intended for. The
+       * audience value is a single case-sensitive string. Having multiple values
+       * (array) for the audience field is not supported. More info about the OIDC
+       * JWT token audience here:
+       * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+       * the Push endpoint URL will be used.
        *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The audience to set. * @return This builder for chaining. @@ -893,15 +900,16 @@ public Builder setAudience(java.lang.String value) { * * * 
-       * Audience to be used when generating OIDC token. The audience claim
-       * identifies the recipients that the JWT is intended for. The audience
-       * value is a single case-sensitive string. Having multiple values (array)
-       * for the audience field is not supported. More info about the OIDC JWT
-       * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-       * Note: if not specified, the Push endpoint URL will be used.
+       * Optional. Audience to be used when generating OIDC token. The audience
+       * claim identifies the recipients that the JWT is intended for. The
+       * audience value is a single case-sensitive string. Having multiple values
+       * (array) for the audience field is not supported. More info about the OIDC
+       * JWT token audience here:
+       * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+       * the Push endpoint URL will be used.
        *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -915,15 +923,16 @@ public Builder clearAudience() { * * * 
-       * Audience to be used when generating OIDC token. The audience claim
-       * identifies the recipients that the JWT is intended for. The audience
-       * value is a single case-sensitive string. Having multiple values (array)
-       * for the audience field is not supported. More info about the OIDC JWT
-       * token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-       * Note: if not specified, the Push endpoint URL will be used.
+       * Optional. Audience to be used when generating OIDC token. The audience
+       * claim identifies the recipients that the JWT is intended for. The
+       * audience value is a single case-sensitive string. Having multiple values
+       * (array) for the audience field is not supported. More info about the OIDC
+       * JWT token audience here:
+       * https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+       * the Push endpoint URL will be used.
        *
* - * string audience = 2; + * string audience = 2 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for audience to set. * @return This builder for chaining. @@ -1438,12 +1447,12 @@ public interface NoWrapperOrBuilder * * * 
-     * When true, writes the Pub/Sub message metadata to
+     * Optional. When true, writes the Pub/Sub message metadata to
      * `x-goog-pubsub-<KEY>:<VAL>` headers of the HTTP request. Writes the
      * Pub/Sub message attributes to `<KEY>:<VAL>` headers of the HTTP request.
      *
* - * bool write_metadata = 1; + * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The writeMetadata. */ @@ -1497,12 +1506,12 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-     * When true, writes the Pub/Sub message metadata to
+     * Optional. When true, writes the Pub/Sub message metadata to
      * `x-goog-pubsub-<KEY>:<VAL>` headers of the HTTP request. Writes the
      * Pub/Sub message attributes to `<KEY>:<VAL>` headers of the HTTP request.
      *
* - * bool write_metadata = 1; + * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The writeMetadata. */ @@ -1859,12 +1868,12 @@ public Builder mergeFrom( * * * 
-       * When true, writes the Pub/Sub message metadata to
+       * Optional. When true, writes the Pub/Sub message metadata to
        * `x-goog-pubsub-<KEY>:<VAL>` headers of the HTTP request. Writes the
        * Pub/Sub message attributes to `<KEY>:<VAL>` headers of the HTTP request.
        *
* - * bool write_metadata = 1; + * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The writeMetadata. */ @@ -1876,12 +1885,12 @@ public boolean getWriteMetadata() { * * * 
-       * When true, writes the Pub/Sub message metadata to
+       * Optional. When true, writes the Pub/Sub message metadata to
        * `x-goog-pubsub-<KEY>:<VAL>` headers of the HTTP request. Writes the
        * Pub/Sub message attributes to `<KEY>:<VAL>` headers of the HTTP request.
        *
* - * bool write_metadata = 1; + * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The writeMetadata to set. * @return This builder for chaining. @@ -1897,12 +1906,12 @@ public Builder setWriteMetadata(boolean value) { * * * 
-       * When true, writes the Pub/Sub message metadata to
+       * Optional. When true, writes the Pub/Sub message metadata to
        * `x-goog-pubsub-<KEY>:<VAL>` headers of the HTTP request. Writes the
        * Pub/Sub message attributes to `<KEY>:<VAL>` headers of the HTTP request.
        *
* - * bool write_metadata = 1; + * bool write_metadata = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -2080,11 +2089,11 @@ public WrapperCase getWrapperCase() { * * * 
-   * A URL locating the endpoint to which messages should be pushed.
+   * Optional. A URL locating the endpoint to which messages should be pushed.
    * For example, a Webhook endpoint might use `https://example.com/push`.
    *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pushEndpoint. */ @@ -2104,11 +2113,11 @@ public java.lang.String getPushEndpoint() { * * * 
-   * A URL locating the endpoint to which messages should be pushed.
+   * Optional. A URL locating the endpoint to which messages should be pushed.
    * For example, a Webhook endpoint might use `https://example.com/push`.
    *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pushEndpoint. */ @@ -2155,8 +2164,8 @@ public int getAttributesCount() { * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -2178,7 +2187,8 @@ public int getAttributesCount() {
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public boolean containsAttributes(java.lang.String key) { @@ -2197,8 +2207,8 @@ public java.util.Map getAttributes() { * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -2220,7 +2230,8 @@ public java.util.Map getAttributes() {
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.Map getAttributesMap() { @@ -2230,8 +2241,8 @@ public java.util.Map getAttributesMap() { * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -2253,7 +2264,8 @@ public java.util.Map getAttributesMap() {
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public /* nullable */ java.lang.String getAttributesOrDefault( @@ -2270,8 +2282,8 @@ public java.util.Map getAttributesMap() { * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -2293,7 +2305,8 @@ public java.util.Map getAttributesMap() {
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.lang.String getAttributesOrThrow(java.lang.String key) { @@ -2312,11 +2325,14 @@ public java.lang.String getAttributesOrThrow(java.lang.String key) { * * * 
-   * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-   * `Authorization` header in the HTTP request for every pushed message.
+   * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+   * token as an `Authorization` header in the HTTP request for every pushed
+   * message.
    *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the oidcToken field is set. */ @@ -2328,11 +2344,14 @@ public boolean hasOidcToken() { * * * 
-   * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-   * `Authorization` header in the HTTP request for every pushed message.
+   * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+   * token as an `Authorization` header in the HTTP request for every pushed
+   * message.
    *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The oidcToken. */ @@ -2347,11 +2366,14 @@ public com.google.pubsub.v1.PushConfig.OidcToken getOidcToken() { * * * 
-   * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-   * `Authorization` header in the HTTP request for every pushed message.
+   * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+   * token as an `Authorization` header in the HTTP request for every pushed
+   * message.
    *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.PushConfig.OidcTokenOrBuilder getOidcTokenOrBuilder() { @@ -2366,12 +2388,14 @@ public com.google.pubsub.v1.PushConfig.OidcTokenOrBuilder getOidcTokenOrBuilder( * * * 
-   * When set, the payload to the push endpoint is in the form of the JSON
-   * representation of a PubsubMessage
+   * Optional. When set, the payload to the push endpoint is in the form of
+   * the JSON representation of a PubsubMessage
    * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
    *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the pubsubWrapper field is set. */ @@ -2383,12 +2407,14 @@ public boolean hasPubsubWrapper() { * * * 
-   * When set, the payload to the push endpoint is in the form of the JSON
-   * representation of a PubsubMessage
+   * Optional. When set, the payload to the push endpoint is in the form of
+   * the JSON representation of a PubsubMessage
    * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
    *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The pubsubWrapper. */ @@ -2403,12 +2429,14 @@ public com.google.pubsub.v1.PushConfig.PubsubWrapper getPubsubWrapper() { * * * 
-   * When set, the payload to the push endpoint is in the form of the JSON
-   * representation of a PubsubMessage
+   * Optional. When set, the payload to the push endpoint is in the form of
+   * the JSON representation of a PubsubMessage
    * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
    *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.PushConfig.PubsubWrapperOrBuilder getPubsubWrapperOrBuilder() { @@ -2423,10 +2451,12 @@ public com.google.pubsub.v1.PushConfig.PubsubWrapperOrBuilder getPubsubWrapperOr * * * 
-   * When set, the payload to the push endpoint is not wrapped.
+   * Optional. When set, the payload to the push endpoint is not wrapped.
    *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the noWrapper field is set. */ @@ -2438,10 +2468,12 @@ public boolean hasNoWrapper() { * * * 
-   * When set, the payload to the push endpoint is not wrapped.
+   * Optional. When set, the payload to the push endpoint is not wrapped.
    *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The noWrapper. */ @@ -2456,10 +2488,12 @@ public com.google.pubsub.v1.PushConfig.NoWrapper getNoWrapper() { * * * 
-   * When set, the payload to the push endpoint is not wrapped.
+   * Optional. When set, the payload to the push endpoint is not wrapped.
    *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.PushConfig.NoWrapperOrBuilder getNoWrapperOrBuilder() { @@ -3033,11 +3067,11 @@ public Builder clearWrapper() { * * * 
-     * A URL locating the endpoint to which messages should be pushed.
+     * Optional. A URL locating the endpoint to which messages should be pushed.
      * For example, a Webhook endpoint might use `https://example.com/push`.
      *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pushEndpoint. */ @@ -3056,11 +3090,11 @@ public java.lang.String getPushEndpoint() { * * * 
-     * A URL locating the endpoint to which messages should be pushed.
+     * Optional. A URL locating the endpoint to which messages should be pushed.
      * For example, a Webhook endpoint might use `https://example.com/push`.
      *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pushEndpoint. */ @@ -3079,11 +3113,11 @@ public com.google.protobuf.ByteString getPushEndpointBytes() { * * * 
-     * A URL locating the endpoint to which messages should be pushed.
+     * Optional. A URL locating the endpoint to which messages should be pushed.
      * For example, a Webhook endpoint might use `https://example.com/push`.
      *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The pushEndpoint to set. * @return This builder for chaining. @@ -3101,11 +3135,11 @@ public Builder setPushEndpoint(java.lang.String value) { * * * 
-     * A URL locating the endpoint to which messages should be pushed.
+     * Optional. A URL locating the endpoint to which messages should be pushed.
      * For example, a Webhook endpoint might use `https://example.com/push`.
      *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -3119,11 +3153,11 @@ public Builder clearPushEndpoint() { * * * 
-     * A URL locating the endpoint to which messages should be pushed.
+     * Optional. A URL locating the endpoint to which messages should be pushed.
      * For example, a Webhook endpoint might use `https://example.com/push`.
      *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for pushEndpoint to set. * @return This builder for chaining. @@ -3171,8 +3205,8 @@ public int getAttributesCount() { * * * 
-     * Endpoint configuration attributes that can be used to control different
-     * aspects of the message delivery.
+     * Optional. Endpoint configuration attributes that can be used to control
+     * different aspects of the message delivery.
      *
      * The only currently supported attribute is `x-goog-version`, which you can
      * use to change the format of the pushed message. This attribute
@@ -3194,7 +3228,8 @@ public int getAttributesCount() {
      * `attributes { "x-goog-version": "v1" }`
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public boolean containsAttributes(java.lang.String key) { @@ -3213,8 +3248,8 @@ public java.util.Map getAttributes() { * * * 
-     * Endpoint configuration attributes that can be used to control different
-     * aspects of the message delivery.
+     * Optional. Endpoint configuration attributes that can be used to control
+     * different aspects of the message delivery.
      *
      * The only currently supported attribute is `x-goog-version`, which you can
      * use to change the format of the pushed message. This attribute
@@ -3236,7 +3271,8 @@ public java.util.Map getAttributes() {
      * `attributes { "x-goog-version": "v1" }`
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.util.Map getAttributesMap() { @@ -3246,8 +3282,8 @@ public java.util.Map getAttributesMap() { * * * 
-     * Endpoint configuration attributes that can be used to control different
-     * aspects of the message delivery.
+     * Optional. Endpoint configuration attributes that can be used to control
+     * different aspects of the message delivery.
      *
      * The only currently supported attribute is `x-goog-version`, which you can
      * use to change the format of the pushed message. This attribute
@@ -3269,7 +3305,8 @@ public java.util.Map getAttributesMap() {
      * `attributes { "x-goog-version": "v1" }`
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public /* nullable */ java.lang.String getAttributesOrDefault( @@ -3286,8 +3323,8 @@ public java.util.Map getAttributesMap() { * * * 
-     * Endpoint configuration attributes that can be used to control different
-     * aspects of the message delivery.
+     * Optional. Endpoint configuration attributes that can be used to control
+     * different aspects of the message delivery.
      *
      * The only currently supported attribute is `x-goog-version`, which you can
      * use to change the format of the pushed message. This attribute
@@ -3309,7 +3346,8 @@ public java.util.Map getAttributesMap() {
      * `attributes { "x-goog-version": "v1" }`
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public java.lang.String getAttributesOrThrow(java.lang.String key) { @@ -3332,8 +3370,8 @@ public Builder clearAttributes() { * * * 
-     * Endpoint configuration attributes that can be used to control different
-     * aspects of the message delivery.
+     * Optional. Endpoint configuration attributes that can be used to control
+     * different aspects of the message delivery.
      *
      * The only currently supported attribute is `x-goog-version`, which you can
      * use to change the format of the pushed message. This attribute
@@ -3355,7 +3393,8 @@ public Builder clearAttributes() {
      * `attributes { "x-goog-version": "v1" }`
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder removeAttributes(java.lang.String key) { if (key == null) { @@ -3374,8 +3413,8 @@ public java.util.Map getMutableAttributes() * * * 
-     * Endpoint configuration attributes that can be used to control different
-     * aspects of the message delivery.
+     * Optional. Endpoint configuration attributes that can be used to control
+     * different aspects of the message delivery.
      *
      * The only currently supported attribute is `x-goog-version`, which you can
      * use to change the format of the pushed message. This attribute
@@ -3397,7 +3436,8 @@ public java.util.Map getMutableAttributes()
      * `attributes { "x-goog-version": "v1" }`
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder putAttributes(java.lang.String key, java.lang.String value) { if (key == null) { @@ -3414,8 +3454,8 @@ public Builder putAttributes(java.lang.String key, java.lang.String value) { * * * 
-     * Endpoint configuration attributes that can be used to control different
-     * aspects of the message delivery.
+     * Optional. Endpoint configuration attributes that can be used to control
+     * different aspects of the message delivery.
      *
      * The only currently supported attribute is `x-goog-version`, which you can
      * use to change the format of the pushed message. This attribute
@@ -3437,7 +3477,8 @@ public Builder putAttributes(java.lang.String key, java.lang.String value) {
      * `attributes { "x-goog-version": "v1" }`
      *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder putAllAttributes(java.util.Map values) { internalGetMutableAttributes().getMutableMap().putAll(values); @@ -3454,11 +3495,14 @@ public Builder putAllAttributes(java.util.Map - * If specified, Pub/Sub will generate and attach an OIDC JWT token as an - * `Authorization` header in the HTTP request for every pushed message. + * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT + * token as an `Authorization` header in the HTTP request for every pushed + * message. * * - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the oidcToken field is set. */ @@ -3470,11 +3514,14 @@ public boolean hasOidcToken() { * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The oidcToken. */ @@ -3496,11 +3543,14 @@ public com.google.pubsub.v1.PushConfig.OidcToken getOidcToken() { * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setOidcToken(com.google.pubsub.v1.PushConfig.OidcToken value) { if (oidcTokenBuilder_ == null) { @@ -3519,11 +3569,14 @@ public Builder setOidcToken(com.google.pubsub.v1.PushConfig.OidcToken value) { * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setOidcToken(com.google.pubsub.v1.PushConfig.OidcToken.Builder builderForValue) { if (oidcTokenBuilder_ == null) { @@ -3539,11 +3592,14 @@ public Builder setOidcToken(com.google.pubsub.v1.PushConfig.OidcToken.Builder bu * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder mergeOidcToken(com.google.pubsub.v1.PushConfig.OidcToken value) { if (oidcTokenBuilder_ == null) { @@ -3573,11 +3629,14 @@ public Builder mergeOidcToken(com.google.pubsub.v1.PushConfig.OidcToken value) { * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearOidcToken() { if (oidcTokenBuilder_ == null) { @@ -3599,11 +3658,14 @@ public Builder clearOidcToken() { * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.PushConfig.OidcToken.Builder getOidcTokenBuilder() { return getOidcTokenFieldBuilder().getBuilder(); @@ -3612,11 +3674,14 @@ public com.google.pubsub.v1.PushConfig.OidcToken.Builder getOidcTokenBuilder() { * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.PushConfig.OidcTokenOrBuilder getOidcTokenOrBuilder() { @@ -3633,11 +3698,14 @@ public com.google.pubsub.v1.PushConfig.OidcTokenOrBuilder getOidcTokenOrBuilder( * * * 
-     * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-     * `Authorization` header in the HTTP request for every pushed message.
+     * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+     * token as an `Authorization` header in the HTTP request for every pushed
+     * message.
      *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ private com.google.protobuf.SingleFieldBuilderV3< com.google.pubsub.v1.PushConfig.OidcToken, @@ -3672,12 +3740,14 @@ public com.google.pubsub.v1.PushConfig.OidcTokenOrBuilder getOidcTokenOrBuilder( * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the pubsubWrapper field is set. */ @@ -3689,12 +3759,14 @@ public boolean hasPubsubWrapper() { * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The pubsubWrapper. */ @@ -3716,12 +3788,14 @@ public com.google.pubsub.v1.PushConfig.PubsubWrapper getPubsubWrapper() { * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setPubsubWrapper(com.google.pubsub.v1.PushConfig.PubsubWrapper value) { if (pubsubWrapperBuilder_ == null) { @@ -3740,12 +3814,14 @@ public Builder setPubsubWrapper(com.google.pubsub.v1.PushConfig.PubsubWrapper va * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setPubsubWrapper( com.google.pubsub.v1.PushConfig.PubsubWrapper.Builder builderForValue) { @@ -3762,12 +3838,14 @@ public Builder setPubsubWrapper( * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder mergePubsubWrapper(com.google.pubsub.v1.PushConfig.PubsubWrapper value) { if (pubsubWrapperBuilder_ == null) { @@ -3796,12 +3874,14 @@ public Builder mergePubsubWrapper(com.google.pubsub.v1.PushConfig.PubsubWrapper * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearPubsubWrapper() { if (pubsubWrapperBuilder_ == null) { @@ -3823,12 +3903,14 @@ public Builder clearPubsubWrapper() { * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.PushConfig.PubsubWrapper.Builder getPubsubWrapperBuilder() { return getPubsubWrapperFieldBuilder().getBuilder(); @@ -3837,12 +3919,14 @@ public com.google.pubsub.v1.PushConfig.PubsubWrapper.Builder getPubsubWrapperBui * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.PushConfig.PubsubWrapperOrBuilder getPubsubWrapperOrBuilder() { @@ -3859,12 +3943,14 @@ public com.google.pubsub.v1.PushConfig.PubsubWrapperOrBuilder getPubsubWrapperOr * * * 
-     * When set, the payload to the push endpoint is in the form of the JSON
-     * representation of a PubsubMessage
+     * Optional. When set, the payload to the push endpoint is in the form of
+     * the JSON representation of a PubsubMessage
      * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
      *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ private com.google.protobuf.SingleFieldBuilderV3< com.google.pubsub.v1.PushConfig.PubsubWrapper, @@ -3899,10 +3985,12 @@ public com.google.pubsub.v1.PushConfig.PubsubWrapperOrBuilder getPubsubWrapperOr * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the noWrapper field is set. */ @@ -3914,10 +4002,12 @@ public boolean hasNoWrapper() { * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The noWrapper. */ @@ -3939,10 +4029,12 @@ public com.google.pubsub.v1.PushConfig.NoWrapper getNoWrapper() { * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setNoWrapper(com.google.pubsub.v1.PushConfig.NoWrapper value) { if (noWrapperBuilder_ == null) { @@ -3961,10 +4053,12 @@ public Builder setNoWrapper(com.google.pubsub.v1.PushConfig.NoWrapper value) { * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setNoWrapper(com.google.pubsub.v1.PushConfig.NoWrapper.Builder builderForValue) { if (noWrapperBuilder_ == null) { @@ -3980,10 +4074,12 @@ public Builder setNoWrapper(com.google.pubsub.v1.PushConfig.NoWrapper.Builder bu * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder mergeNoWrapper(com.google.pubsub.v1.PushConfig.NoWrapper value) { if (noWrapperBuilder_ == null) { @@ -4012,10 +4108,12 @@ public Builder mergeNoWrapper(com.google.pubsub.v1.PushConfig.NoWrapper value) { * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearNoWrapper() { if (noWrapperBuilder_ == null) { @@ -4037,10 +4135,12 @@ public Builder clearNoWrapper() { * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.PushConfig.NoWrapper.Builder getNoWrapperBuilder() { return getNoWrapperFieldBuilder().getBuilder(); @@ -4049,10 +4149,12 @@ public com.google.pubsub.v1.PushConfig.NoWrapper.Builder getNoWrapperBuilder() { * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.PushConfig.NoWrapperOrBuilder getNoWrapperOrBuilder() { @@ -4069,10 +4171,12 @@ public com.google.pubsub.v1.PushConfig.NoWrapperOrBuilder getNoWrapperOrBuilder( * * * 
-     * When set, the payload to the push endpoint is not wrapped.
+     * Optional. When set, the payload to the push endpoint is not wrapped.
      *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ private com.google.protobuf.SingleFieldBuilderV3< com.google.pubsub.v1.PushConfig.NoWrapper, diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfigOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfigOrBuilder.java index dade5167a..b39c32241 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfigOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PushConfigOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,11 +27,11 @@ public interface PushConfigOrBuilder * * * 
-   * A URL locating the endpoint to which messages should be pushed.
+   * Optional. A URL locating the endpoint to which messages should be pushed.
    * For example, a Webhook endpoint might use `https://example.com/push`.
    *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The pushEndpoint. */ @@ -40,11 +40,11 @@ public interface PushConfigOrBuilder * * * 
-   * A URL locating the endpoint to which messages should be pushed.
+   * Optional. A URL locating the endpoint to which messages should be pushed.
    * For example, a Webhook endpoint might use `https://example.com/push`.
    *
* - * string push_endpoint = 1; + * string push_endpoint = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for pushEndpoint. */ @@ -54,8 +54,8 @@ public interface PushConfigOrBuilder * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -77,15 +77,16 @@ public interface PushConfigOrBuilder
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ int getAttributesCount(); /** * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -107,7 +108,8 @@ public interface PushConfigOrBuilder
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ boolean containsAttributes(java.lang.String key); /** Use {@link #getAttributesMap()} instead. */ @@ -117,8 +119,8 @@ public interface PushConfigOrBuilder * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -140,15 +142,16 @@ public interface PushConfigOrBuilder
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.util.Map getAttributesMap(); /** * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -170,7 +173,8 @@ public interface PushConfigOrBuilder
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ /* nullable */ java.lang.String getAttributesOrDefault( @@ -181,8 +185,8 @@ java.lang.String getAttributesOrDefault( * * * 
-   * Endpoint configuration attributes that can be used to control different
-   * aspects of the message delivery.
+   * Optional. Endpoint configuration attributes that can be used to control
+   * different aspects of the message delivery.
    *
    * The only currently supported attribute is `x-goog-version`, which you can
    * use to change the format of the pushed message. This attribute
@@ -204,7 +208,8 @@ java.lang.String getAttributesOrDefault(
    * `attributes { "x-goog-version": "v1" }`
    *
* - * map<string, string> attributes = 2; + * map<string, string> attributes = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ java.lang.String getAttributesOrThrow(java.lang.String key); @@ -212,11 +217,14 @@ java.lang.String getAttributesOrDefault( * * * 
-   * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-   * `Authorization` header in the HTTP request for every pushed message.
+   * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+   * token as an `Authorization` header in the HTTP request for every pushed
+   * message.
    *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the oidcToken field is set. */ @@ -225,11 +233,14 @@ java.lang.String getAttributesOrDefault( * * * 
-   * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-   * `Authorization` header in the HTTP request for every pushed message.
+   * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+   * token as an `Authorization` header in the HTTP request for every pushed
+   * message.
    *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The oidcToken. */ @@ -238,11 +249,14 @@ java.lang.String getAttributesOrDefault( * * * 
-   * If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-   * `Authorization` header in the HTTP request for every pushed message.
+   * Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+   * token as an `Authorization` header in the HTTP request for every pushed
+   * message.
    *
* - * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3; + * + * .google.pubsub.v1.PushConfig.OidcToken oidc_token = 3 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.PushConfig.OidcTokenOrBuilder getOidcTokenOrBuilder(); @@ -250,12 +264,14 @@ java.lang.String getAttributesOrDefault( * * * 
-   * When set, the payload to the push endpoint is in the form of the JSON
-   * representation of a PubsubMessage
+   * Optional. When set, the payload to the push endpoint is in the form of
+   * the JSON representation of a PubsubMessage
    * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
    *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the pubsubWrapper field is set. */ @@ -264,12 +280,14 @@ java.lang.String getAttributesOrDefault( * * * 
-   * When set, the payload to the push endpoint is in the form of the JSON
-   * representation of a PubsubMessage
+   * Optional. When set, the payload to the push endpoint is in the form of
+   * the JSON representation of a PubsubMessage
    * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
    *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The pubsubWrapper. */ @@ -278,12 +296,14 @@ java.lang.String getAttributesOrDefault( * * * 
-   * When set, the payload to the push endpoint is in the form of the JSON
-   * representation of a PubsubMessage
+   * Optional. When set, the payload to the push endpoint is in the form of
+   * the JSON representation of a PubsubMessage
    * (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
    *
* - * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4; + * + * .google.pubsub.v1.PushConfig.PubsubWrapper pubsub_wrapper = 4 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.PushConfig.PubsubWrapperOrBuilder getPubsubWrapperOrBuilder(); @@ -291,10 +311,12 @@ java.lang.String getAttributesOrDefault( * * * 
-   * When set, the payload to the push endpoint is not wrapped.
+   * Optional. When set, the payload to the push endpoint is not wrapped.
    *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the noWrapper field is set. */ @@ -303,10 +325,12 @@ java.lang.String getAttributesOrDefault( * * * 
-   * When set, the payload to the push endpoint is not wrapped.
+   * Optional. When set, the payload to the push endpoint is not wrapped.
    *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The noWrapper. */ @@ -315,10 +339,12 @@ java.lang.String getAttributesOrDefault( * * * 
-   * When set, the payload to the push endpoint is not wrapped.
+   * Optional. When set, the payload to the push endpoint is not wrapped.
    *
* - * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5; + * + * .google.pubsub.v1.PushConfig.NoWrapper no_wrapper = 5 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.PushConfig.NoWrapperOrBuilder getNoWrapperOrBuilder(); diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessage.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessage.java index 3e70473df..8fd798b36 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessage.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessage.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -70,10 +70,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-   * This ID can be used to acknowledge the received message.
+   * Optional. This ID can be used to acknowledge the received message.
    *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The ackId. */ @@ -93,10 +93,10 @@ public java.lang.String getAckId() { * * * 
-   * This ID can be used to acknowledge the received message.
+   * Optional. This ID can be used to acknowledge the received message.
    *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for ackId. */ @@ -119,10 +119,11 @@ public com.google.protobuf.ByteString getAckIdBytes() { * * * 
-   * The message.
+   * Optional. The message.
    *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the message field is set. */ @@ -134,10 +135,11 @@ public boolean hasMessage() { * * * 
-   * The message.
+   * Optional. The message.
    *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The message. */ @@ -149,10 +151,11 @@ public com.google.pubsub.v1.PubsubMessage getMessage() { * * * 
-   * The message.
+   * Optional. The message.
    *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ @java.lang.Override public com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder() { @@ -165,8 +168,8 @@ public com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder() { * * * 
-   * The approximate number of times that Cloud Pub/Sub has attempted to deliver
-   * the associated message to a subscriber.
+   * Optional. The approximate number of times that Pub/Sub has attempted to
+   * deliver the associated message to a subscriber.
    *
    * More precisely, this is 1 + (number of NACKs) +
    * (number of ack_deadline exceeds) for this message.
@@ -183,7 +186,7 @@ public com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder() {
    * If a DeadLetterPolicy is not set on the subscription, this will be 0.
    *
* - * int32 delivery_attempt = 3; + * int32 delivery_attempt = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The deliveryAttempt. */ @@ -588,10 +591,10 @@ public Builder mergeFrom( * * * 
-     * This ID can be used to acknowledge the received message.
+     * Optional. This ID can be used to acknowledge the received message.
      *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The ackId. */ @@ -610,10 +613,10 @@ public java.lang.String getAckId() { * * * 
-     * This ID can be used to acknowledge the received message.
+     * Optional. This ID can be used to acknowledge the received message.
      *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for ackId. */ @@ -632,10 +635,10 @@ public com.google.protobuf.ByteString getAckIdBytes() { * * * 
-     * This ID can be used to acknowledge the received message.
+     * Optional. This ID can be used to acknowledge the received message.
      *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The ackId to set. * @return This builder for chaining. @@ -653,10 +656,10 @@ public Builder setAckId(java.lang.String value) { * * * 
-     * This ID can be used to acknowledge the received message.
+     * Optional. This ID can be used to acknowledge the received message.
      *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ @@ -670,10 +673,10 @@ public Builder clearAckId() { * * * 
-     * This ID can be used to acknowledge the received message.
+     * Optional. This ID can be used to acknowledge the received message.
      *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The bytes for ackId to set. * @return This builder for chaining. @@ -699,10 +702,11 @@ public Builder setAckIdBytes(com.google.protobuf.ByteString value) { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the message field is set. */ @@ -713,10 +717,11 @@ public boolean hasMessage() { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The message. */ @@ -733,10 +738,11 @@ public com.google.pubsub.v1.PubsubMessage getMessage() { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setMessage(com.google.pubsub.v1.PubsubMessage value) { if (messageBuilder_ == null) { @@ -755,10 +761,11 @@ public Builder setMessage(com.google.pubsub.v1.PubsubMessage value) { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder setMessage(com.google.pubsub.v1.PubsubMessage.Builder builderForValue) { if (messageBuilder_ == null) { @@ -774,10 +781,11 @@ public Builder setMessage(com.google.pubsub.v1.PubsubMessage.Builder builderForV * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder mergeMessage(com.google.pubsub.v1.PubsubMessage value) { if (messageBuilder_ == null) { @@ -799,10 +807,11 @@ public Builder mergeMessage(com.google.pubsub.v1.PubsubMessage value) { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public Builder clearMessage() { bitField0_ = (bitField0_ & ~0x00000002); @@ -818,10 +827,11 @@ public Builder clearMessage() { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.PubsubMessage.Builder getMessageBuilder() { bitField0_ |= 0x00000002; @@ -832,10 +842,11 @@ public com.google.pubsub.v1.PubsubMessage.Builder getMessageBuilder() { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ public com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder() { if (messageBuilder_ != null) { @@ -850,10 +861,11 @@ public com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder() { * * * 
-     * The message.
+     * Optional. The message.
      *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ private com.google.protobuf.SingleFieldBuilderV3< com.google.pubsub.v1.PubsubMessage, @@ -877,8 +889,8 @@ public com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder() { * * * 
-     * The approximate number of times that Cloud Pub/Sub has attempted to deliver
-     * the associated message to a subscriber.
+     * Optional. The approximate number of times that Pub/Sub has attempted to
+     * deliver the associated message to a subscriber.
      *
      * More precisely, this is 1 + (number of NACKs) +
      * (number of ack_deadline exceeds) for this message.
@@ -895,7 +907,7 @@ public com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder() {
      * If a DeadLetterPolicy is not set on the subscription, this will be 0.
      *
* - * int32 delivery_attempt = 3; + * int32 delivery_attempt = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The deliveryAttempt. */ @@ -907,8 +919,8 @@ public int getDeliveryAttempt() { * * * 
-     * The approximate number of times that Cloud Pub/Sub has attempted to deliver
-     * the associated message to a subscriber.
+     * Optional. The approximate number of times that Pub/Sub has attempted to
+     * deliver the associated message to a subscriber.
      *
      * More precisely, this is 1 + (number of NACKs) +
      * (number of ack_deadline exceeds) for this message.
@@ -925,7 +937,7 @@ public int getDeliveryAttempt() {
      * If a DeadLetterPolicy is not set on the subscription, this will be 0.
      *
* - * int32 delivery_attempt = 3; + * int32 delivery_attempt = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @param value The deliveryAttempt to set. * @return This builder for chaining. @@ -941,8 +953,8 @@ public Builder setDeliveryAttempt(int value) { * * * 
-     * The approximate number of times that Cloud Pub/Sub has attempted to deliver
-     * the associated message to a subscriber.
+     * Optional. The approximate number of times that Pub/Sub has attempted to
+     * deliver the associated message to a subscriber.
      *
      * More precisely, this is 1 + (number of NACKs) +
      * (number of ack_deadline exceeds) for this message.
@@ -959,7 +971,7 @@ public Builder setDeliveryAttempt(int value) {
      * If a DeadLetterPolicy is not set on the subscription, this will be 0.
      *
* - * int32 delivery_attempt = 3; + * int32 delivery_attempt = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return This builder for chaining. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessageOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessageOrBuilder.java index d5617c652..e8b2c0622 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessageOrBuilder.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ReceivedMessageOrBuilder.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -27,10 +27,10 @@ public interface ReceivedMessageOrBuilder * * * 
-   * This ID can be used to acknowledge the received message.
+   * Optional. This ID can be used to acknowledge the received message.
    *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The ackId. */ @@ -39,10 +39,10 @@ public interface ReceivedMessageOrBuilder * * * 
-   * This ID can be used to acknowledge the received message.
+   * Optional. This ID can be used to acknowledge the received message.
    *
* - * string ack_id = 1; + * string ack_id = 1 [(.google.api.field_behavior) = OPTIONAL]; * * @return The bytes for ackId. */ @@ -52,10 +52,11 @@ public interface ReceivedMessageOrBuilder * * * 
-   * The message.
+   * Optional. The message.
    *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return Whether the message field is set. */ @@ -64,10 +65,11 @@ public interface ReceivedMessageOrBuilder * * * 
-   * The message.
+   * Optional. The message.
    *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * * * @return The message. */ @@ -76,10 +78,11 @@ public interface ReceivedMessageOrBuilder * * * 
-   * The message.
+   * Optional. The message.
    *
* - * .google.pubsub.v1.PubsubMessage message = 2; + * .google.pubsub.v1.PubsubMessage message = 2 [(.google.api.field_behavior) = OPTIONAL]; + * */ com.google.pubsub.v1.PubsubMessageOrBuilder getMessageOrBuilder(); @@ -87,8 +90,8 @@ public interface ReceivedMessageOrBuilder * * * 
-   * The approximate number of times that Cloud Pub/Sub has attempted to deliver
-   * the associated message to a subscriber.
+   * Optional. The approximate number of times that Pub/Sub has attempted to
+   * deliver the associated message to a subscriber.
    *
    * More precisely, this is 1 + (number of NACKs) +
    * (number of ack_deadline exceeds) for this message.
@@ -105,7 +108,7 @@ public interface ReceivedMessageOrBuilder
    * If a DeadLetterPolicy is not set on the subscription, this will be 0.
    *
* - * int32 delivery_attempt = 3; + * int32 delivery_attempt = 3 [(.google.api.field_behavior) = OPTIONAL]; * * @return The deliveryAttempt. */ diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicy.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicy.java index aee326393..31375806d 100644 --- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicy.java +++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicy.java @@ -1,5 +1,5 @@ /* - * Copyright 2023 Google LLC + * Copyright 2024 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -22,7 +22,7 @@ * * * 
- * A policy that specifies how Cloud Pub/Sub retries message delivery.
+ * A policy that specifies how Pub/Sub retries message delivery.
  *
  * Retry delay will be exponential based on provided minimum and maximum
  * backoffs. https://en.wikipedia.org/wiki/Exponential_backoff.
@@ -74,11 +74,12 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
-   * The minimum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+   * Optional. The minimum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
    * 

    *
-   * .google.protobuf.Duration minimum_backoff = 1;
+   * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the minimumBackoff field is set.
    */
@@ -90,11 +91,12 @@ public boolean hasMinimumBackoff() {
    *
    *
    * 
-   * The minimum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+   * Optional. The minimum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
    * 

    *
-   * .google.protobuf.Duration minimum_backoff = 1;
+   * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The minimumBackoff.
    */
@@ -108,11 +110,12 @@ public com.google.protobuf.Duration getMinimumBackoff() {
    *
    *
    * 
-   * The minimum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+   * Optional. The minimum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
    * 

    *
-   * .google.protobuf.Duration minimum_backoff = 1;
+   * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.protobuf.DurationOrBuilder getMinimumBackoffOrBuilder() {
@@ -127,11 +130,13 @@ public com.google.protobuf.DurationOrBuilder getMinimumBackoffOrBuilder() {
    *
    *
    * 
-   * The maximum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+   * Optional. The maximum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 600
+   * seconds.
    * 

    *
-   * .google.protobuf.Duration maximum_backoff = 2;
+   * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the maximumBackoff field is set.
    */
@@ -143,11 +148,13 @@ public boolean hasMaximumBackoff() {
    *
    *
    * 
-   * The maximum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+   * Optional. The maximum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 600
+   * seconds.
    * 

    *
-   * .google.protobuf.Duration maximum_backoff = 2;
+   * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The maximumBackoff.
    */
@@ -161,11 +168,13 @@ public com.google.protobuf.Duration getMaximumBackoff() {
    *
    *
    * 
-   * The maximum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+   * Optional. The maximum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 600
+   * seconds.
    * 

    *
-   * .google.protobuf.Duration maximum_backoff = 2;
+   * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.protobuf.DurationOrBuilder getMaximumBackoffOrBuilder() {
@@ -354,7 +363,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
-   * A policy that specifies how Cloud Pub/Sub retries message delivery.
+   * A policy that specifies how Pub/Sub retries message delivery.
    *
    * Retry delay will be exponential based on provided minimum and maximum
    * backoffs. https://en.wikipedia.org/wiki/Exponential_backoff.
@@ -572,11 +581,13 @@ public Builder mergeFrom(
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the minimumBackoff field is set.
      */
@@ -587,11 +598,13 @@ public boolean hasMinimumBackoff() {
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The minimumBackoff.
      */
@@ -608,11 +621,13 @@ public com.google.protobuf.Duration getMinimumBackoff() {
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMinimumBackoff(com.google.protobuf.Duration value) {
       if (minimumBackoffBuilder_ == null) {
@@ -631,11 +646,13 @@ public Builder setMinimumBackoff(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMinimumBackoff(com.google.protobuf.Duration.Builder builderForValue) {
       if (minimumBackoffBuilder_ == null) {
@@ -651,11 +668,13 @@ public Builder setMinimumBackoff(com.google.protobuf.Duration.Builder builderFor
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeMinimumBackoff(com.google.protobuf.Duration value) {
       if (minimumBackoffBuilder_ == null) {
@@ -677,11 +696,13 @@ public Builder mergeMinimumBackoff(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearMinimumBackoff() {
       bitField0_ = (bitField0_ & ~0x00000001);
@@ -697,11 +718,13 @@ public Builder clearMinimumBackoff() {
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.Duration.Builder getMinimumBackoffBuilder() {
       bitField0_ |= 0x00000001;
@@ -712,11 +735,13 @@ public com.google.protobuf.Duration.Builder getMinimumBackoffBuilder() {
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.DurationOrBuilder getMinimumBackoffOrBuilder() {
       if (minimumBackoffBuilder_ != null) {
@@ -731,11 +756,13 @@ public com.google.protobuf.DurationOrBuilder getMinimumBackoffOrBuilder() {
      *
      *
      * 
-     * The minimum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+     * Optional. The minimum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
      * 

      *
-     * .google.protobuf.Duration minimum_backoff = 1;
+     * 
+     * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.Duration,
@@ -764,11 +791,14 @@ public com.google.protobuf.DurationOrBuilder getMinimumBackoffOrBuilder() {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the maximumBackoff field is set.
      */
@@ -779,11 +809,14 @@ public boolean hasMaximumBackoff() {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The maximumBackoff.
      */
@@ -800,11 +833,14 @@ public com.google.protobuf.Duration getMaximumBackoff() {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMaximumBackoff(com.google.protobuf.Duration value) {
       if (maximumBackoffBuilder_ == null) {
@@ -823,11 +859,14 @@ public Builder setMaximumBackoff(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMaximumBackoff(com.google.protobuf.Duration.Builder builderForValue) {
       if (maximumBackoffBuilder_ == null) {
@@ -843,11 +882,14 @@ public Builder setMaximumBackoff(com.google.protobuf.Duration.Builder builderFor
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeMaximumBackoff(com.google.protobuf.Duration value) {
       if (maximumBackoffBuilder_ == null) {
@@ -869,11 +911,14 @@ public Builder mergeMaximumBackoff(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearMaximumBackoff() {
       bitField0_ = (bitField0_ & ~0x00000002);
@@ -889,11 +934,14 @@ public Builder clearMaximumBackoff() {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.Duration.Builder getMaximumBackoffBuilder() {
       bitField0_ |= 0x00000002;
@@ -904,11 +952,14 @@ public com.google.protobuf.Duration.Builder getMaximumBackoffBuilder() {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.DurationOrBuilder getMaximumBackoffOrBuilder() {
       if (maximumBackoffBuilder_ != null) {
@@ -923,11 +974,14 @@ public com.google.protobuf.DurationOrBuilder getMaximumBackoffOrBuilder() {
      *
      *
      * 
-     * The maximum delay between consecutive deliveries of a given message.
-     * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+     * Optional. The maximum delay between consecutive deliveries of a given
+     * message. Value should be between 0 and 600 seconds. Defaults to 600
+     * seconds.
      * 

      *
-     * .google.protobuf.Duration maximum_backoff = 2;
+     * 
+     * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.Duration,
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicyOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicyOrBuilder.java
index 967fa903c..42cfa2210 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicyOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RetryPolicyOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,11 +27,12 @@ public interface RetryPolicyOrBuilder
    *
    *
    * 
-   * The minimum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+   * Optional. The minimum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
    * 

    *
-   * .google.protobuf.Duration minimum_backoff = 1;
+   * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the minimumBackoff field is set.
    */
@@ -40,11 +41,12 @@ public interface RetryPolicyOrBuilder
    *
    *
    * 
-   * The minimum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+   * Optional. The minimum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
    * 

    *
-   * .google.protobuf.Duration minimum_backoff = 1;
+   * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The minimumBackoff.
    */
@@ -53,11 +55,12 @@ public interface RetryPolicyOrBuilder
    *
    *
    * 
-   * The minimum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+   * Optional. The minimum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
    * 

    *
-   * .google.protobuf.Duration minimum_backoff = 1;
+   * .google.protobuf.Duration minimum_backoff = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.protobuf.DurationOrBuilder getMinimumBackoffOrBuilder();
 
@@ -65,11 +68,13 @@ public interface RetryPolicyOrBuilder
    *
    *
    * 
-   * The maximum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+   * Optional. The maximum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 600
+   * seconds.
    * 

    *
-   * .google.protobuf.Duration maximum_backoff = 2;
+   * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the maximumBackoff field is set.
    */
@@ -78,11 +83,13 @@ public interface RetryPolicyOrBuilder
    *
    *
    * 
-   * The maximum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+   * Optional. The maximum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 600
+   * seconds.
    * 

    *
-   * .google.protobuf.Duration maximum_backoff = 2;
+   * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The maximumBackoff.
    */
@@ -91,11 +98,13 @@ public interface RetryPolicyOrBuilder
    *
    *
    * 
-   * The maximum delay between consecutive deliveries of a given message.
-   * Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+   * Optional. The maximum delay between consecutive deliveries of a given
+   * message. Value should be between 0 and 600 seconds. Defaults to 600
+   * seconds.
    * 

    *
-   * .google.protobuf.Duration maximum_backoff = 2;
+   * .google.protobuf.Duration maximum_backoff = 2 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.protobuf.DurationOrBuilder getMaximumBackoffOrBuilder();
 }
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequest.java
index 6de995c70..3b9f46ddc 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequestOrBuilder.java
index b7562292e..992986674 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/RollbackSchemaRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Schema.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Schema.java
index 7cdbcff9e..1eef47c39 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Schema.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Schema.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaOrBuilder.java
index 98612c8c1..d16516796 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaProto.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaProto.java
index 296a9bc5c..d04c35cb0 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaProto.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaProto.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettings.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettings.java
index e43b99679..fdf613987 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettings.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettings.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -132,10 +132,10 @@ public com.google.protobuf.ByteString getSchemaBytes() {
    *
    *
    * 
-   * The encoding of messages validated against `schema`.
+   * Optional. The encoding of messages validated against `schema`.
    * 

    *
-   * .google.pubsub.v1.Encoding encoding = 2;
+   * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The enum numeric value on the wire for encoding.
    */
@@ -147,10 +147,10 @@ public int getEncodingValue() {
    *
    *
    * 
-   * The encoding of messages validated against `schema`.
+   * Optional. The encoding of messages validated against `schema`.
    * 

    *
-   * .google.pubsub.v1.Encoding encoding = 2;
+   * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The encoding.
    */
@@ -168,12 +168,12 @@ public com.google.pubsub.v1.Encoding getEncoding() {
    *
    *
    * 
-   * The minimum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against last_revision or
-   * any revision created before.
+   * Optional. The minimum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * last_revision or any revision created before.
    * 

    *
-   * string first_revision_id = 3;
+   * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The firstRevisionId.
    */
@@ -193,12 +193,12 @@ public java.lang.String getFirstRevisionId() {
    *
    *
    * 
-   * The minimum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against last_revision or
-   * any revision created before.
+   * Optional. The minimum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * last_revision or any revision created before.
    * 

    *
-   * string first_revision_id = 3;
+   * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for firstRevisionId.
    */
@@ -223,12 +223,12 @@ public com.google.protobuf.ByteString getFirstRevisionIdBytes() {
    *
    *
    * 
-   * The maximum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against first_revision
-   * or any revision created after.
+   * Optional. The maximum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * first_revision or any revision created after.
    * 

    *
-   * string last_revision_id = 4;
+   * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The lastRevisionId.
    */
@@ -248,12 +248,12 @@ public java.lang.String getLastRevisionId() {
    *
    *
    * 
-   * The maximum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against first_revision
-   * or any revision created after.
+   * Optional. The maximum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * first_revision or any revision created after.
    * 

    *
-   * string last_revision_id = 4;
+   * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for lastRevisionId.
    */
@@ -814,10 +814,11 @@ public Builder setSchemaBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * The encoding of messages validated against `schema`.
+     * Optional. The encoding of messages validated against `schema`.
      * 

      *
-     * .google.pubsub.v1.Encoding encoding = 2;
+     * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The enum numeric value on the wire for encoding.
      */
@@ -829,10 +830,11 @@ public int getEncodingValue() {
      *
      *
      * 
-     * The encoding of messages validated against `schema`.
+     * Optional. The encoding of messages validated against `schema`.
      * 

      *
-     * .google.pubsub.v1.Encoding encoding = 2;
+     * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param value The enum numeric value on the wire for encoding to set.
      * @return This builder for chaining.
@@ -847,10 +849,11 @@ public Builder setEncodingValue(int value) {
      *
      *
      * 
-     * The encoding of messages validated against `schema`.
+     * Optional. The encoding of messages validated against `schema`.
      * 

      *
-     * .google.pubsub.v1.Encoding encoding = 2;
+     * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The encoding.
      */
@@ -863,10 +866,11 @@ public com.google.pubsub.v1.Encoding getEncoding() {
      *
      *
      * 
-     * The encoding of messages validated against `schema`.
+     * Optional. The encoding of messages validated against `schema`.
      * 

      *
-     * .google.pubsub.v1.Encoding encoding = 2;
+     * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param value The encoding to set.
      * @return This builder for chaining.
@@ -884,10 +888,11 @@ public Builder setEncoding(com.google.pubsub.v1.Encoding value) {
      *
      *
      * 
-     * The encoding of messages validated against `schema`.
+     * Optional. The encoding of messages validated against `schema`.
      * 

      *
-     * .google.pubsub.v1.Encoding encoding = 2;
+     * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return This builder for chaining.
      */
@@ -903,12 +908,12 @@ public Builder clearEncoding() {
      *
      *
      * 
-     * The minimum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against last_revision or
-     * any revision created before.
+     * Optional. The minimum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * last_revision or any revision created before.
      * 

      *
-     * string first_revision_id = 3;
+     * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The firstRevisionId.
      */
@@ -927,12 +932,12 @@ public java.lang.String getFirstRevisionId() {
      *
      *
      * 
-     * The minimum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against last_revision or
-     * any revision created before.
+     * Optional. The minimum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * last_revision or any revision created before.
      * 

      *
-     * string first_revision_id = 3;
+     * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for firstRevisionId.
      */
@@ -951,12 +956,12 @@ public com.google.protobuf.ByteString getFirstRevisionIdBytes() {
      *
      *
      * 
-     * The minimum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against last_revision or
-     * any revision created before.
+     * Optional. The minimum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * last_revision or any revision created before.
      * 

      *
-     * string first_revision_id = 3;
+     * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The firstRevisionId to set.
      * @return This builder for chaining.
@@ -974,12 +979,12 @@ public Builder setFirstRevisionId(java.lang.String value) {
      *
      *
      * 
-     * The minimum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against last_revision or
-     * any revision created before.
+     * Optional. The minimum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * last_revision or any revision created before.
      * 

      *
-     * string first_revision_id = 3;
+     * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -993,12 +998,12 @@ public Builder clearFirstRevisionId() {
      *
      *
      * 
-     * The minimum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against last_revision or
-     * any revision created before.
+     * Optional. The minimum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * last_revision or any revision created before.
      * 

      *
-     * string first_revision_id = 3;
+     * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for firstRevisionId to set.
      * @return This builder for chaining.
@@ -1019,12 +1024,12 @@ public Builder setFirstRevisionIdBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * The maximum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against first_revision
-     * or any revision created after.
+     * Optional. The maximum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * first_revision or any revision created after.
      * 

      *
-     * string last_revision_id = 4;
+     * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The lastRevisionId.
      */
@@ -1043,12 +1048,12 @@ public java.lang.String getLastRevisionId() {
      *
      *
      * 
-     * The maximum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against first_revision
-     * or any revision created after.
+     * Optional. The maximum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * first_revision or any revision created after.
      * 

      *
-     * string last_revision_id = 4;
+     * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for lastRevisionId.
      */
@@ -1067,12 +1072,12 @@ public com.google.protobuf.ByteString getLastRevisionIdBytes() {
      *
      *
      * 
-     * The maximum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against first_revision
-     * or any revision created after.
+     * Optional. The maximum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * first_revision or any revision created after.
      * 

      *
-     * string last_revision_id = 4;
+     * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The lastRevisionId to set.
      * @return This builder for chaining.
@@ -1090,12 +1095,12 @@ public Builder setLastRevisionId(java.lang.String value) {
      *
      *
      * 
-     * The maximum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against first_revision
-     * or any revision created after.
+     * Optional. The maximum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * first_revision or any revision created after.
      * 

      *
-     * string last_revision_id = 4;
+     * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -1109,12 +1114,12 @@ public Builder clearLastRevisionId() {
      *
      *
      * 
-     * The maximum (inclusive) revision allowed for validating messages. If empty
-     * or not present, allow any revision to be validated against first_revision
-     * or any revision created after.
+     * Optional. The maximum (inclusive) revision allowed for validating messages.
+     * If empty or not present, allow any revision to be validated against
+     * first_revision or any revision created after.
      * 

      *
-     * string last_revision_id = 4;
+     * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for lastRevisionId to set.
      * @return This builder for chaining.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettingsOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettingsOrBuilder.java
index b65abdf20..19823f45f 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettingsOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaSettingsOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -62,10 +62,10 @@ public interface SchemaSettingsOrBuilder
    *
    *
    * 
-   * The encoding of messages validated against `schema`.
+   * Optional. The encoding of messages validated against `schema`.
    * 

    *
-   * .google.pubsub.v1.Encoding encoding = 2;
+   * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The enum numeric value on the wire for encoding.
    */
@@ -74,10 +74,10 @@ public interface SchemaSettingsOrBuilder
    *
    *
    * 
-   * The encoding of messages validated against `schema`.
+   * Optional. The encoding of messages validated against `schema`.
    * 

    *
-   * .google.pubsub.v1.Encoding encoding = 2;
+   * .google.pubsub.v1.Encoding encoding = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The encoding.
    */
@@ -87,12 +87,12 @@ public interface SchemaSettingsOrBuilder
    *
    *
    * 
-   * The minimum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against last_revision or
-   * any revision created before.
+   * Optional. The minimum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * last_revision or any revision created before.
    * 

    *
-   * string first_revision_id = 3;
+   * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The firstRevisionId.
    */
@@ -101,12 +101,12 @@ public interface SchemaSettingsOrBuilder
    *
    *
    * 
-   * The minimum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against last_revision or
-   * any revision created before.
+   * Optional. The minimum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * last_revision or any revision created before.
    * 

    *
-   * string first_revision_id = 3;
+   * string first_revision_id = 3 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for firstRevisionId.
    */
@@ -116,12 +116,12 @@ public interface SchemaSettingsOrBuilder
    *
    *
    * 
-   * The maximum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against first_revision
-   * or any revision created after.
+   * Optional. The maximum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * first_revision or any revision created after.
    * 

    *
-   * string last_revision_id = 4;
+   * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The lastRevisionId.
    */
@@ -130,12 +130,12 @@ public interface SchemaSettingsOrBuilder
    *
    *
    * 
-   * The maximum (inclusive) revision allowed for validating messages. If empty
-   * or not present, allow any revision to be validated against first_revision
-   * or any revision created after.
+   * Optional. The maximum (inclusive) revision allowed for validating messages.
+   * If empty or not present, allow any revision to be validated against
+   * first_revision or any revision created after.
    * 

    *
-   * string last_revision_id = 4;
+   * string last_revision_id = 4 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for lastRevisionId.
    */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaView.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaView.java
index c9ff100cd..80ca623eb 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaView.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SchemaView.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java
index 4cded2d70..6e6d5f347 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -169,7 +169,7 @@ public com.google.protobuf.ByteString getSubscriptionBytes() {
    *
    *
    * 
-   * The time to seek to.
+   * Optional. The time to seek to.
    * Messages retained in the subscription that were published before this
    * time are marked as acknowledged, and messages retained in the
    * subscription that were published after this time are marked as
@@ -182,7 +182,7 @@ public com.google.protobuf.ByteString getSubscriptionBytes() {
    * and already-expunged messages will not be restored.
    * 

    *
-   * .google.protobuf.Timestamp time = 2;
+   * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return Whether the time field is set.
    */
@@ -194,7 +194,7 @@ public boolean hasTime() {
    *
    *
    * 
-   * The time to seek to.
+   * Optional. The time to seek to.
    * Messages retained in the subscription that were published before this
    * time are marked as acknowledged, and messages retained in the
    * subscription that were published after this time are marked as
@@ -207,7 +207,7 @@ public boolean hasTime() {
    * and already-expunged messages will not be restored.
    * 

    *
-   * .google.protobuf.Timestamp time = 2;
+   * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The time.
    */
@@ -222,7 +222,7 @@ public com.google.protobuf.Timestamp getTime() {
    *
    *
    * 
-   * The time to seek to.
+   * Optional. The time to seek to.
    * Messages retained in the subscription that were published before this
    * time are marked as acknowledged, and messages retained in the
    * subscription that were published after this time are marked as
@@ -235,7 +235,7 @@ public com.google.protobuf.Timestamp getTime() {
    * and already-expunged messages will not be restored.
    * 

    *
-   * .google.protobuf.Timestamp time = 2;
+   * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
@@ -250,12 +250,14 @@ public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
    *
    *
    * 
-   * The snapshot to seek to. The snapshot's topic must be the same as that of
-   * the provided subscription.
-   * Format is `projects/{project}/snapshots/{snap}`.
+   * Optional. The snapshot to seek to. The snapshot's topic must be the same
+   * as that of the provided subscription. Format is
+   * `projects/{project}/snapshots/{snap}`.
    * 

    *
-   * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+   * 
+   * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return Whether the snapshot field is set.
    */
@@ -266,12 +268,14 @@ public boolean hasSnapshot() {
    *
    *
    * 
-   * The snapshot to seek to. The snapshot's topic must be the same as that of
-   * the provided subscription.
-   * Format is `projects/{project}/snapshots/{snap}`.
+   * Optional. The snapshot to seek to. The snapshot's topic must be the same
+   * as that of the provided subscription. Format is
+   * `projects/{project}/snapshots/{snap}`.
    * 

    *
-   * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+   * 
+   * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The snapshot.
    */
@@ -295,12 +299,14 @@ public java.lang.String getSnapshot() {
    *
    *
    * 
-   * The snapshot to seek to. The snapshot's topic must be the same as that of
-   * the provided subscription.
-   * Format is `projects/{project}/snapshots/{snap}`.
+   * Optional. The snapshot to seek to. The snapshot's topic must be the same
+   * as that of the provided subscription. Format is
+   * `projects/{project}/snapshots/{snap}`.
    * 

    *
-   * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+   * 
+   * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The bytes for snapshot.
    */
@@ -880,7 +886,7 @@ public Builder setSubscriptionBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -893,7 +899,7 @@ public Builder setSubscriptionBytes(com.google.protobuf.ByteString value) {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return Whether the time field is set.
      */
@@ -905,7 +911,7 @@ public boolean hasTime() {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -918,7 +924,7 @@ public boolean hasTime() {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The time.
      */
@@ -940,7 +946,7 @@ public com.google.protobuf.Timestamp getTime() {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -953,7 +959,7 @@ public com.google.protobuf.Timestamp getTime() {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder setTime(com.google.protobuf.Timestamp value) {
       if (timeBuilder_ == null) {
@@ -972,7 +978,7 @@ public Builder setTime(com.google.protobuf.Timestamp value) {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -985,7 +991,7 @@ public Builder setTime(com.google.protobuf.Timestamp value) {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder setTime(com.google.protobuf.Timestamp.Builder builderForValue) {
       if (timeBuilder_ == null) {
@@ -1001,7 +1007,7 @@ public Builder setTime(com.google.protobuf.Timestamp.Builder builderForValue) {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -1014,7 +1020,7 @@ public Builder setTime(com.google.protobuf.Timestamp.Builder builderForValue) {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder mergeTime(com.google.protobuf.Timestamp value) {
       if (timeBuilder_ == null) {
@@ -1041,7 +1047,7 @@ public Builder mergeTime(com.google.protobuf.Timestamp value) {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -1054,7 +1060,7 @@ public Builder mergeTime(com.google.protobuf.Timestamp value) {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder clearTime() {
       if (timeBuilder_ == null) {
@@ -1076,7 +1082,7 @@ public Builder clearTime() {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -1089,7 +1095,7 @@ public Builder clearTime() {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public com.google.protobuf.Timestamp.Builder getTimeBuilder() {
       return getTimeFieldBuilder().getBuilder();
@@ -1098,7 +1104,7 @@ public com.google.protobuf.Timestamp.Builder getTimeBuilder() {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -1111,7 +1117,7 @@ public com.google.protobuf.Timestamp.Builder getTimeBuilder() {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
@@ -1128,7 +1134,7 @@ public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
      *
      *
      * 
-     * The time to seek to.
+     * Optional. The time to seek to.
      * Messages retained in the subscription that were published before this
      * time are marked as acknowledged, and messages retained in the
      * subscription that were published after this time are marked as
@@ -1141,7 +1147,7 @@ public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
      * and already-expunged messages will not be restored.
      * 

      *
-     * .google.protobuf.Timestamp time = 2;
+     * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.Timestamp,
@@ -1169,12 +1175,14 @@ public com.google.protobuf.TimestampOrBuilder getTimeOrBuilder() {
      *
      *
      * 
-     * The snapshot to seek to. The snapshot's topic must be the same as that of
-     * the provided subscription.
-     * Format is `projects/{project}/snapshots/{snap}`.
+     * Optional. The snapshot to seek to. The snapshot's topic must be the same
+     * as that of the provided subscription. Format is
+     * `projects/{project}/snapshots/{snap}`.
      * 

      *
-     * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+     * 
+     * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return Whether the snapshot field is set.
      */
@@ -1186,12 +1194,14 @@ public boolean hasSnapshot() {
      *
      *
      * 
-     * The snapshot to seek to. The snapshot's topic must be the same as that of
-     * the provided subscription.
-     * Format is `projects/{project}/snapshots/{snap}`.
+     * Optional. The snapshot to seek to. The snapshot's topic must be the same
+     * as that of the provided subscription. Format is
+     * `projects/{project}/snapshots/{snap}`.
      * 

      *
-     * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+     * 
+     * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return The snapshot.
      */
@@ -1216,12 +1226,14 @@ public java.lang.String getSnapshot() {
      *
      *
      * 
-     * The snapshot to seek to. The snapshot's topic must be the same as that of
-     * the provided subscription.
-     * Format is `projects/{project}/snapshots/{snap}`.
+     * Optional. The snapshot to seek to. The snapshot's topic must be the same
+     * as that of the provided subscription. Format is
+     * `projects/{project}/snapshots/{snap}`.
      * 

      *
-     * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+     * 
+     * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return The bytes for snapshot.
      */
@@ -1246,12 +1258,14 @@ public com.google.protobuf.ByteString getSnapshotBytes() {
      *
      *
      * 
-     * The snapshot to seek to. The snapshot's topic must be the same as that of
-     * the provided subscription.
-     * Format is `projects/{project}/snapshots/{snap}`.
+     * Optional. The snapshot to seek to. The snapshot's topic must be the same
+     * as that of the provided subscription. Format is
+     * `projects/{project}/snapshots/{snap}`.
      * 

      *
-     * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+     * 
+     * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @param value The snapshot to set.
      * @return This builder for chaining.
@@ -1269,12 +1283,14 @@ public Builder setSnapshot(java.lang.String value) {
      *
      *
      * 
-     * The snapshot to seek to. The snapshot's topic must be the same as that of
-     * the provided subscription.
-     * Format is `projects/{project}/snapshots/{snap}`.
+     * Optional. The snapshot to seek to. The snapshot's topic must be the same
+     * as that of the provided subscription. Format is
+     * `projects/{project}/snapshots/{snap}`.
      * 

      *
-     * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+     * 
+     * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return This builder for chaining.
      */
@@ -1290,12 +1306,14 @@ public Builder clearSnapshot() {
      *
      *
      * 
-     * The snapshot to seek to. The snapshot's topic must be the same as that of
-     * the provided subscription.
-     * Format is `projects/{project}/snapshots/{snap}`.
+     * Optional. The snapshot to seek to. The snapshot's topic must be the same
+     * as that of the provided subscription. Format is
+     * `projects/{project}/snapshots/{snap}`.
      * 

      *
-     * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+     * 
+     * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @param value The bytes for snapshot to set.
      * @return This builder for chaining.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequestOrBuilder.java
index 009aaa5f8..54a98d0d9 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -56,7 +56,7 @@ public interface SeekRequestOrBuilder
    *
    *
    * 
-   * The time to seek to.
+   * Optional. The time to seek to.
    * Messages retained in the subscription that were published before this
    * time are marked as acknowledged, and messages retained in the
    * subscription that were published after this time are marked as
@@ -69,7 +69,7 @@ public interface SeekRequestOrBuilder
    * and already-expunged messages will not be restored.
    * 

    *
-   * .google.protobuf.Timestamp time = 2;
+   * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return Whether the time field is set.
    */
@@ -78,7 +78,7 @@ public interface SeekRequestOrBuilder
    *
    *
    * 
-   * The time to seek to.
+   * Optional. The time to seek to.
    * Messages retained in the subscription that were published before this
    * time are marked as acknowledged, and messages retained in the
    * subscription that were published after this time are marked as
@@ -91,7 +91,7 @@ public interface SeekRequestOrBuilder
    * and already-expunged messages will not be restored.
    * 

    *
-   * .google.protobuf.Timestamp time = 2;
+   * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The time.
    */
@@ -100,7 +100,7 @@ public interface SeekRequestOrBuilder
    *
    *
    * 
-   * The time to seek to.
+   * Optional. The time to seek to.
    * Messages retained in the subscription that were published before this
    * time are marked as acknowledged, and messages retained in the
    * subscription that were published after this time are marked as
@@ -113,7 +113,7 @@ public interface SeekRequestOrBuilder
    * and already-expunged messages will not be restored.
    * 

    *
-   * .google.protobuf.Timestamp time = 2;
+   * .google.protobuf.Timestamp time = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   com.google.protobuf.TimestampOrBuilder getTimeOrBuilder();
 
@@ -121,12 +121,14 @@ public interface SeekRequestOrBuilder
    *
    *
    * 
-   * The snapshot to seek to. The snapshot's topic must be the same as that of
-   * the provided subscription.
-   * Format is `projects/{project}/snapshots/{snap}`.
+   * Optional. The snapshot to seek to. The snapshot's topic must be the same
+   * as that of the provided subscription. Format is
+   * `projects/{project}/snapshots/{snap}`.
    * 

    *
-   * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+   * 
+   * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return Whether the snapshot field is set.
    */
@@ -135,12 +137,14 @@ public interface SeekRequestOrBuilder
    *
    *
    * 
-   * The snapshot to seek to. The snapshot's topic must be the same as that of
-   * the provided subscription.
-   * Format is `projects/{project}/snapshots/{snap}`.
+   * Optional. The snapshot to seek to. The snapshot's topic must be the same
+   * as that of the provided subscription. Format is
+   * `projects/{project}/snapshots/{snap}`.
    * 

    *
-   * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+   * 
+   * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The snapshot.
    */
@@ -149,12 +153,14 @@ public interface SeekRequestOrBuilder
    *
    *
    * 
-   * The snapshot to seek to. The snapshot's topic must be the same as that of
-   * the provided subscription.
-   * Format is `projects/{project}/snapshots/{snap}`.
+   * Optional. The snapshot to seek to. The snapshot's topic must be the same
+   * as that of the provided subscription. Format is
+   * `projects/{project}/snapshots/{snap}`.
    * 

    *
-   * string snapshot = 3 [(.google.api.resource_reference) = { ... }
+   * 
+   * string snapshot = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The bytes for snapshot.
    */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponse.java
index 141e78c27..de422ae44 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponse.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponse.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponseOrBuilder.java
index 9b2fd097d..0ad90788f 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponseOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SeekResponseOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
index bbf7ea473..ac68f828d 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -84,10 +84,10 @@ protected com.google.protobuf.MapField internalGetMapField(int number) {
    *
    *
    * 
-   * The name of the snapshot.
+   * Optional. The name of the snapshot.
    * 

    *
-   * string name = 1;
+   * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The name.
    */
@@ -107,10 +107,10 @@ public java.lang.String getName() {
    *
    *
    * 
-   * The name of the snapshot.
+   * Optional. The name of the snapshot.
    * 

    *
-   * string name = 1;
+   * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for name.
    */
@@ -135,10 +135,13 @@ public com.google.protobuf.ByteString getNameBytes() {
    *
    *
    * 
-   * The name of the topic from which this snapshot is retaining messages.
+   * Optional. The name of the topic from which this snapshot is retaining
+   * messages.
    * 

    *
-   * string topic = 2 [(.google.api.resource_reference) = { ... }
+   * 
+   * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The topic.
    */
@@ -158,10 +161,13 @@ public java.lang.String getTopic() {
    *
    *
    * 
-   * The name of the topic from which this snapshot is retaining messages.
+   * Optional. The name of the topic from which this snapshot is retaining
+   * messages.
    * 

    *
-   * string topic = 2 [(.google.api.resource_reference) = { ... }
+   * 
+   * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The bytes for topic.
    */
@@ -184,7 +190,7 @@ public com.google.protobuf.ByteString getTopicBytes() {
    *
    *
    * 
-   * The snapshot is guaranteed to exist up until this time.
+   * Optional. The snapshot is guaranteed to exist up until this time.
    * A newly-created snapshot expires no later than 7 days from the time of its
    * creation. Its exact lifetime is determined at creation by the existing
    * backlog in the source subscription. Specifically, the lifetime of the
@@ -196,7 +202,8 @@ public com.google.protobuf.ByteString getTopicBytes() {
    * snapshot that would expire in less than 1 hour after creation.
    * 

    *
-   * .google.protobuf.Timestamp expire_time = 3;
+   * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the expireTime field is set.
    */
@@ -208,7 +215,7 @@ public boolean hasExpireTime() {
    *
    *
    * 
-   * The snapshot is guaranteed to exist up until this time.
+   * Optional. The snapshot is guaranteed to exist up until this time.
    * A newly-created snapshot expires no later than 7 days from the time of its
    * creation. Its exact lifetime is determined at creation by the existing
    * backlog in the source subscription. Specifically, the lifetime of the
@@ -220,7 +227,8 @@ public boolean hasExpireTime() {
    * snapshot that would expire in less than 1 hour after creation.
    * 

    *
-   * .google.protobuf.Timestamp expire_time = 3;
+   * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The expireTime.
    */
@@ -232,7 +240,7 @@ public com.google.protobuf.Timestamp getExpireTime() {
    *
    *
    * 
-   * The snapshot is guaranteed to exist up until this time.
+   * Optional. The snapshot is guaranteed to exist up until this time.
    * A newly-created snapshot expires no later than 7 days from the time of its
    * creation. Its exact lifetime is determined at creation by the existing
    * backlog in the source subscription. Specifically, the lifetime of the
@@ -244,7 +252,8 @@ public com.google.protobuf.Timestamp getExpireTime() {
    * snapshot that would expire in less than 1 hour after creation.
    * 

    *
-   * .google.protobuf.Timestamp expire_time = 3;
+   * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
@@ -281,11 +290,11 @@ public int getLabelsCount() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public boolean containsLabels(java.lang.String key) {
@@ -304,11 +313,11 @@ public java.util.Map getLabels() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public java.util.Map getLabelsMap() {
@@ -318,11 +327,11 @@ public java.util.Map getLabelsMap() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public /* nullable */ java.lang.String getLabelsOrDefault(
@@ -339,11 +348,11 @@ public java.util.Map getLabelsMap() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public java.lang.String getLabelsOrThrow(java.lang.String key) {
@@ -812,10 +821,10 @@ public Builder mergeFrom(
      *
      *
      * 
-     * The name of the snapshot.
+     * Optional. The name of the snapshot.
      * 

      *
-     * string name = 1;
+     * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The name.
      */
@@ -834,10 +843,10 @@ public java.lang.String getName() {
      *
      *
      * 
-     * The name of the snapshot.
+     * Optional. The name of the snapshot.
      * 

      *
-     * string name = 1;
+     * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for name.
      */
@@ -856,10 +865,10 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * 
-     * The name of the snapshot.
+     * Optional. The name of the snapshot.
      * 

      *
-     * string name = 1;
+     * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The name to set.
      * @return This builder for chaining.
@@ -877,10 +886,10 @@ public Builder setName(java.lang.String value) {
      *
      *
      * 
-     * The name of the snapshot.
+     * Optional. The name of the snapshot.
      * 

      *
-     * string name = 1;
+     * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -894,10 +903,10 @@ public Builder clearName() {
      *
      *
      * 
-     * The name of the snapshot.
+     * Optional. The name of the snapshot.
      * 

      *
-     * string name = 1;
+     * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for name to set.
      * @return This builder for chaining.
@@ -918,10 +927,13 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * The name of the topic from which this snapshot is retaining messages.
+     * Optional. The name of the topic from which this snapshot is retaining
+     * messages.
      * 

      *
-     * string topic = 2 [(.google.api.resource_reference) = { ... }
+     * 
+     * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return The topic.
      */
@@ -940,10 +952,13 @@ public java.lang.String getTopic() {
      *
      *
      * 
-     * The name of the topic from which this snapshot is retaining messages.
+     * Optional. The name of the topic from which this snapshot is retaining
+     * messages.
      * 

      *
-     * string topic = 2 [(.google.api.resource_reference) = { ... }
+     * 
+     * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return The bytes for topic.
      */
@@ -962,10 +977,13 @@ public com.google.protobuf.ByteString getTopicBytes() {
      *
      *
      * 
-     * The name of the topic from which this snapshot is retaining messages.
+     * Optional. The name of the topic from which this snapshot is retaining
+     * messages.
      * 

      *
-     * string topic = 2 [(.google.api.resource_reference) = { ... }
+     * 
+     * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @param value The topic to set.
      * @return This builder for chaining.
@@ -983,10 +1001,13 @@ public Builder setTopic(java.lang.String value) {
      *
      *
      * 
-     * The name of the topic from which this snapshot is retaining messages.
+     * Optional. The name of the topic from which this snapshot is retaining
+     * messages.
      * 

      *
-     * string topic = 2 [(.google.api.resource_reference) = { ... }
+     * 
+     * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return This builder for chaining.
      */
@@ -1000,10 +1021,13 @@ public Builder clearTopic() {
      *
      *
      * 
-     * The name of the topic from which this snapshot is retaining messages.
+     * Optional. The name of the topic from which this snapshot is retaining
+     * messages.
      * 

      *
-     * string topic = 2 [(.google.api.resource_reference) = { ... }
+     * 
+     * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @param value The bytes for topic to set.
      * @return This builder for chaining.
@@ -1029,7 +1053,7 @@ public Builder setTopicBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1041,7 +1065,8 @@ public Builder setTopicBytes(com.google.protobuf.ByteString value) {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the expireTime field is set.
      */
@@ -1052,7 +1077,7 @@ public boolean hasExpireTime() {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1064,7 +1089,8 @@ public boolean hasExpireTime() {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The expireTime.
      */
@@ -1081,7 +1107,7 @@ public com.google.protobuf.Timestamp getExpireTime() {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1093,7 +1119,8 @@ public com.google.protobuf.Timestamp getExpireTime() {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setExpireTime(com.google.protobuf.Timestamp value) {
       if (expireTimeBuilder_ == null) {
@@ -1112,7 +1139,7 @@ public Builder setExpireTime(com.google.protobuf.Timestamp value) {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1124,7 +1151,8 @@ public Builder setExpireTime(com.google.protobuf.Timestamp value) {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setExpireTime(com.google.protobuf.Timestamp.Builder builderForValue) {
       if (expireTimeBuilder_ == null) {
@@ -1140,7 +1168,7 @@ public Builder setExpireTime(com.google.protobuf.Timestamp.Builder builderForVal
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1152,7 +1180,8 @@ public Builder setExpireTime(com.google.protobuf.Timestamp.Builder builderForVal
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeExpireTime(com.google.protobuf.Timestamp value) {
       if (expireTimeBuilder_ == null) {
@@ -1174,7 +1203,7 @@ public Builder mergeExpireTime(com.google.protobuf.Timestamp value) {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1186,7 +1215,8 @@ public Builder mergeExpireTime(com.google.protobuf.Timestamp value) {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearExpireTime() {
       bitField0_ = (bitField0_ & ~0x00000004);
@@ -1202,7 +1232,7 @@ public Builder clearExpireTime() {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1214,7 +1244,8 @@ public Builder clearExpireTime() {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder() {
       bitField0_ |= 0x00000004;
@@ -1225,7 +1256,7 @@ public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder() {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1237,7 +1268,8 @@ public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder() {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
       if (expireTimeBuilder_ != null) {
@@ -1252,7 +1284,7 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      *
      *
      * 
-     * The snapshot is guaranteed to exist up until this time.
+     * Optional. The snapshot is guaranteed to exist up until this time.
      * A newly-created snapshot expires no later than 7 days from the time of its
      * creation. Its exact lifetime is determined at creation by the existing
      * backlog in the source subscription. Specifically, the lifetime of the
@@ -1264,7 +1296,8 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      * snapshot that would expire in less than 1 hour after creation.
      * 

      *
-     * .google.protobuf.Timestamp expire_time = 3;
+     * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.Timestamp,
@@ -1312,11 +1345,11 @@ public int getLabelsCount() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 4;
+     * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public boolean containsLabels(java.lang.String key) {
@@ -1335,11 +1368,11 @@ public java.util.Map getLabels() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 4;
+     * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public java.util.Map getLabelsMap() {
@@ -1349,11 +1382,11 @@ public java.util.Map getLabelsMap() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 4;
+     * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public /* nullable */ java.lang.String getLabelsOrDefault(
@@ -1370,11 +1403,11 @@ public java.util.Map getLabelsMap() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 4;
+     * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public java.lang.String getLabelsOrThrow(java.lang.String key) {
@@ -1397,11 +1430,11 @@ public Builder clearLabels() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 4;
+     * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder removeLabels(java.lang.String key) {
       if (key == null) {
@@ -1420,11 +1453,11 @@ public java.util.Map getMutableLabels() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 4;
+     * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder putLabels(java.lang.String key, java.lang.String value) {
       if (key == null) {
@@ -1441,11 +1474,11 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 4;
+     * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder putAllLabels(java.util.Map values) {
       internalGetMutableLabels().getMutableMap().putAll(values);
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
index 89d6b8dbc..44cb3d516 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,10 +27,10 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * The name of the snapshot.
+   * Optional. The name of the snapshot.
    * 

    *
-   * string name = 1;
+   * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The name.
    */
@@ -39,10 +39,10 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * The name of the snapshot.
+   * Optional. The name of the snapshot.
    * 

    *
-   * string name = 1;
+   * string name = 1 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for name.
    */
@@ -52,10 +52,13 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * The name of the topic from which this snapshot is retaining messages.
+   * Optional. The name of the topic from which this snapshot is retaining
+   * messages.
    * 

    *
-   * string topic = 2 [(.google.api.resource_reference) = { ... }
+   * 
+   * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The topic.
    */
@@ -64,10 +67,13 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * The name of the topic from which this snapshot is retaining messages.
+   * Optional. The name of the topic from which this snapshot is retaining
+   * messages.
    * 

    *
-   * string topic = 2 [(.google.api.resource_reference) = { ... }
+   * 
+   * string topic = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The bytes for topic.
    */
@@ -77,7 +83,7 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * The snapshot is guaranteed to exist up until this time.
+   * Optional. The snapshot is guaranteed to exist up until this time.
    * A newly-created snapshot expires no later than 7 days from the time of its
    * creation. Its exact lifetime is determined at creation by the existing
    * backlog in the source subscription. Specifically, the lifetime of the
@@ -89,7 +95,8 @@ public interface SnapshotOrBuilder
    * snapshot that would expire in less than 1 hour after creation.
    * 

    *
-   * .google.protobuf.Timestamp expire_time = 3;
+   * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the expireTime field is set.
    */
@@ -98,7 +105,7 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * The snapshot is guaranteed to exist up until this time.
+   * Optional. The snapshot is guaranteed to exist up until this time.
    * A newly-created snapshot expires no later than 7 days from the time of its
    * creation. Its exact lifetime is determined at creation by the existing
    * backlog in the source subscription. Specifically, the lifetime of the
@@ -110,7 +117,8 @@ public interface SnapshotOrBuilder
    * snapshot that would expire in less than 1 hour after creation.
    * 

    *
-   * .google.protobuf.Timestamp expire_time = 3;
+   * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The expireTime.
    */
@@ -119,7 +127,7 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * The snapshot is guaranteed to exist up until this time.
+   * Optional. The snapshot is guaranteed to exist up until this time.
    * A newly-created snapshot expires no later than 7 days from the time of its
    * creation. Its exact lifetime is determined at creation by the existing
    * backlog in the source subscription. Specifically, the lifetime of the
@@ -131,7 +139,8 @@ public interface SnapshotOrBuilder
    * snapshot that would expire in less than 1 hour after creation.
    * 

    *
-   * .google.protobuf.Timestamp expire_time = 3;
+   * .google.protobuf.Timestamp expire_time = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder();
 
@@ -139,22 +148,22 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   int getLabelsCount();
   /**
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   boolean containsLabels(java.lang.String key);
   /** Use {@link #getLabelsMap()} instead. */
@@ -164,22 +173,22 @@ public interface SnapshotOrBuilder
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   java.util.Map getLabelsMap();
   /**
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   /* nullable */
   java.lang.String getLabelsOrDefault(
@@ -190,11 +199,11 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 4;
+   * map<string, string> labels = 4 [(.google.api.field_behavior) = OPTIONAL];
    */
   java.lang.String getLabelsOrThrow(java.lang.String key);
 }
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequest.java
index 20d715043..cca885333 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -138,14 +138,15 @@ public com.google.protobuf.ByteString getSubscriptionBytes() {
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return A list containing the ackIds.
    */
@@ -156,14 +157,15 @@ public com.google.protobuf.ProtocolStringList getAckIdsList() {
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The count of ackIds.
    */
@@ -174,14 +176,15 @@ public int getAckIdsCount() {
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @param index The index of the element to return.
    * @return The ackIds at the given index.
@@ -193,14 +196,15 @@ public java.lang.String getAckIds(int index) {
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @param index The index of the value to return.
    * @return The bytes of the ackIds at the given index.
@@ -217,7 +221,7 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
    *
    *
    * 
-   * The list of new ack deadlines for the IDs listed in
+   * Optional. The list of new ack deadlines for the IDs listed in
    * `modify_deadline_ack_ids`. The size of this list must be the same as the
    * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
    * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -230,7 +234,8 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
    * be aborted with status `INVALID_ARGUMENT`.
    * 

    *
-   * repeated int32 modify_deadline_seconds = 3;
+   * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return A list containing the modifyDeadlineSeconds.
    */
@@ -242,7 +247,7 @@ public java.util.List getModifyDeadlineSecondsList() {
    *
    *
    * 
-   * The list of new ack deadlines for the IDs listed in
+   * Optional. The list of new ack deadlines for the IDs listed in
    * `modify_deadline_ack_ids`. The size of this list must be the same as the
    * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
    * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -255,7 +260,8 @@ public java.util.List getModifyDeadlineSecondsList() {
    * be aborted with status `INVALID_ARGUMENT`.
    * 

    *
-   * repeated int32 modify_deadline_seconds = 3;
+   * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The count of modifyDeadlineSeconds.
    */
@@ -266,7 +272,7 @@ public int getModifyDeadlineSecondsCount() {
    *
    *
    * 
-   * The list of new ack deadlines for the IDs listed in
+   * Optional. The list of new ack deadlines for the IDs listed in
    * `modify_deadline_ack_ids`. The size of this list must be the same as the
    * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
    * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -279,7 +285,8 @@ public int getModifyDeadlineSecondsCount() {
    * be aborted with status `INVALID_ARGUMENT`.
    * 

    *
-   * repeated int32 modify_deadline_seconds = 3;
+   * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @param index The index of the element to return.
    * @return The modifyDeadlineSeconds at the given index.
@@ -299,14 +306,15 @@ public int getModifyDeadlineSeconds(int index) {
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return A list containing the modifyDeadlineAckIds.
    */
@@ -317,14 +325,15 @@ public com.google.protobuf.ProtocolStringList getModifyDeadlineAckIdsList() {
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The count of modifyDeadlineAckIds.
    */
@@ -335,14 +344,15 @@ public int getModifyDeadlineAckIdsCount() {
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @param index The index of the element to return.
    * @return The modifyDeadlineAckIds at the given index.
@@ -354,14 +364,15 @@ public java.lang.String getModifyDeadlineAckIds(int index) {
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @param index The index of the value to return.
    * @return The bytes of the modifyDeadlineAckIds at the given index.
@@ -399,15 +410,15 @@ public int getStreamAckDeadlineSeconds() {
    *
    *
    * 
-   * A unique identifier that is used to distinguish client instances from each
-   * other. Only needs to be provided on the initial request. When a stream
-   * disconnects and reconnects for the same stream, the client_id should be set
-   * to the same value so that state associated with the old stream can be
-   * transferred to the new stream. The same client_id should not be used for
+   * Optional. A unique identifier that is used to distinguish client instances
+   * from each other. Only needs to be provided on the initial request. When a
+   * stream disconnects and reconnects for the same stream, the client_id should
+   * be set to the same value so that state associated with the old stream can
+   * be transferred to the new stream. The same client_id should not be used for
    * different client instances.
    * 

    *
-   * string client_id = 6;
+   * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The clientId.
    */
@@ -427,15 +438,15 @@ public java.lang.String getClientId() {
    *
    *
    * 
-   * A unique identifier that is used to distinguish client instances from each
-   * other. Only needs to be provided on the initial request. When a stream
-   * disconnects and reconnects for the same stream, the client_id should be set
-   * to the same value so that state associated with the old stream can be
-   * transferred to the new stream. The same client_id should not be used for
+   * Optional. A unique identifier that is used to distinguish client instances
+   * from each other. Only needs to be provided on the initial request. When a
+   * stream disconnects and reconnects for the same stream, the client_id should
+   * be set to the same value so that state associated with the old stream can
+   * be transferred to the new stream. The same client_id should not be used for
    * different client instances.
    * 

    *
-   * string client_id = 6;
+   * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for clientId.
    */
@@ -458,8 +469,8 @@ public com.google.protobuf.ByteString getClientIdBytes() {
    *
    *
    * 
-   * Flow control settings for the maximum number of outstanding messages. When
-   * there are `max_outstanding_messages` or more currently sent to the
+   * Optional. Flow control settings for the maximum number of outstanding
+   * messages. When there are `max_outstanding_messages` currently sent to the
    * streaming pull client that have not yet been acked or nacked, the server
    * stops sending more messages. The sending of messages resumes once the
    * number of outstanding messages is less than this value. If the value is
@@ -469,7 +480,7 @@ public com.google.protobuf.ByteString getClientIdBytes() {
    * `INVALID_ARGUMENT`.
    * 

    *
-   * int64 max_outstanding_messages = 7;
+   * int64 max_outstanding_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The maxOutstandingMessages.
    */
@@ -484,18 +495,18 @@ public long getMaxOutstandingMessages() {
    *
    *
    * 
-   * Flow control settings for the maximum number of outstanding bytes. When
-   * there are `max_outstanding_bytes` or more worth of messages currently sent
-   * to the streaming pull client that have not yet been acked or nacked, the
-   * server will stop sending more messages. The sending of messages resumes
-   * once the number of outstanding bytes is less than this value. If the value
-   * is <= 0, there is no limit to the number of outstanding bytes. This
-   * property can only be set on the initial StreamingPullRequest. If it is set
-   * on a subsequent request, the stream will be aborted with status
+   * Optional. Flow control settings for the maximum number of outstanding
+   * bytes. When there are `max_outstanding_bytes` or more worth of messages
+   * currently sent to the streaming pull client that have not yet been acked or
+   * nacked, the server will stop sending more messages. The sending of messages
+   * resumes once the number of outstanding bytes is less than this value. If
+   * the value is <= 0, there is no limit to the number of outstanding bytes.
+   * This property can only be set on the initial StreamingPullRequest. If it is
+   * set on a subsequent request, the stream will be aborted with status
    * `INVALID_ARGUMENT`.
    * 

    *
-   * int64 max_outstanding_bytes = 8;
+   * int64 max_outstanding_bytes = 8 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The maxOutstandingBytes.
    */
@@ -1223,14 +1234,15 @@ private void ensureAckIdsIsMutable() {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the ackIds.
      */
@@ -1242,14 +1254,15 @@ public com.google.protobuf.ProtocolStringList getAckIdsList() {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of ackIds.
      */
@@ -1260,14 +1273,15 @@ public int getAckIdsCount() {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The ackIds at the given index.
@@ -1279,14 +1293,15 @@ public java.lang.String getAckIds(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the ackIds at the given index.
@@ -1298,14 +1313,15 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index to set the value at.
      * @param value The ackIds to set.
@@ -1325,14 +1341,15 @@ public Builder setAckIds(int index, java.lang.String value) {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The ackIds to add.
      * @return This builder for chaining.
@@ -1351,14 +1368,15 @@ public Builder addAckIds(java.lang.String value) {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param values The ackIds to add.
      * @return This builder for chaining.
@@ -1374,14 +1392,15 @@ public Builder addAllAckIds(java.lang.Iterable values) {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -1396,14 +1415,15 @@ public Builder clearAckIds() {
      *
      *
      * 
-     * List of acknowledgement IDs for acknowledging previously received messages
-     * (received on this stream or a different stream). If an ack ID has expired,
-     * the corresponding message may be redelivered later. Acknowledging a message
-     * more than once will not result in an error. If the acknowledgement ID is
-     * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+     * Optional. List of acknowledgement IDs for acknowledging previously received
+     * messages (received on this stream or a different stream). If an ack ID has
+     * expired, the corresponding message may be redelivered later. Acknowledging
+     * a message more than once will not result in an error. If the
+     * acknowledgement ID is malformed, the stream will be aborted with status
+     * `INVALID_ARGUMENT`.
      * 

      *
-     * repeated string ack_ids = 2;
+     * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes of the ackIds to add.
      * @return This builder for chaining.
@@ -1432,7 +1452,7 @@ private void ensureModifyDeadlineSecondsIsMutable() {
      *
      *
      * 
-     * The list of new ack deadlines for the IDs listed in
+     * Optional. The list of new ack deadlines for the IDs listed in
      * `modify_deadline_ack_ids`. The size of this list must be the same as the
      * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
      * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1445,7 +1465,8 @@ private void ensureModifyDeadlineSecondsIsMutable() {
      * be aborted with status `INVALID_ARGUMENT`.
      * 

      *
-     * repeated int32 modify_deadline_seconds = 3;
+     * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return A list containing the modifyDeadlineSeconds.
      */
@@ -1458,7 +1479,7 @@ public java.util.List getModifyDeadlineSecondsList() {
      *
      *
      * 
-     * The list of new ack deadlines for the IDs listed in
+     * Optional. The list of new ack deadlines for the IDs listed in
      * `modify_deadline_ack_ids`. The size of this list must be the same as the
      * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
      * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1471,7 +1492,8 @@ public java.util.List getModifyDeadlineSecondsList() {
      * be aborted with status `INVALID_ARGUMENT`.
      * 

      *
-     * repeated int32 modify_deadline_seconds = 3;
+     * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The count of modifyDeadlineSeconds.
      */
@@ -1482,7 +1504,7 @@ public int getModifyDeadlineSecondsCount() {
      *
      *
      * 
-     * The list of new ack deadlines for the IDs listed in
+     * Optional. The list of new ack deadlines for the IDs listed in
      * `modify_deadline_ack_ids`. The size of this list must be the same as the
      * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
      * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1495,7 +1517,8 @@ public int getModifyDeadlineSecondsCount() {
      * be aborted with status `INVALID_ARGUMENT`.
      * 

      *
-     * repeated int32 modify_deadline_seconds = 3;
+     * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the element to return.
      * @return The modifyDeadlineSeconds at the given index.
@@ -1507,7 +1530,7 @@ public int getModifyDeadlineSeconds(int index) {
      *
      *
      * 
-     * The list of new ack deadlines for the IDs listed in
+     * Optional. The list of new ack deadlines for the IDs listed in
      * `modify_deadline_ack_ids`. The size of this list must be the same as the
      * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
      * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1520,7 +1543,8 @@ public int getModifyDeadlineSeconds(int index) {
      * be aborted with status `INVALID_ARGUMENT`.
      * 

      *
-     * repeated int32 modify_deadline_seconds = 3;
+     * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index to set the value at.
      * @param value The modifyDeadlineSeconds to set.
@@ -1537,7 +1561,7 @@ public Builder setModifyDeadlineSeconds(int index, int value) {
      *
      *
      * 
-     * The list of new ack deadlines for the IDs listed in
+     * Optional. The list of new ack deadlines for the IDs listed in
      * `modify_deadline_ack_ids`. The size of this list must be the same as the
      * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
      * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1550,7 +1574,8 @@ public Builder setModifyDeadlineSeconds(int index, int value) {
      * be aborted with status `INVALID_ARGUMENT`.
      * 

      *
-     * repeated int32 modify_deadline_seconds = 3;
+     * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param value The modifyDeadlineSeconds to add.
      * @return This builder for chaining.
@@ -1566,7 +1591,7 @@ public Builder addModifyDeadlineSeconds(int value) {
      *
      *
      * 
-     * The list of new ack deadlines for the IDs listed in
+     * Optional. The list of new ack deadlines for the IDs listed in
      * `modify_deadline_ack_ids`. The size of this list must be the same as the
      * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
      * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1579,7 +1604,8 @@ public Builder addModifyDeadlineSeconds(int value) {
      * be aborted with status `INVALID_ARGUMENT`.
      * 

      *
-     * repeated int32 modify_deadline_seconds = 3;
+     * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param values The modifyDeadlineSeconds to add.
      * @return This builder for chaining.
@@ -1595,7 +1621,7 @@ public Builder addAllModifyDeadlineSeconds(
      *
      *
      * 
-     * The list of new ack deadlines for the IDs listed in
+     * Optional. The list of new ack deadlines for the IDs listed in
      * `modify_deadline_ack_ids`. The size of this list must be the same as the
      * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
      * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1608,7 +1634,8 @@ public Builder addAllModifyDeadlineSeconds(
      * be aborted with status `INVALID_ARGUMENT`.
      * 

      *
-     * repeated int32 modify_deadline_seconds = 3;
+     * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return This builder for chaining.
      */
@@ -1632,14 +1659,15 @@ private void ensureModifyDeadlineAckIdsIsMutable() {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return A list containing the modifyDeadlineAckIds.
      */
@@ -1651,14 +1679,15 @@ public com.google.protobuf.ProtocolStringList getModifyDeadlineAckIdsList() {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The count of modifyDeadlineAckIds.
      */
@@ -1669,14 +1698,15 @@ public int getModifyDeadlineAckIdsCount() {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the element to return.
      * @return The modifyDeadlineAckIds at the given index.
@@ -1688,14 +1718,15 @@ public java.lang.String getModifyDeadlineAckIds(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the value to return.
      * @return The bytes of the modifyDeadlineAckIds at the given index.
@@ -1707,14 +1738,15 @@ public com.google.protobuf.ByteString getModifyDeadlineAckIdsBytes(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index to set the value at.
      * @param value The modifyDeadlineAckIds to set.
@@ -1734,14 +1766,15 @@ public Builder setModifyDeadlineAckIds(int index, java.lang.String value) {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param value The modifyDeadlineAckIds to add.
      * @return This builder for chaining.
@@ -1760,14 +1793,15 @@ public Builder addModifyDeadlineAckIds(java.lang.String value) {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param values The modifyDeadlineAckIds to add.
      * @return This builder for chaining.
@@ -1783,14 +1817,15 @@ public Builder addAllModifyDeadlineAckIds(java.lang.Iterable v
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return This builder for chaining.
      */
@@ -1805,14 +1840,15 @@ public Builder clearModifyDeadlineAckIds() {
      *
      *
      * 
-     * List of acknowledgement IDs whose deadline will be modified based on the
-     * corresponding element in `modify_deadline_seconds`. This field can be used
-     * to indicate that more time is needed to process a message by the
+     * Optional. List of acknowledgement IDs whose deadline will be modified based
+     * on the corresponding element in `modify_deadline_seconds`. This field can
+     * be used to indicate that more time is needed to process a message by the
      * subscriber, or to make the message available for redelivery if the
      * processing was interrupted.
      * 

      *
-     * repeated string modify_deadline_ack_ids = 4;
+     * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param value The bytes of the modifyDeadlineAckIds to add.
      * @return This builder for chaining.
@@ -1896,15 +1932,15 @@ public Builder clearStreamAckDeadlineSeconds() {
      *
      *
      * 
-     * A unique identifier that is used to distinguish client instances from each
-     * other. Only needs to be provided on the initial request. When a stream
-     * disconnects and reconnects for the same stream, the client_id should be set
-     * to the same value so that state associated with the old stream can be
-     * transferred to the new stream. The same client_id should not be used for
+     * Optional. A unique identifier that is used to distinguish client instances
+     * from each other. Only needs to be provided on the initial request. When a
+     * stream disconnects and reconnects for the same stream, the client_id should
+     * be set to the same value so that state associated with the old stream can
+     * be transferred to the new stream. The same client_id should not be used for
      * different client instances.
      * 

      *
-     * string client_id = 6;
+     * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The clientId.
      */
@@ -1923,15 +1959,15 @@ public java.lang.String getClientId() {
      *
      *
      * 
-     * A unique identifier that is used to distinguish client instances from each
-     * other. Only needs to be provided on the initial request. When a stream
-     * disconnects and reconnects for the same stream, the client_id should be set
-     * to the same value so that state associated with the old stream can be
-     * transferred to the new stream. The same client_id should not be used for
+     * Optional. A unique identifier that is used to distinguish client instances
+     * from each other. Only needs to be provided on the initial request. When a
+     * stream disconnects and reconnects for the same stream, the client_id should
+     * be set to the same value so that state associated with the old stream can
+     * be transferred to the new stream. The same client_id should not be used for
      * different client instances.
      * 

      *
-     * string client_id = 6;
+     * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for clientId.
      */
@@ -1950,15 +1986,15 @@ public com.google.protobuf.ByteString getClientIdBytes() {
      *
      *
      * 
-     * A unique identifier that is used to distinguish client instances from each
-     * other. Only needs to be provided on the initial request. When a stream
-     * disconnects and reconnects for the same stream, the client_id should be set
-     * to the same value so that state associated with the old stream can be
-     * transferred to the new stream. The same client_id should not be used for
+     * Optional. A unique identifier that is used to distinguish client instances
+     * from each other. Only needs to be provided on the initial request. When a
+     * stream disconnects and reconnects for the same stream, the client_id should
+     * be set to the same value so that state associated with the old stream can
+     * be transferred to the new stream. The same client_id should not be used for
      * different client instances.
      * 

      *
-     * string client_id = 6;
+     * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The clientId to set.
      * @return This builder for chaining.
@@ -1976,15 +2012,15 @@ public Builder setClientId(java.lang.String value) {
      *
      *
      * 
-     * A unique identifier that is used to distinguish client instances from each
-     * other. Only needs to be provided on the initial request. When a stream
-     * disconnects and reconnects for the same stream, the client_id should be set
-     * to the same value so that state associated with the old stream can be
-     * transferred to the new stream. The same client_id should not be used for
+     * Optional. A unique identifier that is used to distinguish client instances
+     * from each other. Only needs to be provided on the initial request. When a
+     * stream disconnects and reconnects for the same stream, the client_id should
+     * be set to the same value so that state associated with the old stream can
+     * be transferred to the new stream. The same client_id should not be used for
      * different client instances.
      * 

      *
-     * string client_id = 6;
+     * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -1998,15 +2034,15 @@ public Builder clearClientId() {
      *
      *
      * 
-     * A unique identifier that is used to distinguish client instances from each
-     * other. Only needs to be provided on the initial request. When a stream
-     * disconnects and reconnects for the same stream, the client_id should be set
-     * to the same value so that state associated with the old stream can be
-     * transferred to the new stream. The same client_id should not be used for
+     * Optional. A unique identifier that is used to distinguish client instances
+     * from each other. Only needs to be provided on the initial request. When a
+     * stream disconnects and reconnects for the same stream, the client_id should
+     * be set to the same value so that state associated with the old stream can
+     * be transferred to the new stream. The same client_id should not be used for
      * different client instances.
      * 

      *
-     * string client_id = 6;
+     * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for clientId to set.
      * @return This builder for chaining.
@@ -2027,8 +2063,8 @@ public Builder setClientIdBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Flow control settings for the maximum number of outstanding messages. When
-     * there are `max_outstanding_messages` or more currently sent to the
+     * Optional. Flow control settings for the maximum number of outstanding
+     * messages. When there are `max_outstanding_messages` currently sent to the
      * streaming pull client that have not yet been acked or nacked, the server
      * stops sending more messages. The sending of messages resumes once the
      * number of outstanding messages is less than this value. If the value is
@@ -2038,7 +2074,7 @@ public Builder setClientIdBytes(com.google.protobuf.ByteString value) {
      * `INVALID_ARGUMENT`.
      * 

      *
-     * int64 max_outstanding_messages = 7;
+     * int64 max_outstanding_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The maxOutstandingMessages.
      */
@@ -2050,8 +2086,8 @@ public long getMaxOutstandingMessages() {
      *
      *
      * 
-     * Flow control settings for the maximum number of outstanding messages. When
-     * there are `max_outstanding_messages` or more currently sent to the
+     * Optional. Flow control settings for the maximum number of outstanding
+     * messages. When there are `max_outstanding_messages` currently sent to the
      * streaming pull client that have not yet been acked or nacked, the server
      * stops sending more messages. The sending of messages resumes once the
      * number of outstanding messages is less than this value. If the value is
@@ -2061,7 +2097,7 @@ public long getMaxOutstandingMessages() {
      * `INVALID_ARGUMENT`.
      * 

      *
-     * int64 max_outstanding_messages = 7;
+     * int64 max_outstanding_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The maxOutstandingMessages to set.
      * @return This builder for chaining.
@@ -2077,8 +2113,8 @@ public Builder setMaxOutstandingMessages(long value) {
      *
      *
      * 
-     * Flow control settings for the maximum number of outstanding messages. When
-     * there are `max_outstanding_messages` or more currently sent to the
+     * Optional. Flow control settings for the maximum number of outstanding
+     * messages. When there are `max_outstanding_messages` currently sent to the
      * streaming pull client that have not yet been acked or nacked, the server
      * stops sending more messages. The sending of messages resumes once the
      * number of outstanding messages is less than this value. If the value is
@@ -2088,7 +2124,7 @@ public Builder setMaxOutstandingMessages(long value) {
      * `INVALID_ARGUMENT`.
      * 

      *
-     * int64 max_outstanding_messages = 7;
+     * int64 max_outstanding_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -2104,18 +2140,18 @@ public Builder clearMaxOutstandingMessages() {
      *
      *
      * 
-     * Flow control settings for the maximum number of outstanding bytes. When
-     * there are `max_outstanding_bytes` or more worth of messages currently sent
-     * to the streaming pull client that have not yet been acked or nacked, the
-     * server will stop sending more messages. The sending of messages resumes
-     * once the number of outstanding bytes is less than this value. If the value
-     * is <= 0, there is no limit to the number of outstanding bytes. This
-     * property can only be set on the initial StreamingPullRequest. If it is set
-     * on a subsequent request, the stream will be aborted with status
+     * Optional. Flow control settings for the maximum number of outstanding
+     * bytes. When there are `max_outstanding_bytes` or more worth of messages
+     * currently sent to the streaming pull client that have not yet been acked or
+     * nacked, the server will stop sending more messages. The sending of messages
+     * resumes once the number of outstanding bytes is less than this value. If
+     * the value is <= 0, there is no limit to the number of outstanding bytes.
+     * This property can only be set on the initial StreamingPullRequest. If it is
+     * set on a subsequent request, the stream will be aborted with status
      * `INVALID_ARGUMENT`.
      * 

      *
-     * int64 max_outstanding_bytes = 8;
+     * int64 max_outstanding_bytes = 8 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The maxOutstandingBytes.
      */
@@ -2127,18 +2163,18 @@ public long getMaxOutstandingBytes() {
      *
      *
      * 
-     * Flow control settings for the maximum number of outstanding bytes. When
-     * there are `max_outstanding_bytes` or more worth of messages currently sent
-     * to the streaming pull client that have not yet been acked or nacked, the
-     * server will stop sending more messages. The sending of messages resumes
-     * once the number of outstanding bytes is less than this value. If the value
-     * is <= 0, there is no limit to the number of outstanding bytes. This
-     * property can only be set on the initial StreamingPullRequest. If it is set
-     * on a subsequent request, the stream will be aborted with status
+     * Optional. Flow control settings for the maximum number of outstanding
+     * bytes. When there are `max_outstanding_bytes` or more worth of messages
+     * currently sent to the streaming pull client that have not yet been acked or
+     * nacked, the server will stop sending more messages. The sending of messages
+     * resumes once the number of outstanding bytes is less than this value. If
+     * the value is <= 0, there is no limit to the number of outstanding bytes.
+     * This property can only be set on the initial StreamingPullRequest. If it is
+     * set on a subsequent request, the stream will be aborted with status
      * `INVALID_ARGUMENT`.
      * 

      *
-     * int64 max_outstanding_bytes = 8;
+     * int64 max_outstanding_bytes = 8 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The maxOutstandingBytes to set.
      * @return This builder for chaining.
@@ -2154,18 +2190,18 @@ public Builder setMaxOutstandingBytes(long value) {
      *
      *
      * 
-     * Flow control settings for the maximum number of outstanding bytes. When
-     * there are `max_outstanding_bytes` or more worth of messages currently sent
-     * to the streaming pull client that have not yet been acked or nacked, the
-     * server will stop sending more messages. The sending of messages resumes
-     * once the number of outstanding bytes is less than this value. If the value
-     * is <= 0, there is no limit to the number of outstanding bytes. This
-     * property can only be set on the initial StreamingPullRequest. If it is set
-     * on a subsequent request, the stream will be aborted with status
+     * Optional. Flow control settings for the maximum number of outstanding
+     * bytes. When there are `max_outstanding_bytes` or more worth of messages
+     * currently sent to the streaming pull client that have not yet been acked or
+     * nacked, the server will stop sending more messages. The sending of messages
+     * resumes once the number of outstanding bytes is less than this value. If
+     * the value is <= 0, there is no limit to the number of outstanding bytes.
+     * This property can only be set on the initial StreamingPullRequest. If it is
+     * set on a subsequent request, the stream will be aborted with status
      * `INVALID_ARGUMENT`.
      * 

      *
-     * int64 max_outstanding_bytes = 8;
+     * int64 max_outstanding_bytes = 8 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequestOrBuilder.java
index 1a8ca38b5..4a35dfcb9 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -62,14 +62,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return A list containing the ackIds.
    */
@@ -78,14 +79,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The count of ackIds.
    */
@@ -94,14 +96,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @param index The index of the element to return.
    * @return The ackIds at the given index.
@@ -111,14 +114,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs for acknowledging previously received messages
-   * (received on this stream or a different stream). If an ack ID has expired,
-   * the corresponding message may be redelivered later. Acknowledging a message
-   * more than once will not result in an error. If the acknowledgement ID is
-   * malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+   * Optional. List of acknowledgement IDs for acknowledging previously received
+   * messages (received on this stream or a different stream). If an ack ID has
+   * expired, the corresponding message may be redelivered later. Acknowledging
+   * a message more than once will not result in an error. If the
+   * acknowledgement ID is malformed, the stream will be aborted with status
+   * `INVALID_ARGUMENT`.
    * 

    *
-   * repeated string ack_ids = 2;
+   * repeated string ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @param index The index of the value to return.
    * @return The bytes of the ackIds at the given index.
@@ -129,7 +133,7 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * The list of new ack deadlines for the IDs listed in
+   * Optional. The list of new ack deadlines for the IDs listed in
    * `modify_deadline_ack_ids`. The size of this list must be the same as the
    * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
    * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -142,7 +146,8 @@ public interface StreamingPullRequestOrBuilder
    * be aborted with status `INVALID_ARGUMENT`.
    * 

    *
-   * repeated int32 modify_deadline_seconds = 3;
+   * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return A list containing the modifyDeadlineSeconds.
    */
@@ -151,7 +156,7 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * The list of new ack deadlines for the IDs listed in
+   * Optional. The list of new ack deadlines for the IDs listed in
    * `modify_deadline_ack_ids`. The size of this list must be the same as the
    * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
    * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -164,7 +169,8 @@ public interface StreamingPullRequestOrBuilder
    * be aborted with status `INVALID_ARGUMENT`.
    * 

    *
-   * repeated int32 modify_deadline_seconds = 3;
+   * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The count of modifyDeadlineSeconds.
    */
@@ -173,7 +179,7 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * The list of new ack deadlines for the IDs listed in
+   * Optional. The list of new ack deadlines for the IDs listed in
    * `modify_deadline_ack_ids`. The size of this list must be the same as the
    * size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
    * with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -186,7 +192,8 @@ public interface StreamingPullRequestOrBuilder
    * be aborted with status `INVALID_ARGUMENT`.
    * 

    *
-   * repeated int32 modify_deadline_seconds = 3;
+   * repeated int32 modify_deadline_seconds = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @param index The index of the element to return.
    * @return The modifyDeadlineSeconds at the given index.
@@ -197,14 +204,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return A list containing the modifyDeadlineAckIds.
    */
@@ -213,14 +221,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The count of modifyDeadlineAckIds.
    */
@@ -229,14 +238,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @param index The index of the element to return.
    * @return The modifyDeadlineAckIds at the given index.
@@ -246,14 +256,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * List of acknowledgement IDs whose deadline will be modified based on the
-   * corresponding element in `modify_deadline_seconds`. This field can be used
-   * to indicate that more time is needed to process a message by the
+   * Optional. List of acknowledgement IDs whose deadline will be modified based
+   * on the corresponding element in `modify_deadline_seconds`. This field can
+   * be used to indicate that more time is needed to process a message by the
    * subscriber, or to make the message available for redelivery if the
    * processing was interrupted.
    * 

    *
-   * repeated string modify_deadline_ack_ids = 4;
+   * repeated string modify_deadline_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @param index The index of the value to return.
    * @return The bytes of the modifyDeadlineAckIds at the given index.
@@ -280,15 +291,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * A unique identifier that is used to distinguish client instances from each
-   * other. Only needs to be provided on the initial request. When a stream
-   * disconnects and reconnects for the same stream, the client_id should be set
-   * to the same value so that state associated with the old stream can be
-   * transferred to the new stream. The same client_id should not be used for
+   * Optional. A unique identifier that is used to distinguish client instances
+   * from each other. Only needs to be provided on the initial request. When a
+   * stream disconnects and reconnects for the same stream, the client_id should
+   * be set to the same value so that state associated with the old stream can
+   * be transferred to the new stream. The same client_id should not be used for
    * different client instances.
    * 

    *
-   * string client_id = 6;
+   * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The clientId.
    */
@@ -297,15 +308,15 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * A unique identifier that is used to distinguish client instances from each
-   * other. Only needs to be provided on the initial request. When a stream
-   * disconnects and reconnects for the same stream, the client_id should be set
-   * to the same value so that state associated with the old stream can be
-   * transferred to the new stream. The same client_id should not be used for
+   * Optional. A unique identifier that is used to distinguish client instances
+   * from each other. Only needs to be provided on the initial request. When a
+   * stream disconnects and reconnects for the same stream, the client_id should
+   * be set to the same value so that state associated with the old stream can
+   * be transferred to the new stream. The same client_id should not be used for
    * different client instances.
    * 

    *
-   * string client_id = 6;
+   * string client_id = 6 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for clientId.
    */
@@ -315,8 +326,8 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * Flow control settings for the maximum number of outstanding messages. When
-   * there are `max_outstanding_messages` or more currently sent to the
+   * Optional. Flow control settings for the maximum number of outstanding
+   * messages. When there are `max_outstanding_messages` currently sent to the
    * streaming pull client that have not yet been acked or nacked, the server
    * stops sending more messages. The sending of messages resumes once the
    * number of outstanding messages is less than this value. If the value is
@@ -326,7 +337,7 @@ public interface StreamingPullRequestOrBuilder
    * `INVALID_ARGUMENT`.
    * 

    *
-   * int64 max_outstanding_messages = 7;
+   * int64 max_outstanding_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The maxOutstandingMessages.
    */
@@ -336,18 +347,18 @@ public interface StreamingPullRequestOrBuilder
    *
    *
    * 
-   * Flow control settings for the maximum number of outstanding bytes. When
-   * there are `max_outstanding_bytes` or more worth of messages currently sent
-   * to the streaming pull client that have not yet been acked or nacked, the
-   * server will stop sending more messages. The sending of messages resumes
-   * once the number of outstanding bytes is less than this value. If the value
-   * is <= 0, there is no limit to the number of outstanding bytes. This
-   * property can only be set on the initial StreamingPullRequest. If it is set
-   * on a subsequent request, the stream will be aborted with status
+   * Optional. Flow control settings for the maximum number of outstanding
+   * bytes. When there are `max_outstanding_bytes` or more worth of messages
+   * currently sent to the streaming pull client that have not yet been acked or
+   * nacked, the server will stop sending more messages. The sending of messages
+   * resumes once the number of outstanding bytes is less than this value. If
+   * the value is <= 0, there is no limit to the number of outstanding bytes.
+   * This property can only be set on the initial StreamingPullRequest. If it is
+   * set on a subsequent request, the stream will be aborted with status
    * `INVALID_ARGUMENT`.
    * 

    *
-   * int64 max_outstanding_bytes = 8;
+   * int64 max_outstanding_bytes = 8 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The maxOutstandingBytes.
    */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponse.java
index 52505da10..98c34b9fd 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponse.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponse.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -72,10 +72,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the ackIds.
      */
@@ -84,10 +84,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of ackIds.
      */
@@ -96,10 +96,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The ackIds at the given index.
@@ -109,10 +109,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the ackIds at the given index.
@@ -123,11 +123,11 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the invalidAckIds.
      */
@@ -136,11 +136,11 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of invalidAckIds.
      */
@@ -149,11 +149,11 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The invalidAckIds at the given index.
@@ -163,11 +163,11 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the invalidAckIds at the given index.
@@ -178,10 +178,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the unorderedAckIds.
      */
@@ -190,10 +190,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of unorderedAckIds.
      */
@@ -202,10 +202,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The unorderedAckIds at the given index.
@@ -215,10 +215,10 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the unorderedAckIds at the given index.
@@ -229,10 +229,12 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return A list containing the temporaryFailedAckIds.
      */
@@ -241,10 +243,12 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The count of temporaryFailedAckIds.
      */
@@ -253,10 +257,12 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the element to return.
      * @return The temporaryFailedAckIds at the given index.
@@ -266,10 +272,12 @@ public interface AcknowledgeConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the value to return.
      * @return The bytes of the temporaryFailedAckIds at the given index.
@@ -333,10 +341,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the ackIds.
      */
@@ -347,10 +355,10 @@ public com.google.protobuf.ProtocolStringList getAckIdsList() {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of ackIds.
      */
@@ -361,10 +369,10 @@ public int getAckIdsCount() {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The ackIds at the given index.
@@ -376,10 +384,10 @@ public java.lang.String getAckIds(int index) {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the ackIds at the given index.
@@ -397,11 +405,11 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the invalidAckIds.
      */
@@ -412,11 +420,11 @@ public com.google.protobuf.ProtocolStringList getInvalidAckIdsList() {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of invalidAckIds.
      */
@@ -427,11 +435,11 @@ public int getInvalidAckIdsCount() {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The invalidAckIds at the given index.
@@ -443,11 +451,11 @@ public java.lang.String getInvalidAckIds(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the invalidAckIds at the given index.
@@ -465,10 +473,10 @@ public com.google.protobuf.ByteString getInvalidAckIdsBytes(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the unorderedAckIds.
      */
@@ -479,10 +487,10 @@ public com.google.protobuf.ProtocolStringList getUnorderedAckIdsList() {
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of unorderedAckIds.
      */
@@ -493,10 +501,10 @@ public int getUnorderedAckIdsCount() {
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The unorderedAckIds at the given index.
@@ -508,10 +516,10 @@ public java.lang.String getUnorderedAckIds(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that were out of order.
+     * Optional. List of acknowledgement IDs that were out of order.
      * 

      *
-     * repeated string unordered_ack_ids = 3;
+     * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the unorderedAckIds at the given index.
@@ -529,10 +537,12 @@ public com.google.protobuf.ByteString getUnorderedAckIdsBytes(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return A list containing the temporaryFailedAckIds.
      */
@@ -543,10 +553,12 @@ public com.google.protobuf.ProtocolStringList getTemporaryFailedAckIdsList() {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The count of temporaryFailedAckIds.
      */
@@ -557,10 +569,12 @@ public int getTemporaryFailedAckIdsCount() {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the element to return.
      * @return The temporaryFailedAckIds at the given index.
@@ -572,10 +586,12 @@ public java.lang.String getTemporaryFailedAckIds(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 4;
+     * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the value to return.
      * @return The bytes of the temporaryFailedAckIds at the given index.
@@ -1083,10 +1099,10 @@ private void ensureAckIdsIsMutable() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return A list containing the ackIds.
        */
@@ -1098,10 +1114,10 @@ public com.google.protobuf.ProtocolStringList getAckIdsList() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return The count of ackIds.
        */
@@ -1112,10 +1128,10 @@ public int getAckIdsCount() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the element to return.
        * @return The ackIds at the given index.
@@ -1127,10 +1143,10 @@ public java.lang.String getAckIds(int index) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the value to return.
        * @return The bytes of the ackIds at the given index.
@@ -1142,10 +1158,10 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index to set the value at.
        * @param value The ackIds to set.
@@ -1165,10 +1181,10 @@ public Builder setAckIds(int index, java.lang.String value) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The ackIds to add.
        * @return This builder for chaining.
@@ -1187,10 +1203,10 @@ public Builder addAckIds(java.lang.String value) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param values The ackIds to add.
        * @return This builder for chaining.
@@ -1206,10 +1222,10 @@ public Builder addAllAckIds(java.lang.Iterable values) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return This builder for chaining.
        */
@@ -1224,10 +1240,10 @@ public Builder clearAckIds() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The bytes of the ackIds to add.
        * @return This builder for chaining.
@@ -1257,11 +1273,11 @@ private void ensureInvalidAckIdsIsMutable() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return A list containing the invalidAckIds.
        */
@@ -1273,11 +1289,11 @@ public com.google.protobuf.ProtocolStringList getInvalidAckIdsList() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return The count of invalidAckIds.
        */
@@ -1288,11 +1304,11 @@ public int getInvalidAckIdsCount() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the element to return.
        * @return The invalidAckIds at the given index.
@@ -1304,11 +1320,11 @@ public java.lang.String getInvalidAckIds(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the value to return.
        * @return The bytes of the invalidAckIds at the given index.
@@ -1320,11 +1336,11 @@ public com.google.protobuf.ByteString getInvalidAckIdsBytes(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index to set the value at.
        * @param value The invalidAckIds to set.
@@ -1344,11 +1360,11 @@ public Builder setInvalidAckIds(int index, java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The invalidAckIds to add.
        * @return This builder for chaining.
@@ -1367,11 +1383,11 @@ public Builder addInvalidAckIds(java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param values The invalidAckIds to add.
        * @return This builder for chaining.
@@ -1387,11 +1403,11 @@ public Builder addAllInvalidAckIds(java.lang.Iterable values)
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return This builder for chaining.
        */
@@ -1406,11 +1422,11 @@ public Builder clearInvalidAckIds() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The bytes of the invalidAckIds to add.
        * @return This builder for chaining.
@@ -1440,10 +1456,11 @@ private void ensureUnorderedAckIdsIsMutable() {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return A list containing the unorderedAckIds.
        */
@@ -1455,10 +1472,11 @@ public com.google.protobuf.ProtocolStringList getUnorderedAckIdsList() {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return The count of unorderedAckIds.
        */
@@ -1469,10 +1487,11 @@ public int getUnorderedAckIdsCount() {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index of the element to return.
        * @return The unorderedAckIds at the given index.
@@ -1484,10 +1503,11 @@ public java.lang.String getUnorderedAckIds(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index of the value to return.
        * @return The bytes of the unorderedAckIds at the given index.
@@ -1499,10 +1519,11 @@ public com.google.protobuf.ByteString getUnorderedAckIdsBytes(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index to set the value at.
        * @param value The unorderedAckIds to set.
@@ -1522,10 +1543,11 @@ public Builder setUnorderedAckIds(int index, java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param value The unorderedAckIds to add.
        * @return This builder for chaining.
@@ -1544,10 +1566,11 @@ public Builder addUnorderedAckIds(java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param values The unorderedAckIds to add.
        * @return This builder for chaining.
@@ -1563,10 +1586,11 @@ public Builder addAllUnorderedAckIds(java.lang.Iterable values
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return This builder for chaining.
        */
@@ -1581,10 +1605,11 @@ public Builder clearUnorderedAckIds() {
        *
        *
        * 
-       * List of acknowledgement IDs that were out of order.
+       * Optional. List of acknowledgement IDs that were out of order.
        * 

        *
-       * repeated string unordered_ack_ids = 3;
+       * repeated string unordered_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param value The bytes of the unorderedAckIds to add.
        * @return This builder for chaining.
@@ -1615,10 +1640,13 @@ private void ensureTemporaryFailedAckIdsIsMutable() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return A list containing the temporaryFailedAckIds.
        */
@@ -1630,10 +1658,13 @@ public com.google.protobuf.ProtocolStringList getTemporaryFailedAckIdsList() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return The count of temporaryFailedAckIds.
        */
@@ -1644,10 +1675,13 @@ public int getTemporaryFailedAckIdsCount() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index of the element to return.
        * @return The temporaryFailedAckIds at the given index.
@@ -1659,10 +1693,13 @@ public java.lang.String getTemporaryFailedAckIds(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index of the value to return.
        * @return The bytes of the temporaryFailedAckIds at the given index.
@@ -1674,10 +1711,13 @@ public com.google.protobuf.ByteString getTemporaryFailedAckIdsBytes(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index to set the value at.
        * @param value The temporaryFailedAckIds to set.
@@ -1697,10 +1737,13 @@ public Builder setTemporaryFailedAckIds(int index, java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param value The temporaryFailedAckIds to add.
        * @return This builder for chaining.
@@ -1719,10 +1762,13 @@ public Builder addTemporaryFailedAckIds(java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param values The temporaryFailedAckIds to add.
        * @return This builder for chaining.
@@ -1738,10 +1784,13 @@ public Builder addAllTemporaryFailedAckIds(java.lang.Iterable
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return This builder for chaining.
        */
@@ -1756,10 +1805,13 @@ public Builder clearTemporaryFailedAckIds() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 4;
+       * 
+       * repeated string temporary_failed_ack_ids = 4 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param value The bytes of the temporaryFailedAckIds to add.
        * @return This builder for chaining.
@@ -1852,10 +1904,10 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the ackIds.
      */
@@ -1864,10 +1916,10 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of ackIds.
      */
@@ -1876,10 +1928,10 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The ackIds at the given index.
@@ -1889,10 +1941,10 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the ackIds at the given index.
@@ -1903,11 +1955,11 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the invalidAckIds.
      */
@@ -1916,11 +1968,11 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of invalidAckIds.
      */
@@ -1929,11 +1981,11 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The invalidAckIds at the given index.
@@ -1943,11 +1995,11 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the invalidAckIds at the given index.
@@ -1958,10 +2010,12 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return A list containing the temporaryFailedAckIds.
      */
@@ -1970,10 +2024,12 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The count of temporaryFailedAckIds.
      */
@@ -1982,10 +2038,12 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the element to return.
      * @return The temporaryFailedAckIds at the given index.
@@ -1995,10 +2053,12 @@ public interface ModifyAckDeadlineConfirmationOrBuilder
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the value to return.
      * @return The bytes of the temporaryFailedAckIds at the given index.
@@ -2064,10 +2124,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the ackIds.
      */
@@ -2078,10 +2138,10 @@ public com.google.protobuf.ProtocolStringList getAckIdsList() {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of ackIds.
      */
@@ -2092,10 +2152,10 @@ public int getAckIdsCount() {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The ackIds at the given index.
@@ -2107,10 +2167,10 @@ public java.lang.String getAckIds(int index) {
      *
      *
      * 
-     * Successfully processed acknowledgement IDs.
+     * Optional. Successfully processed acknowledgement IDs.
      * 

      *
-     * repeated string ack_ids = 1;
+     * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the ackIds at the given index.
@@ -2128,11 +2188,11 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return A list containing the invalidAckIds.
      */
@@ -2143,11 +2203,11 @@ public com.google.protobuf.ProtocolStringList getInvalidAckIdsList() {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The count of invalidAckIds.
      */
@@ -2158,11 +2218,11 @@ public int getInvalidAckIdsCount() {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the element to return.
      * @return The invalidAckIds at the given index.
@@ -2174,11 +2234,11 @@ public java.lang.String getInvalidAckIds(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that were malformed or whose acknowledgement
-     * deadline has expired.
+     * Optional. List of acknowledgement IDs that were malformed or whose
+     * acknowledgement deadline has expired.
      * 

      *
-     * repeated string invalid_ack_ids = 2;
+     * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param index The index of the value to return.
      * @return The bytes of the invalidAckIds at the given index.
@@ -2196,10 +2256,12 @@ public com.google.protobuf.ByteString getInvalidAckIdsBytes(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return A list containing the temporaryFailedAckIds.
      */
@@ -2210,10 +2272,12 @@ public com.google.protobuf.ProtocolStringList getTemporaryFailedAckIdsList() {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The count of temporaryFailedAckIds.
      */
@@ -2224,10 +2288,12 @@ public int getTemporaryFailedAckIdsCount() {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the element to return.
      * @return The temporaryFailedAckIds at the given index.
@@ -2239,10 +2305,12 @@ public java.lang.String getTemporaryFailedAckIds(int index) {
      *
      *
      * 
-     * List of acknowledgement IDs that failed processing with temporary issues.
+     * Optional. List of acknowledgement IDs that failed processing with
+     * temporary issues.
      * 

      *
-     * repeated string temporary_failed_ack_ids = 3;
+     * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param index The index of the value to return.
      * @return The bytes of the temporaryFailedAckIds at the given index.
@@ -2722,10 +2790,10 @@ private void ensureAckIdsIsMutable() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return A list containing the ackIds.
        */
@@ -2737,10 +2805,10 @@ public com.google.protobuf.ProtocolStringList getAckIdsList() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return The count of ackIds.
        */
@@ -2751,10 +2819,10 @@ public int getAckIdsCount() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the element to return.
        * @return The ackIds at the given index.
@@ -2766,10 +2834,10 @@ public java.lang.String getAckIds(int index) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the value to return.
        * @return The bytes of the ackIds at the given index.
@@ -2781,10 +2849,10 @@ public com.google.protobuf.ByteString getAckIdsBytes(int index) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index to set the value at.
        * @param value The ackIds to set.
@@ -2804,10 +2872,10 @@ public Builder setAckIds(int index, java.lang.String value) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The ackIds to add.
        * @return This builder for chaining.
@@ -2826,10 +2894,10 @@ public Builder addAckIds(java.lang.String value) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param values The ackIds to add.
        * @return This builder for chaining.
@@ -2845,10 +2913,10 @@ public Builder addAllAckIds(java.lang.Iterable values) {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return This builder for chaining.
        */
@@ -2863,10 +2931,10 @@ public Builder clearAckIds() {
        *
        *
        * 
-       * Successfully processed acknowledgement IDs.
+       * Optional. Successfully processed acknowledgement IDs.
        * 

        *
-       * repeated string ack_ids = 1;
+       * repeated string ack_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The bytes of the ackIds to add.
        * @return This builder for chaining.
@@ -2896,11 +2964,11 @@ private void ensureInvalidAckIdsIsMutable() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return A list containing the invalidAckIds.
        */
@@ -2912,11 +2980,11 @@ public com.google.protobuf.ProtocolStringList getInvalidAckIdsList() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return The count of invalidAckIds.
        */
@@ -2927,11 +2995,11 @@ public int getInvalidAckIdsCount() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the element to return.
        * @return The invalidAckIds at the given index.
@@ -2943,11 +3011,11 @@ public java.lang.String getInvalidAckIds(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index of the value to return.
        * @return The bytes of the invalidAckIds at the given index.
@@ -2959,11 +3027,11 @@ public com.google.protobuf.ByteString getInvalidAckIdsBytes(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param index The index to set the value at.
        * @param value The invalidAckIds to set.
@@ -2983,11 +3051,11 @@ public Builder setInvalidAckIds(int index, java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The invalidAckIds to add.
        * @return This builder for chaining.
@@ -3006,11 +3074,11 @@ public Builder addInvalidAckIds(java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param values The invalidAckIds to add.
        * @return This builder for chaining.
@@ -3026,11 +3094,11 @@ public Builder addAllInvalidAckIds(java.lang.Iterable values)
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return This builder for chaining.
        */
@@ -3045,11 +3113,11 @@ public Builder clearInvalidAckIds() {
        *
        *
        * 
-       * List of acknowledgement IDs that were malformed or whose acknowledgement
-       * deadline has expired.
+       * Optional. List of acknowledgement IDs that were malformed or whose
+       * acknowledgement deadline has expired.
        * 

        *
-       * repeated string invalid_ack_ids = 2;
+       * repeated string invalid_ack_ids = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The bytes of the invalidAckIds to add.
        * @return This builder for chaining.
@@ -3080,10 +3148,13 @@ private void ensureTemporaryFailedAckIdsIsMutable() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return A list containing the temporaryFailedAckIds.
        */
@@ -3095,10 +3166,13 @@ public com.google.protobuf.ProtocolStringList getTemporaryFailedAckIdsList() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return The count of temporaryFailedAckIds.
        */
@@ -3109,10 +3183,13 @@ public int getTemporaryFailedAckIdsCount() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index of the element to return.
        * @return The temporaryFailedAckIds at the given index.
@@ -3124,10 +3201,13 @@ public java.lang.String getTemporaryFailedAckIds(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index of the value to return.
        * @return The bytes of the temporaryFailedAckIds at the given index.
@@ -3139,10 +3219,13 @@ public com.google.protobuf.ByteString getTemporaryFailedAckIdsBytes(int index) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param index The index to set the value at.
        * @param value The temporaryFailedAckIds to set.
@@ -3162,10 +3245,13 @@ public Builder setTemporaryFailedAckIds(int index, java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param value The temporaryFailedAckIds to add.
        * @return This builder for chaining.
@@ -3184,10 +3270,13 @@ public Builder addTemporaryFailedAckIds(java.lang.String value) {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param values The temporaryFailedAckIds to add.
        * @return This builder for chaining.
@@ -3203,10 +3292,13 @@ public Builder addAllTemporaryFailedAckIds(java.lang.Iterable
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return This builder for chaining.
        */
@@ -3221,10 +3313,13 @@ public Builder clearTemporaryFailedAckIds() {
        *
        *
        * 
-       * List of acknowledgement IDs that failed processing with temporary issues.
+       * Optional. List of acknowledgement IDs that failed processing with
+       * temporary issues.
        * 

        *
-       * repeated string temporary_failed_ack_ids = 3;
+       * 
+       * repeated string temporary_failed_ack_ids = 3 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param value The bytes of the temporaryFailedAckIds to add.
        * @return This builder for chaining.
@@ -3318,10 +3413,12 @@ public interface SubscriptionPropertiesOrBuilder
      *
      *
      * 
-     * True iff exactly once delivery is enabled for this subscription.
+     * Optional. True iff exactly once delivery is enabled for this
+     * subscription.
      * 

      *
-     * bool exactly_once_delivery_enabled = 1;
+     * bool exactly_once_delivery_enabled = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The exactlyOnceDeliveryEnabled.
      */
@@ -3331,10 +3428,10 @@ public interface SubscriptionPropertiesOrBuilder
      *
      *
      * 
-     * True iff message ordering is enabled for this subscription.
+     * Optional. True iff message ordering is enabled for this subscription.
      * 

      *
-     * bool message_ordering_enabled = 2;
+     * bool message_ordering_enabled = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The messageOrderingEnabled.
      */
@@ -3388,10 +3485,12 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      *
      *
      * 
-     * True iff exactly once delivery is enabled for this subscription.
+     * Optional. True iff exactly once delivery is enabled for this
+     * subscription.
      * 

      *
-     * bool exactly_once_delivery_enabled = 1;
+     * bool exactly_once_delivery_enabled = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The exactlyOnceDeliveryEnabled.
      */
@@ -3406,10 +3505,10 @@ public boolean getExactlyOnceDeliveryEnabled() {
      *
      *
      * 
-     * True iff message ordering is enabled for this subscription.
+     * Optional. True iff message ordering is enabled for this subscription.
      * 

      *
-     * bool message_ordering_enabled = 2;
+     * bool message_ordering_enabled = 2 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The messageOrderingEnabled.
      */
@@ -3800,10 +3899,12 @@ public Builder mergeFrom(
        *
        *
        * 
-       * True iff exactly once delivery is enabled for this subscription.
+       * Optional. True iff exactly once delivery is enabled for this
+       * subscription.
        * 

        *
-       * bool exactly_once_delivery_enabled = 1;
+       * bool exactly_once_delivery_enabled = 1 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return The exactlyOnceDeliveryEnabled.
        */
@@ -3815,10 +3916,12 @@ public boolean getExactlyOnceDeliveryEnabled() {
        *
        *
        * 
-       * True iff exactly once delivery is enabled for this subscription.
+       * Optional. True iff exactly once delivery is enabled for this
+       * subscription.
        * 

        *
-       * bool exactly_once_delivery_enabled = 1;
+       * bool exactly_once_delivery_enabled = 1 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @param value The exactlyOnceDeliveryEnabled to set.
        * @return This builder for chaining.
@@ -3834,10 +3937,12 @@ public Builder setExactlyOnceDeliveryEnabled(boolean value) {
        *
        *
        * 
-       * True iff exactly once delivery is enabled for this subscription.
+       * Optional. True iff exactly once delivery is enabled for this
+       * subscription.
        * 

        *
-       * bool exactly_once_delivery_enabled = 1;
+       * bool exactly_once_delivery_enabled = 1 [(.google.api.field_behavior) = OPTIONAL];
+       * 
        *
        * @return This builder for chaining.
        */
@@ -3853,10 +3958,10 @@ public Builder clearExactlyOnceDeliveryEnabled() {
        *
        *
        * 
-       * True iff message ordering is enabled for this subscription.
+       * Optional. True iff message ordering is enabled for this subscription.
        * 

        *
-       * bool message_ordering_enabled = 2;
+       * bool message_ordering_enabled = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return The messageOrderingEnabled.
        */
@@ -3868,10 +3973,10 @@ public boolean getMessageOrderingEnabled() {
        *
        *
        * 
-       * True iff message ordering is enabled for this subscription.
+       * Optional. True iff message ordering is enabled for this subscription.
        * 

        *
-       * bool message_ordering_enabled = 2;
+       * bool message_ordering_enabled = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @param value The messageOrderingEnabled to set.
        * @return This builder for chaining.
@@ -3887,10 +3992,10 @@ public Builder setMessageOrderingEnabled(boolean value) {
        *
        *
        * 
-       * True iff message ordering is enabled for this subscription.
+       * Optional. True iff message ordering is enabled for this subscription.
        * 

        *
-       * bool message_ordering_enabled = 2;
+       * bool message_ordering_enabled = 2 [(.google.api.field_behavior) = OPTIONAL];
        *
        * @return This builder for chaining.
        */
@@ -3976,10 +4081,12 @@ public com.google.protobuf.Parser getParserForType() {
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public java.util.List getReceivedMessagesList() {
@@ -3989,10 +4096,12 @@ public java.util.List getReceivedMessagesL
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public java.util.List
@@ -4003,10 +4112,12 @@ public java.util.List getReceivedMessagesL
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public int getReceivedMessagesCount() {
@@ -4016,10 +4127,12 @@ public int getReceivedMessagesCount() {
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) {
@@ -4029,10 +4142,12 @@ public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) {
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilder(int index) {
@@ -4046,12 +4161,12 @@ public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilde
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return Whether the acknowledgeConfirmation field is set.
@@ -4064,12 +4179,12 @@ public boolean hasAcknowledgeConfirmation() {
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return The acknowledgeConfirmation.
@@ -4085,12 +4200,12 @@ public boolean hasAcknowledgeConfirmation() {
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
    * 
    */
   @java.lang.Override
@@ -4108,12 +4223,12 @@ public boolean hasAcknowledgeConfirmation() {
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return Whether the modifyAckDeadlineConfirmation field is set.
@@ -4126,12 +4241,12 @@ public boolean hasModifyAckDeadlineConfirmation() {
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return The modifyAckDeadlineConfirmation.
@@ -4148,12 +4263,12 @@ public boolean hasModifyAckDeadlineConfirmation() {
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
    * 
    */
   @java.lang.Override
@@ -4171,11 +4286,11 @@ public boolean hasModifyAckDeadlineConfirmation() {
    *
    *
    * 
-   * Properties associated with this subscription.
+   * Optional. Properties associated with this subscription.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return Whether the subscriptionProperties field is set.
@@ -4188,11 +4303,11 @@ public boolean hasSubscriptionProperties() {
    *
    *
    * 
-   * Properties associated with this subscription.
+   * Optional. Properties associated with this subscription.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return The subscriptionProperties.
@@ -4208,11 +4323,11 @@ public boolean hasSubscriptionProperties() {
    *
    *
    * 
-   * Properties associated with this subscription.
+   * Optional. Properties associated with this subscription.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
    * 
    */
   @java.lang.Override
@@ -4744,10 +4859,12 @@ private void ensureReceivedMessagesIsMutable() {
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public java.util.List getReceivedMessagesList() {
       if (receivedMessagesBuilder_ == null) {
@@ -4760,10 +4877,12 @@ public java.util.List getReceivedMessagesL
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public int getReceivedMessagesCount() {
       if (receivedMessagesBuilder_ == null) {
@@ -4776,10 +4895,12 @@ public int getReceivedMessagesCount() {
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) {
       if (receivedMessagesBuilder_ == null) {
@@ -4792,10 +4913,12 @@ public com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index) {
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessage value) {
       if (receivedMessagesBuilder_ == null) {
@@ -4814,10 +4937,12 @@ public Builder setReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessa
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setReceivedMessages(
         int index, com.google.pubsub.v1.ReceivedMessage.Builder builderForValue) {
@@ -4834,10 +4959,12 @@ public Builder setReceivedMessages(
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder addReceivedMessages(com.google.pubsub.v1.ReceivedMessage value) {
       if (receivedMessagesBuilder_ == null) {
@@ -4856,10 +4983,12 @@ public Builder addReceivedMessages(com.google.pubsub.v1.ReceivedMessage value) {
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder addReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessage value) {
       if (receivedMessagesBuilder_ == null) {
@@ -4878,10 +5007,12 @@ public Builder addReceivedMessages(int index, com.google.pubsub.v1.ReceivedMessa
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder addReceivedMessages(
         com.google.pubsub.v1.ReceivedMessage.Builder builderForValue) {
@@ -4898,10 +5029,12 @@ public Builder addReceivedMessages(
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder addReceivedMessages(
         int index, com.google.pubsub.v1.ReceivedMessage.Builder builderForValue) {
@@ -4918,10 +5051,12 @@ public Builder addReceivedMessages(
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder addAllReceivedMessages(
         java.lang.Iterable values) {
@@ -4938,10 +5073,12 @@ public Builder addAllReceivedMessages(
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearReceivedMessages() {
       if (receivedMessagesBuilder_ == null) {
@@ -4957,10 +5094,12 @@ public Builder clearReceivedMessages() {
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder removeReceivedMessages(int index) {
       if (receivedMessagesBuilder_ == null) {
@@ -4976,10 +5115,12 @@ public Builder removeReceivedMessages(int index) {
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.ReceivedMessage.Builder getReceivedMessagesBuilder(int index) {
       return getReceivedMessagesFieldBuilder().getBuilder(index);
@@ -4988,10 +5129,12 @@ public com.google.pubsub.v1.ReceivedMessage.Builder getReceivedMessagesBuilder(i
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilder(int index) {
       if (receivedMessagesBuilder_ == null) {
@@ -5004,10 +5147,12 @@ public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilde
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public java.util.List
         getReceivedMessagesOrBuilderList() {
@@ -5021,10 +5166,12 @@ public com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilde
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder() {
       return getReceivedMessagesFieldBuilder()
@@ -5034,10 +5181,12 @@ public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder()
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder(int index) {
       return getReceivedMessagesFieldBuilder()
@@ -5047,10 +5196,12 @@ public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder(i
      *
      *
      * 
-     * Received Pub/Sub messages. This will not be empty.
+     * Optional. Received Pub/Sub messages. This will not be empty.
      * 

      *
-     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+     * 
+     * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public java.util.List
         getReceivedMessagesBuilderList() {
@@ -5088,12 +5239,12 @@ public com.google.pubsub.v1.ReceivedMessage.Builder addReceivedMessagesBuilder(i
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      *
      * @return Whether the acknowledgeConfirmation field is set.
@@ -5105,12 +5256,12 @@ public boolean hasAcknowledgeConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      *
      * @return The acknowledgeConfirmation.
@@ -5130,12 +5281,12 @@ public boolean hasAcknowledgeConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder setAcknowledgeConfirmation(
@@ -5156,12 +5307,12 @@ public Builder setAcknowledgeConfirmation(
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder setAcknowledgeConfirmation(
@@ -5180,12 +5331,12 @@ public Builder setAcknowledgeConfirmation(
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder mergeAcknowledgeConfirmation(
@@ -5211,12 +5362,12 @@ public Builder mergeAcknowledgeConfirmation(
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder clearAcknowledgeConfirmation() {
@@ -5233,12 +5384,12 @@ public Builder clearAcknowledgeConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public com.google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation.Builder
@@ -5251,12 +5402,12 @@ public Builder clearAcknowledgeConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public com.google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmationOrBuilder
@@ -5274,12 +5425,12 @@ public Builder clearAcknowledgeConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+     * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
@@ -5310,12 +5461,12 @@ public Builder clearAcknowledgeConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      *
      * @return Whether the modifyAckDeadlineConfirmation field is set.
@@ -5327,12 +5478,12 @@ public boolean hasModifyAckDeadlineConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      *
      * @return The modifyAckDeadlineConfirmation.
@@ -5352,12 +5503,12 @@ public boolean hasModifyAckDeadlineConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder setModifyAckDeadlineConfirmation(
@@ -5378,12 +5529,12 @@ public Builder setModifyAckDeadlineConfirmation(
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder setModifyAckDeadlineConfirmation(
@@ -5402,12 +5553,12 @@ public Builder setModifyAckDeadlineConfirmation(
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder mergeModifyAckDeadlineConfirmation(
@@ -5433,12 +5584,12 @@ public Builder mergeModifyAckDeadlineConfirmation(
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder clearModifyAckDeadlineConfirmation() {
@@ -5455,12 +5606,12 @@ public Builder clearModifyAckDeadlineConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public com.google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation.Builder
@@ -5473,12 +5624,12 @@ public Builder clearModifyAckDeadlineConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public com.google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmationOrBuilder
@@ -5496,12 +5647,12 @@ public Builder clearModifyAckDeadlineConfirmation() {
      *
      *
      * 
-     * This field will only be set if `enable_exactly_once_delivery` is set to
-     * `true`.
+     * Optional. This field will only be set if `enable_exactly_once_delivery` is
+     * set to `true`.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+     * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
@@ -5532,11 +5683,11 @@ public Builder clearModifyAckDeadlineConfirmation() {
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      *
      * @return Whether the subscriptionProperties field is set.
@@ -5548,11 +5699,11 @@ public boolean hasSubscriptionProperties() {
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      *
      * @return The subscriptionProperties.
@@ -5571,11 +5722,11 @@ public boolean hasSubscriptionProperties() {
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder setSubscriptionProperties(
@@ -5596,11 +5747,11 @@ public Builder setSubscriptionProperties(
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder setSubscriptionProperties(
@@ -5618,11 +5769,11 @@ public Builder setSubscriptionProperties(
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder mergeSubscriptionProperties(
@@ -5648,11 +5799,11 @@ public Builder mergeSubscriptionProperties(
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public Builder clearSubscriptionProperties() {
@@ -5669,11 +5820,11 @@ public Builder clearSubscriptionProperties() {
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public com.google.pubsub.v1.StreamingPullResponse.SubscriptionProperties.Builder
@@ -5686,11 +5837,11 @@ public Builder clearSubscriptionProperties() {
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     public com.google.pubsub.v1.StreamingPullResponse.SubscriptionPropertiesOrBuilder
@@ -5707,11 +5858,11 @@ public Builder clearSubscriptionProperties() {
      *
      *
      * 
-     * Properties associated with this subscription.
+     * Optional. Properties associated with this subscription.
      * 

      *
      * 
-     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+     * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
      * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponseOrBuilder.java
index e9d7b80f8..e8968c231 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponseOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/StreamingPullResponseOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,40 +27,48 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   java.util.List getReceivedMessagesList();
   /**
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.ReceivedMessage getReceivedMessages(int index);
   /**
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   int getReceivedMessagesCount();
   /**
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   java.util.List
       getReceivedMessagesOrBuilderList();
@@ -68,10 +76,12 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * Received Pub/Sub messages. This will not be empty.
+   * Optional. Received Pub/Sub messages. This will not be empty.
    * 

    *
-   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1;
+   * 
+   * repeated .google.pubsub.v1.ReceivedMessage received_messages = 1 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.ReceivedMessageOrBuilder getReceivedMessagesOrBuilder(int index);
 
@@ -79,12 +89,12 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return Whether the acknowledgeConfirmation field is set.
@@ -94,12 +104,12 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return The acknowledgeConfirmation.
@@ -109,12 +119,12 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5;
+   * .google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmation acknowledge_confirmation = 5 [(.google.api.field_behavior) = OPTIONAL];
    * 
    */
   com.google.pubsub.v1.StreamingPullResponse.AcknowledgeConfirmationOrBuilder
@@ -124,12 +134,12 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return Whether the modifyAckDeadlineConfirmation field is set.
@@ -139,12 +149,12 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return The modifyAckDeadlineConfirmation.
@@ -155,12 +165,12 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * This field will only be set if `enable_exactly_once_delivery` is set to
-   * `true`.
+   * Optional. This field will only be set if `enable_exactly_once_delivery` is
+   * set to `true`.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+   * .google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3 [(.google.api.field_behavior) = OPTIONAL];
    * 
    */
   com.google.pubsub.v1.StreamingPullResponse.ModifyAckDeadlineConfirmationOrBuilder
@@ -170,11 +180,11 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * Properties associated with this subscription.
+   * Optional. Properties associated with this subscription.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return Whether the subscriptionProperties field is set.
@@ -184,11 +194,11 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * Properties associated with this subscription.
+   * Optional. Properties associated with this subscription.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
    * 
    *
    * @return The subscriptionProperties.
@@ -198,11 +208,11 @@ public interface StreamingPullResponseOrBuilder
    *
    *
    * 
-   * Properties associated with this subscription.
+   * Optional. Properties associated with this subscription.
    * 

    *
    * 
-   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4;
+   * .google.pubsub.v1.StreamingPullResponse.SubscriptionProperties subscription_properties = 4 [(.google.api.field_behavior) = OPTIONAL];
    * 
    */
   com.google.pubsub.v1.StreamingPullResponse.SubscriptionPropertiesOrBuilder
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
index 6e21f6ef2..f8a13c5f0 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -365,11 +365,12 @@ public com.google.protobuf.ByteString getTopicBytes() {
    *
    *
    * 
-   * If push delivery is used with this subscription, this field is
+   * Optional. If push delivery is used with this subscription, this field is
    * used to configure it.
    * 

    *
-   * .google.pubsub.v1.PushConfig push_config = 4;
+   * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the pushConfig field is set.
    */
@@ -381,11 +382,12 @@ public boolean hasPushConfig() {
    *
    *
    * 
-   * If push delivery is used with this subscription, this field is
+   * Optional. If push delivery is used with this subscription, this field is
    * used to configure it.
    * 

    *
-   * .google.pubsub.v1.PushConfig push_config = 4;
+   * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The pushConfig.
    */
@@ -397,11 +399,12 @@ public com.google.pubsub.v1.PushConfig getPushConfig() {
    *
    *
    * 
-   * If push delivery is used with this subscription, this field is
+   * Optional. If push delivery is used with this subscription, this field is
    * used to configure it.
    * 

    *
-   * .google.pubsub.v1.PushConfig push_config = 4;
+   * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder() {
@@ -414,11 +417,13 @@ public com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder() {
    *
    *
    * 
-   * If delivery to BigQuery is used with this subscription, this field is
-   * used to configure it.
+   * Optional. If delivery to BigQuery is used with this subscription, this
+   * field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+   * 
+   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the bigqueryConfig field is set.
    */
@@ -430,11 +435,13 @@ public boolean hasBigqueryConfig() {
    *
    *
    * 
-   * If delivery to BigQuery is used with this subscription, this field is
-   * used to configure it.
+   * Optional. If delivery to BigQuery is used with this subscription, this
+   * field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+   * 
+   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The bigqueryConfig.
    */
@@ -448,11 +455,13 @@ public com.google.pubsub.v1.BigQueryConfig getBigqueryConfig() {
    *
    *
    * 
-   * If delivery to BigQuery is used with this subscription, this field is
-   * used to configure it.
+   * Optional. If delivery to BigQuery is used with this subscription, this
+   * field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+   * 
+   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.BigQueryConfigOrBuilder getBigqueryConfigOrBuilder() {
@@ -467,11 +476,13 @@ public com.google.pubsub.v1.BigQueryConfigOrBuilder getBigqueryConfigOrBuilder()
    *
    *
    * 
-   * If delivery to Google Cloud Storage is used with this subscription, this
-   * field is used to configure it.
+   * Optional. If delivery to Google Cloud Storage is used with this
+   * subscription, this field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the cloudStorageConfig field is set.
    */
@@ -483,11 +494,13 @@ public boolean hasCloudStorageConfig() {
    *
    *
    * 
-   * If delivery to Google Cloud Storage is used with this subscription, this
-   * field is used to configure it.
+   * Optional. If delivery to Google Cloud Storage is used with this
+   * subscription, this field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The cloudStorageConfig.
    */
@@ -501,11 +514,13 @@ public com.google.pubsub.v1.CloudStorageConfig getCloudStorageConfig() {
    *
    *
    * 
-   * If delivery to Google Cloud Storage is used with this subscription, this
-   * field is used to configure it.
+   * Optional. If delivery to Google Cloud Storage is used with this
+   * subscription, this field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrBuilder() {
@@ -520,11 +535,11 @@ public com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrB
    *
    *
    * 
-   * 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 _outstanding_. During that time period, the
-   * message will not be redelivered (on a best-effort basis).
+   * Optional. 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 _outstanding_. 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
@@ -542,7 +557,7 @@ public com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrB
    * system will eventually redeliver the message.
    * 

    *
-   * int32 ack_deadline_seconds = 5;
+   * int32 ack_deadline_seconds = 5 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The ackDeadlineSeconds.
    */
@@ -557,7 +572,7 @@ public int getAckDeadlineSeconds() {
    *
    *
    * 
-   * Indicates whether to retain acknowledged messages. If true, then
+   * Optional. Indicates whether to retain acknowledged messages. If true, then
    * messages are not expunged from the subscription's backlog, even if they are
    * acknowledged, until they fall out of the `message_retention_duration`
    * window. This must be true if you would like to [`Seek` to a timestamp]
@@ -565,7 +580,7 @@ public int getAckDeadlineSeconds() {
    * the past to replay previously-acknowledged messages.
    * 

    *
-   * bool retain_acked_messages = 7;
+   * bool retain_acked_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The retainAckedMessages.
    */
@@ -580,15 +595,16 @@ public boolean getRetainAckedMessages() {
    *
    *
    * 
-   * How long to retain unacknowledged messages in the subscription's backlog,
-   * from the moment a message is published.
-   * If `retain_acked_messages` is true, then this also configures the retention
-   * 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.
+   * Optional. How long to retain unacknowledged messages in the subscription's
+   * backlog, from the moment a message is published. If `retain_acked_messages`
+   * is true, then this also configures the retention 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.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the messageRetentionDuration field is set.
    */
@@ -600,15 +616,16 @@ public boolean hasMessageRetentionDuration() {
    *
    *
    * 
-   * How long to retain unacknowledged messages in the subscription's backlog,
-   * from the moment a message is published.
-   * If `retain_acked_messages` is true, then this also configures the retention
-   * 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.
+   * Optional. How long to retain unacknowledged messages in the subscription's
+   * backlog, from the moment a message is published. If `retain_acked_messages`
+   * is true, then this also configures the retention 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.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The messageRetentionDuration.
    */
@@ -622,15 +639,16 @@ public com.google.protobuf.Duration getMessageRetentionDuration() {
    *
    *
    * 
-   * How long to retain unacknowledged messages in the subscription's backlog,
-   * from the moment a message is published.
-   * If `retain_acked_messages` is true, then this also configures the retention
-   * 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.
+   * Optional. How long to retain unacknowledged messages in the subscription's
+   * backlog, from the moment a message is published. If `retain_acked_messages`
+   * is true, then this also configures the retention 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.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder() {
@@ -669,11 +687,11 @@ public int getLabelsCount() {
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public boolean containsLabels(java.lang.String key) {
@@ -692,11 +710,11 @@ public java.util.Map getLabels() {
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public java.util.Map getLabelsMap() {
@@ -706,11 +724,11 @@ public java.util.Map getLabelsMap() {
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public /* nullable */ java.lang.String getLabelsOrDefault(
@@ -727,11 +745,11 @@ public java.util.Map getLabelsMap() {
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public java.lang.String getLabelsOrThrow(java.lang.String key) {
@@ -751,13 +769,13 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) {
    *
    *
    * 
-   * If true, messages published with the same `ordering_key` in `PubsubMessage`
-   * will be delivered to the subscribers in the order in which they
-   * are received by the Pub/Sub system. Otherwise, they may be delivered in
-   * any order.
+   * Optional. If true, messages published with the same `ordering_key` in
+   * `PubsubMessage` will be delivered to the subscribers in the order in which
+   * they are received by the Pub/Sub system. Otherwise, they may be delivered
+   * in any order.
    * 

    *
-   * bool enable_message_ordering = 10;
+   * bool enable_message_ordering = 10 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The enableMessageOrdering.
    */
@@ -772,16 +790,18 @@ public boolean getEnableMessageOrdering() {
    *
    *
    * 
-   * A policy that specifies the conditions for this subscription's expiration.
-   * A subscription is considered active as long as any connected subscriber is
-   * successfully consuming messages from the subscription or is issuing
-   * operations on the subscription. If `expiration_policy` is not set, a
-   * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+   * Optional. A policy that specifies the conditions for this subscription's
+   * expiration. A subscription is considered active as long as any connected
+   * subscriber is successfully consuming messages from the subscription or is
+   * issuing operations on the subscription. If `expiration_policy` is not set,
+   * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
    * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
    * but `expiration_policy.ttl` is not set, the subscription never expires.
    * 

    *
-   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+   * 
+   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the expirationPolicy field is set.
    */
@@ -793,16 +813,18 @@ public boolean hasExpirationPolicy() {
    *
    *
    * 
-   * A policy that specifies the conditions for this subscription's expiration.
-   * A subscription is considered active as long as any connected subscriber is
-   * successfully consuming messages from the subscription or is issuing
-   * operations on the subscription. If `expiration_policy` is not set, a
-   * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+   * Optional. A policy that specifies the conditions for this subscription's
+   * expiration. A subscription is considered active as long as any connected
+   * subscriber is successfully consuming messages from the subscription or is
+   * issuing operations on the subscription. If `expiration_policy` is not set,
+   * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
    * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
    * but `expiration_policy.ttl` is not set, the subscription never expires.
    * 

    *
-   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+   * 
+   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The expirationPolicy.
    */
@@ -816,16 +838,18 @@ public com.google.pubsub.v1.ExpirationPolicy getExpirationPolicy() {
    *
    *
    * 
-   * A policy that specifies the conditions for this subscription's expiration.
-   * A subscription is considered active as long as any connected subscriber is
-   * successfully consuming messages from the subscription or is issuing
-   * operations on the subscription. If `expiration_policy` is not set, a
-   * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+   * Optional. A policy that specifies the conditions for this subscription's
+   * expiration. A subscription is considered active as long as any connected
+   * subscriber is successfully consuming messages from the subscription or is
+   * issuing operations on the subscription. If `expiration_policy` is not set,
+   * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
    * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
    * but `expiration_policy.ttl` is not set, the subscription never expires.
    * 

    *
-   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+   * 
+   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuilder() {
@@ -842,14 +866,14 @@ public com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuild
    *
    *
    * 
-   * An expression written in the Pub/Sub [filter
+   * Optional. An expression written in the Pub/Sub [filter
    * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.
    * 

    *
-   * string filter = 12;
+   * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The filter.
    */
@@ -869,14 +893,14 @@ public java.lang.String getFilter() {
    *
    *
    * 
-   * An expression written in the Pub/Sub [filter
+   * Optional. An expression written in the Pub/Sub [filter
    * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.
    * 

    *
-   * string filter = 12;
+   * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for filter.
    */
@@ -899,17 +923,19 @@ public com.google.protobuf.ByteString getFilterBytes() {
    *
    *
    * 
-   * A policy that specifies the conditions for dead lettering messages in
-   * this subscription. If dead_letter_policy is not set, dead lettering
-   * is disabled.
+   * Optional. A policy that specifies the conditions for dead lettering
+   * messages in this subscription. If dead_letter_policy is not set, dead
+   * lettering is disabled.
    *
-   * The Cloud Pub/Sub service account associated with this subscriptions's
+   * The Pub/Sub service account associated with this subscriptions's
    * parent project (i.e.,
    * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
    * permission to Acknowledge() messages on this subscription.
    * 

    *
-   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+   * 
+   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the deadLetterPolicy field is set.
    */
@@ -921,17 +947,19 @@ public boolean hasDeadLetterPolicy() {
    *
    *
    * 
-   * A policy that specifies the conditions for dead lettering messages in
-   * this subscription. If dead_letter_policy is not set, dead lettering
-   * is disabled.
+   * Optional. A policy that specifies the conditions for dead lettering
+   * messages in this subscription. If dead_letter_policy is not set, dead
+   * lettering is disabled.
    *
-   * The Cloud Pub/Sub service account associated with this subscriptions's
+   * The Pub/Sub service account associated with this subscriptions's
    * parent project (i.e.,
    * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
    * permission to Acknowledge() messages on this subscription.
    * 

    *
-   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+   * 
+   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The deadLetterPolicy.
    */
@@ -945,17 +973,19 @@ public com.google.pubsub.v1.DeadLetterPolicy getDeadLetterPolicy() {
    *
    *
    * 
-   * A policy that specifies the conditions for dead lettering messages in
-   * this subscription. If dead_letter_policy is not set, dead lettering
-   * is disabled.
+   * Optional. A policy that specifies the conditions for dead lettering
+   * messages in this subscription. If dead_letter_policy is not set, dead
+   * lettering is disabled.
    *
-   * The Cloud Pub/Sub service account associated with this subscriptions's
+   * The Pub/Sub service account associated with this subscriptions's
    * parent project (i.e.,
    * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
    * permission to Acknowledge() messages on this subscription.
    * 

    *
-   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+   * 
+   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuilder() {
@@ -970,8 +1000,8 @@ public com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuild
    *
    *
    * 
-   * A policy that specifies how Pub/Sub retries message delivery for this
-   * subscription.
+   * Optional. A policy that specifies how Pub/Sub retries message delivery for
+   * this subscription.
    *
    * If not set, the default retry policy is applied. This generally implies
    * that messages will be retried as soon as possible for healthy subscribers.
@@ -979,7 +1009,9 @@ public com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuild
    * exceeded events for a given message.
    * 

    *
-   * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+   * 
+   * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the retryPolicy field is set.
    */
@@ -991,8 +1023,8 @@ public boolean hasRetryPolicy() {
    *
    *
    * 
-   * A policy that specifies how Pub/Sub retries message delivery for this
-   * subscription.
+   * Optional. A policy that specifies how Pub/Sub retries message delivery for
+   * this subscription.
    *
    * If not set, the default retry policy is applied. This generally implies
    * that messages will be retried as soon as possible for healthy subscribers.
@@ -1000,7 +1032,9 @@ public boolean hasRetryPolicy() {
    * exceeded events for a given message.
    * 

    *
-   * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+   * 
+   * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The retryPolicy.
    */
@@ -1014,8 +1048,8 @@ public com.google.pubsub.v1.RetryPolicy getRetryPolicy() {
    *
    *
    * 
-   * A policy that specifies how Pub/Sub retries message delivery for this
-   * subscription.
+   * Optional. A policy that specifies how Pub/Sub retries message delivery for
+   * this subscription.
    *
    * If not set, the default retry policy is applied. This generally implies
    * that messages will be retried as soon as possible for healthy subscribers.
@@ -1023,7 +1057,9 @@ public com.google.pubsub.v1.RetryPolicy getRetryPolicy() {
    * exceeded events for a given message.
    * 

    *
-   * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+   * 
+   * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder() {
@@ -1038,14 +1074,14 @@ public com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder() {
    *
    *
    * 
-   * Indicates whether the subscription is detached from its topic. Detached
-   * subscriptions don't receive messages from their topic and don't retain any
-   * backlog. `Pull` and `StreamingPull` requests will return
+   * Optional. Indicates whether the subscription is detached from its topic.
+   * Detached subscriptions don't receive messages from their topic and don't
+   * retain any backlog. `Pull` and `StreamingPull` requests will return
    * FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
    * the endpoint will not be made.
    * 

    *
-   * bool detached = 15;
+   * bool detached = 15 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The detached.
    */
@@ -1060,8 +1096,9 @@ public boolean getDetached() {
    *
    *
    * 
-   * If true, Pub/Sub provides the following guarantees for the delivery of
-   * a message with a given value of `message_id` on this subscription:
+   * Optional. If true, Pub/Sub provides the following guarantees for the
+   * delivery of a message with a given value of `message_id` on this
+   * subscription:
    *
    * * The message sent to a subscriber is guaranteed not to be resent
    * before the message's acknowledgement deadline expires.
@@ -1073,7 +1110,7 @@ public boolean getDetached() {
    * by Pub/Sub and have distinct `message_id` values.
    * 

    *
-   * bool enable_exactly_once_delivery = 16;
+   * bool enable_exactly_once_delivery = 16 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The enableExactlyOnceDelivery.
    */
@@ -2309,11 +2346,12 @@ public Builder setTopicBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the pushConfig field is set.
      */
@@ -2324,11 +2362,12 @@ public boolean hasPushConfig() {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The pushConfig.
      */
@@ -2345,11 +2384,12 @@ public com.google.pubsub.v1.PushConfig getPushConfig() {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setPushConfig(com.google.pubsub.v1.PushConfig value) {
       if (pushConfigBuilder_ == null) {
@@ -2368,11 +2408,12 @@ public Builder setPushConfig(com.google.pubsub.v1.PushConfig value) {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setPushConfig(com.google.pubsub.v1.PushConfig.Builder builderForValue) {
       if (pushConfigBuilder_ == null) {
@@ -2388,11 +2429,12 @@ public Builder setPushConfig(com.google.pubsub.v1.PushConfig.Builder builderForV
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergePushConfig(com.google.pubsub.v1.PushConfig value) {
       if (pushConfigBuilder_ == null) {
@@ -2414,11 +2456,12 @@ public Builder mergePushConfig(com.google.pubsub.v1.PushConfig value) {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearPushConfig() {
       bitField0_ = (bitField0_ & ~0x00000004);
@@ -2434,11 +2477,12 @@ public Builder clearPushConfig() {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.PushConfig.Builder getPushConfigBuilder() {
       bitField0_ |= 0x00000004;
@@ -2449,11 +2493,12 @@ public com.google.pubsub.v1.PushConfig.Builder getPushConfigBuilder() {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder() {
       if (pushConfigBuilder_ != null) {
@@ -2468,11 +2513,12 @@ public com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder() {
      *
      *
      * 
-     * If push delivery is used with this subscription, this field is
+     * Optional. If push delivery is used with this subscription, this field is
      * used to configure it.
      * 

      *
-     * .google.pubsub.v1.PushConfig push_config = 4;
+     * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.PushConfig,
@@ -2501,11 +2547,13 @@ public com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder() {
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the bigqueryConfig field is set.
      */
@@ -2516,11 +2564,13 @@ public boolean hasBigqueryConfig() {
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The bigqueryConfig.
      */
@@ -2537,11 +2587,13 @@ public com.google.pubsub.v1.BigQueryConfig getBigqueryConfig() {
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setBigqueryConfig(com.google.pubsub.v1.BigQueryConfig value) {
       if (bigqueryConfigBuilder_ == null) {
@@ -2560,11 +2612,13 @@ public Builder setBigqueryConfig(com.google.pubsub.v1.BigQueryConfig value) {
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setBigqueryConfig(com.google.pubsub.v1.BigQueryConfig.Builder builderForValue) {
       if (bigqueryConfigBuilder_ == null) {
@@ -2580,11 +2634,13 @@ public Builder setBigqueryConfig(com.google.pubsub.v1.BigQueryConfig.Builder bui
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeBigqueryConfig(com.google.pubsub.v1.BigQueryConfig value) {
       if (bigqueryConfigBuilder_ == null) {
@@ -2606,11 +2662,13 @@ public Builder mergeBigqueryConfig(com.google.pubsub.v1.BigQueryConfig value) {
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearBigqueryConfig() {
       bitField0_ = (bitField0_ & ~0x00000008);
@@ -2626,11 +2684,13 @@ public Builder clearBigqueryConfig() {
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.BigQueryConfig.Builder getBigqueryConfigBuilder() {
       bitField0_ |= 0x00000008;
@@ -2641,11 +2701,13 @@ public com.google.pubsub.v1.BigQueryConfig.Builder getBigqueryConfigBuilder() {
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.BigQueryConfigOrBuilder getBigqueryConfigOrBuilder() {
       if (bigqueryConfigBuilder_ != null) {
@@ -2660,11 +2722,13 @@ public com.google.pubsub.v1.BigQueryConfigOrBuilder getBigqueryConfigOrBuilder()
      *
      *
      * 
-     * If delivery to BigQuery is used with this subscription, this field is
-     * used to configure it.
+     * Optional. If delivery to BigQuery is used with this subscription, this
+     * field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+     * 
+     * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.BigQueryConfig,
@@ -2693,11 +2757,13 @@ public com.google.pubsub.v1.BigQueryConfigOrBuilder getBigqueryConfigOrBuilder()
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the cloudStorageConfig field is set.
      */
@@ -2708,11 +2774,13 @@ public boolean hasCloudStorageConfig() {
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The cloudStorageConfig.
      */
@@ -2729,11 +2797,13 @@ public com.google.pubsub.v1.CloudStorageConfig getCloudStorageConfig() {
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setCloudStorageConfig(com.google.pubsub.v1.CloudStorageConfig value) {
       if (cloudStorageConfigBuilder_ == null) {
@@ -2752,11 +2822,13 @@ public Builder setCloudStorageConfig(com.google.pubsub.v1.CloudStorageConfig val
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setCloudStorageConfig(
         com.google.pubsub.v1.CloudStorageConfig.Builder builderForValue) {
@@ -2773,11 +2845,13 @@ public Builder setCloudStorageConfig(
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeCloudStorageConfig(com.google.pubsub.v1.CloudStorageConfig value) {
       if (cloudStorageConfigBuilder_ == null) {
@@ -2800,11 +2874,13 @@ public Builder mergeCloudStorageConfig(com.google.pubsub.v1.CloudStorageConfig v
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearCloudStorageConfig() {
       bitField0_ = (bitField0_ & ~0x00000010);
@@ -2820,11 +2896,13 @@ public Builder clearCloudStorageConfig() {
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.CloudStorageConfig.Builder getCloudStorageConfigBuilder() {
       bitField0_ |= 0x00000010;
@@ -2835,11 +2913,13 @@ public com.google.pubsub.v1.CloudStorageConfig.Builder getCloudStorageConfigBuil
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrBuilder() {
       if (cloudStorageConfigBuilder_ != null) {
@@ -2854,11 +2934,13 @@ public com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrB
      *
      *
      * 
-     * If delivery to Google Cloud Storage is used with this subscription, this
-     * field is used to configure it.
+     * Optional. If delivery to Google Cloud Storage is used with this
+     * subscription, this field is used to configure it.
      * 

      *
-     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+     * 
+     * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.CloudStorageConfig,
@@ -2882,11 +2964,11 @@ public com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrB
      *
      *
      * 
-     * 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 _outstanding_. During that time period, the
-     * message will not be redelivered (on a best-effort basis).
+     * Optional. 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 _outstanding_. 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
@@ -2904,7 +2986,7 @@ public com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrB
      * system will eventually redeliver the message.
      * 

      *
-     * int32 ack_deadline_seconds = 5;
+     * int32 ack_deadline_seconds = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The ackDeadlineSeconds.
      */
@@ -2916,11 +2998,11 @@ public int getAckDeadlineSeconds() {
      *
      *
      * 
-     * 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 _outstanding_. During that time period, the
-     * message will not be redelivered (on a best-effort basis).
+     * Optional. 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 _outstanding_. 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
@@ -2938,7 +3020,7 @@ public int getAckDeadlineSeconds() {
      * system will eventually redeliver the message.
      * 

      *
-     * int32 ack_deadline_seconds = 5;
+     * int32 ack_deadline_seconds = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The ackDeadlineSeconds to set.
      * @return This builder for chaining.
@@ -2954,11 +3036,11 @@ public Builder setAckDeadlineSeconds(int value) {
      *
      *
      * 
-     * 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 _outstanding_. During that time period, the
-     * message will not be redelivered (on a best-effort basis).
+     * Optional. 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 _outstanding_. 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
@@ -2976,7 +3058,7 @@ public Builder setAckDeadlineSeconds(int value) {
      * system will eventually redeliver the message.
      * 

      *
-     * int32 ack_deadline_seconds = 5;
+     * int32 ack_deadline_seconds = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -2992,7 +3074,7 @@ public Builder clearAckDeadlineSeconds() {
      *
      *
      * 
-     * Indicates whether to retain acknowledged messages. If true, then
+     * Optional. Indicates whether to retain acknowledged messages. If true, then
      * messages are not expunged from the subscription's backlog, even if they are
      * acknowledged, until they fall out of the `message_retention_duration`
      * window. This must be true if you would like to [`Seek` to a timestamp]
@@ -3000,7 +3082,7 @@ public Builder clearAckDeadlineSeconds() {
      * the past to replay previously-acknowledged messages.
      * 

      *
-     * bool retain_acked_messages = 7;
+     * bool retain_acked_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The retainAckedMessages.
      */
@@ -3012,7 +3094,7 @@ public boolean getRetainAckedMessages() {
      *
      *
      * 
-     * Indicates whether to retain acknowledged messages. If true, then
+     * Optional. Indicates whether to retain acknowledged messages. If true, then
      * messages are not expunged from the subscription's backlog, even if they are
      * acknowledged, until they fall out of the `message_retention_duration`
      * window. This must be true if you would like to [`Seek` to a timestamp]
@@ -3020,7 +3102,7 @@ public boolean getRetainAckedMessages() {
      * the past to replay previously-acknowledged messages.
      * 

      *
-     * bool retain_acked_messages = 7;
+     * bool retain_acked_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The retainAckedMessages to set.
      * @return This builder for chaining.
@@ -3036,7 +3118,7 @@ public Builder setRetainAckedMessages(boolean value) {
      *
      *
      * 
-     * Indicates whether to retain acknowledged messages. If true, then
+     * Optional. Indicates whether to retain acknowledged messages. If true, then
      * messages are not expunged from the subscription's backlog, even if they are
      * acknowledged, until they fall out of the `message_retention_duration`
      * window. This must be true if you would like to [`Seek` to a timestamp]
@@ -3044,7 +3126,7 @@ public Builder setRetainAckedMessages(boolean value) {
      * the past to replay previously-acknowledged messages.
      * 

      *
-     * bool retain_acked_messages = 7;
+     * bool retain_acked_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -3065,15 +3147,16 @@ public Builder clearRetainAckedMessages() {
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the messageRetentionDuration field is set.
      */
@@ -3084,15 +3167,16 @@ public boolean hasMessageRetentionDuration() {
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The messageRetentionDuration.
      */
@@ -3109,15 +3193,16 @@ public com.google.protobuf.Duration getMessageRetentionDuration() {
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMessageRetentionDuration(com.google.protobuf.Duration value) {
       if (messageRetentionDurationBuilder_ == null) {
@@ -3136,15 +3221,16 @@ public Builder setMessageRetentionDuration(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMessageRetentionDuration(
         com.google.protobuf.Duration.Builder builderForValue) {
@@ -3161,15 +3247,16 @@ public Builder setMessageRetentionDuration(
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeMessageRetentionDuration(com.google.protobuf.Duration value) {
       if (messageRetentionDurationBuilder_ == null) {
@@ -3191,15 +3278,16 @@ public Builder mergeMessageRetentionDuration(com.google.protobuf.Duration value)
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearMessageRetentionDuration() {
       bitField0_ = (bitField0_ & ~0x00000080);
@@ -3215,15 +3303,16 @@ public Builder clearMessageRetentionDuration() {
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.Duration.Builder getMessageRetentionDurationBuilder() {
       bitField0_ |= 0x00000080;
@@ -3234,15 +3323,16 @@ public com.google.protobuf.Duration.Builder getMessageRetentionDurationBuilder()
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder() {
       if (messageRetentionDurationBuilder_ != null) {
@@ -3257,15 +3347,16 @@ public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilde
      *
      *
      * 
-     * How long to retain unacknowledged messages in the subscription's backlog,
-     * from the moment a message is published.
-     * If `retain_acked_messages` is true, then this also configures the retention
-     * 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.
+     * Optional. How long to retain unacknowledged messages in the subscription's
+     * backlog, from the moment a message is published. If `retain_acked_messages`
+     * is true, then this also configures the retention 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.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.Duration,
@@ -3313,11 +3404,11 @@ public int getLabelsCount() {
      *
      *
      * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 9;
+     * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public boolean containsLabels(java.lang.String key) {
@@ -3336,11 +3427,11 @@ public java.util.Map getLabels() {
      *
      *
      * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 9;
+     * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public java.util.Map getLabelsMap() {
@@ -3350,11 +3441,11 @@ public java.util.Map getLabelsMap() {
      *
      *
      * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 9;
+     * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public /* nullable */ java.lang.String getLabelsOrDefault(
@@ -3371,11 +3462,11 @@ public java.util.Map getLabelsMap() {
      *
      *
      * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 9;
+     * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public java.lang.String getLabelsOrThrow(java.lang.String key) {
@@ -3398,11 +3489,11 @@ public Builder clearLabels() {
      *
      *
      * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 9;
+     * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder removeLabels(java.lang.String key) {
       if (key == null) {
@@ -3421,11 +3512,11 @@ public java.util.Map getMutableLabels() {
      *
      *
      * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 9;
+     * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder putLabels(java.lang.String key, java.lang.String value) {
       if (key == null) {
@@ -3442,11 +3533,11 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
      *
      *
      * 
-     * See [Creating and managing
+     * Optional. See [Creating and managing
      * labels](https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 9;
+     * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder putAllLabels(java.util.Map values) {
       internalGetMutableLabels().getMutableMap().putAll(values);
@@ -3459,13 +3550,13 @@ public Builder putAllLabels(java.util.Map va
      *
      *
      * 
-     * If true, messages published with the same `ordering_key` in `PubsubMessage`
-     * will be delivered to the subscribers in the order in which they
-     * are received by the Pub/Sub system. Otherwise, they may be delivered in
-     * any order.
+     * Optional. If true, messages published with the same `ordering_key` in
+     * `PubsubMessage` will be delivered to the subscribers in the order in which
+     * they are received by the Pub/Sub system. Otherwise, they may be delivered
+     * in any order.
      * 

      *
-     * bool enable_message_ordering = 10;
+     * bool enable_message_ordering = 10 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The enableMessageOrdering.
      */
@@ -3477,13 +3568,13 @@ public boolean getEnableMessageOrdering() {
      *
      *
      * 
-     * If true, messages published with the same `ordering_key` in `PubsubMessage`
-     * will be delivered to the subscribers in the order in which they
-     * are received by the Pub/Sub system. Otherwise, they may be delivered in
-     * any order.
+     * Optional. If true, messages published with the same `ordering_key` in
+     * `PubsubMessage` will be delivered to the subscribers in the order in which
+     * they are received by the Pub/Sub system. Otherwise, they may be delivered
+     * in any order.
      * 

      *
-     * bool enable_message_ordering = 10;
+     * bool enable_message_ordering = 10 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The enableMessageOrdering to set.
      * @return This builder for chaining.
@@ -3499,13 +3590,13 @@ public Builder setEnableMessageOrdering(boolean value) {
      *
      *
      * 
-     * If true, messages published with the same `ordering_key` in `PubsubMessage`
-     * will be delivered to the subscribers in the order in which they
-     * are received by the Pub/Sub system. Otherwise, they may be delivered in
-     * any order.
+     * Optional. If true, messages published with the same `ordering_key` in
+     * `PubsubMessage` will be delivered to the subscribers in the order in which
+     * they are received by the Pub/Sub system. Otherwise, they may be delivered
+     * in any order.
      * 

      *
-     * bool enable_message_ordering = 10;
+     * bool enable_message_ordering = 10 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -3526,16 +3617,18 @@ public Builder clearEnableMessageOrdering() {
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the expirationPolicy field is set.
      */
@@ -3546,16 +3639,18 @@ public boolean hasExpirationPolicy() {
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The expirationPolicy.
      */
@@ -3572,16 +3667,18 @@ public com.google.pubsub.v1.ExpirationPolicy getExpirationPolicy() {
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setExpirationPolicy(com.google.pubsub.v1.ExpirationPolicy value) {
       if (expirationPolicyBuilder_ == null) {
@@ -3600,16 +3697,18 @@ public Builder setExpirationPolicy(com.google.pubsub.v1.ExpirationPolicy value)
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setExpirationPolicy(
         com.google.pubsub.v1.ExpirationPolicy.Builder builderForValue) {
@@ -3626,16 +3725,18 @@ public Builder setExpirationPolicy(
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeExpirationPolicy(com.google.pubsub.v1.ExpirationPolicy value) {
       if (expirationPolicyBuilder_ == null) {
@@ -3657,16 +3758,18 @@ public Builder mergeExpirationPolicy(com.google.pubsub.v1.ExpirationPolicy value
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearExpirationPolicy() {
       bitField0_ = (bitField0_ & ~0x00000400);
@@ -3682,16 +3785,18 @@ public Builder clearExpirationPolicy() {
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.ExpirationPolicy.Builder getExpirationPolicyBuilder() {
       bitField0_ |= 0x00000400;
@@ -3702,16 +3807,18 @@ public com.google.pubsub.v1.ExpirationPolicy.Builder getExpirationPolicyBuilder(
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuilder() {
       if (expirationPolicyBuilder_ != null) {
@@ -3726,16 +3833,18 @@ public com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuild
      *
      *
      * 
-     * A policy that specifies the conditions for this subscription's expiration.
-     * A subscription is considered active as long as any connected subscriber is
-     * successfully consuming messages from the subscription or is issuing
-     * operations on the subscription. If `expiration_policy` is not set, a
-     * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+     * Optional. A policy that specifies the conditions for this subscription's
+     * expiration. A subscription is considered active as long as any connected
+     * subscriber is successfully consuming messages from the subscription or is
+     * issuing operations on the subscription. If `expiration_policy` is not set,
+     * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
      * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
      * but `expiration_policy.ttl` is not set, the subscription never expires.
      * 

      *
-     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+     * 
+     * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.ExpirationPolicy,
@@ -3759,14 +3868,14 @@ public com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuild
      *
      *
      * 
-     * An expression written in the Pub/Sub [filter
+     * Optional. An expression written in the Pub/Sub [filter
      * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
      * 

      *
-     * string filter = 12;
+     * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The filter.
      */
@@ -3785,14 +3894,14 @@ public java.lang.String getFilter() {
      *
      *
      * 
-     * An expression written in the Pub/Sub [filter
+     * Optional. An expression written in the Pub/Sub [filter
      * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
      * 

      *
-     * string filter = 12;
+     * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for filter.
      */
@@ -3811,14 +3920,14 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *
      *
      * 
-     * An expression written in the Pub/Sub [filter
+     * Optional. An expression written in the Pub/Sub [filter
      * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
      * 

      *
-     * string filter = 12;
+     * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The filter to set.
      * @return This builder for chaining.
@@ -3836,14 +3945,14 @@ public Builder setFilter(java.lang.String value) {
      *
      *
      * 
-     * An expression written in the Pub/Sub [filter
+     * Optional. An expression written in the Pub/Sub [filter
      * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
      * 

      *
-     * string filter = 12;
+     * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -3857,14 +3966,14 @@ public Builder clearFilter() {
      *
      *
      * 
-     * An expression written in the Pub/Sub [filter
+     * Optional. An expression written in the Pub/Sub [filter
      * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
      * then only `PubsubMessage`s whose `attributes` field matches the filter are
      * delivered on this subscription. If empty, then no messages are filtered
      * out.
      * 

      *
-     * string filter = 12;
+     * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for filter to set.
      * @return This builder for chaining.
@@ -3890,17 +3999,19 @@ public Builder setFilterBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the deadLetterPolicy field is set.
      */
@@ -3911,17 +4022,19 @@ public boolean hasDeadLetterPolicy() {
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The deadLetterPolicy.
      */
@@ -3938,17 +4051,19 @@ public com.google.pubsub.v1.DeadLetterPolicy getDeadLetterPolicy() {
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setDeadLetterPolicy(com.google.pubsub.v1.DeadLetterPolicy value) {
       if (deadLetterPolicyBuilder_ == null) {
@@ -3967,17 +4082,19 @@ public Builder setDeadLetterPolicy(com.google.pubsub.v1.DeadLetterPolicy value)
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setDeadLetterPolicy(
         com.google.pubsub.v1.DeadLetterPolicy.Builder builderForValue) {
@@ -3994,17 +4111,19 @@ public Builder setDeadLetterPolicy(
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeDeadLetterPolicy(com.google.pubsub.v1.DeadLetterPolicy value) {
       if (deadLetterPolicyBuilder_ == null) {
@@ -4026,17 +4145,19 @@ public Builder mergeDeadLetterPolicy(com.google.pubsub.v1.DeadLetterPolicy value
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearDeadLetterPolicy() {
       bitField0_ = (bitField0_ & ~0x00001000);
@@ -4052,17 +4173,19 @@ public Builder clearDeadLetterPolicy() {
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.DeadLetterPolicy.Builder getDeadLetterPolicyBuilder() {
       bitField0_ |= 0x00001000;
@@ -4073,17 +4196,19 @@ public com.google.pubsub.v1.DeadLetterPolicy.Builder getDeadLetterPolicyBuilder(
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuilder() {
       if (deadLetterPolicyBuilder_ != null) {
@@ -4098,17 +4223,19 @@ public com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuild
      *
      *
      * 
-     * A policy that specifies the conditions for dead lettering messages in
-     * this subscription. If dead_letter_policy is not set, dead lettering
-     * is disabled.
+     * Optional. A policy that specifies the conditions for dead lettering
+     * messages in this subscription. If dead_letter_policy is not set, dead
+     * lettering is disabled.
      *
-     * The Cloud Pub/Sub service account associated with this subscriptions's
+     * The Pub/Sub service account associated with this subscriptions's
      * parent project (i.e.,
      * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
      * permission to Acknowledge() messages on this subscription.
      * 

      *
-     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+     * 
+     * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.DeadLetterPolicy,
@@ -4137,8 +4264,8 @@ public com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuild
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4146,7 +4273,9 @@ public com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuild
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the retryPolicy field is set.
      */
@@ -4157,8 +4286,8 @@ public boolean hasRetryPolicy() {
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4166,7 +4295,9 @@ public boolean hasRetryPolicy() {
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The retryPolicy.
      */
@@ -4183,8 +4314,8 @@ public com.google.pubsub.v1.RetryPolicy getRetryPolicy() {
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4192,7 +4323,9 @@ public com.google.pubsub.v1.RetryPolicy getRetryPolicy() {
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setRetryPolicy(com.google.pubsub.v1.RetryPolicy value) {
       if (retryPolicyBuilder_ == null) {
@@ -4211,8 +4344,8 @@ public Builder setRetryPolicy(com.google.pubsub.v1.RetryPolicy value) {
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4220,7 +4353,9 @@ public Builder setRetryPolicy(com.google.pubsub.v1.RetryPolicy value) {
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setRetryPolicy(com.google.pubsub.v1.RetryPolicy.Builder builderForValue) {
       if (retryPolicyBuilder_ == null) {
@@ -4236,8 +4371,8 @@ public Builder setRetryPolicy(com.google.pubsub.v1.RetryPolicy.Builder builderFo
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4245,7 +4380,9 @@ public Builder setRetryPolicy(com.google.pubsub.v1.RetryPolicy.Builder builderFo
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeRetryPolicy(com.google.pubsub.v1.RetryPolicy value) {
       if (retryPolicyBuilder_ == null) {
@@ -4267,8 +4404,8 @@ public Builder mergeRetryPolicy(com.google.pubsub.v1.RetryPolicy value) {
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4276,7 +4413,9 @@ public Builder mergeRetryPolicy(com.google.pubsub.v1.RetryPolicy value) {
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearRetryPolicy() {
       bitField0_ = (bitField0_ & ~0x00002000);
@@ -4292,8 +4431,8 @@ public Builder clearRetryPolicy() {
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4301,7 +4440,9 @@ public Builder clearRetryPolicy() {
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.RetryPolicy.Builder getRetryPolicyBuilder() {
       bitField0_ |= 0x00002000;
@@ -4312,8 +4453,8 @@ public com.google.pubsub.v1.RetryPolicy.Builder getRetryPolicyBuilder() {
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4321,7 +4462,9 @@ public com.google.pubsub.v1.RetryPolicy.Builder getRetryPolicyBuilder() {
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder() {
       if (retryPolicyBuilder_ != null) {
@@ -4336,8 +4479,8 @@ public com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder() {
      *
      *
      * 
-     * A policy that specifies how Pub/Sub retries message delivery for this
-     * subscription.
+     * Optional. A policy that specifies how Pub/Sub retries message delivery for
+     * this subscription.
      *
      * If not set, the default retry policy is applied. This generally implies
      * that messages will be retried as soon as possible for healthy subscribers.
@@ -4345,7 +4488,9 @@ public com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder() {
      * exceeded events for a given message.
      * 

      *
-     * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+     * 
+     * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.RetryPolicy,
@@ -4369,14 +4514,14 @@ public com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder() {
      *
      *
      * 
-     * Indicates whether the subscription is detached from its topic. Detached
-     * subscriptions don't receive messages from their topic and don't retain any
-     * backlog. `Pull` and `StreamingPull` requests will return
+     * Optional. Indicates whether the subscription is detached from its topic.
+     * Detached subscriptions don't receive messages from their topic and don't
+     * retain any backlog. `Pull` and `StreamingPull` requests will return
      * FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
      * the endpoint will not be made.
      * 

      *
-     * bool detached = 15;
+     * bool detached = 15 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The detached.
      */
@@ -4388,14 +4533,14 @@ public boolean getDetached() {
      *
      *
      * 
-     * Indicates whether the subscription is detached from its topic. Detached
-     * subscriptions don't receive messages from their topic and don't retain any
-     * backlog. `Pull` and `StreamingPull` requests will return
+     * Optional. Indicates whether the subscription is detached from its topic.
+     * Detached subscriptions don't receive messages from their topic and don't
+     * retain any backlog. `Pull` and `StreamingPull` requests will return
      * FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
      * the endpoint will not be made.
      * 

      *
-     * bool detached = 15;
+     * bool detached = 15 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The detached to set.
      * @return This builder for chaining.
@@ -4411,14 +4556,14 @@ public Builder setDetached(boolean value) {
      *
      *
      * 
-     * Indicates whether the subscription is detached from its topic. Detached
-     * subscriptions don't receive messages from their topic and don't retain any
-     * backlog. `Pull` and `StreamingPull` requests will return
+     * Optional. Indicates whether the subscription is detached from its topic.
+     * Detached subscriptions don't receive messages from their topic and don't
+     * retain any backlog. `Pull` and `StreamingPull` requests will return
      * FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
      * the endpoint will not be made.
      * 

      *
-     * bool detached = 15;
+     * bool detached = 15 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -4434,8 +4579,9 @@ public Builder clearDetached() {
      *
      *
      * 
-     * If true, Pub/Sub provides the following guarantees for the delivery of
-     * a message with a given value of `message_id` on this subscription:
+     * Optional. If true, Pub/Sub provides the following guarantees for the
+     * delivery of a message with a given value of `message_id` on this
+     * subscription:
      *
      * * The message sent to a subscriber is guaranteed not to be resent
      * before the message's acknowledgement deadline expires.
@@ -4447,7 +4593,8 @@ public Builder clearDetached() {
      * by Pub/Sub and have distinct `message_id` values.
      * 

      *
-     * bool enable_exactly_once_delivery = 16;
+     * bool enable_exactly_once_delivery = 16 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The enableExactlyOnceDelivery.
      */
@@ -4459,8 +4606,9 @@ public boolean getEnableExactlyOnceDelivery() {
      *
      *
      * 
-     * If true, Pub/Sub provides the following guarantees for the delivery of
-     * a message with a given value of `message_id` on this subscription:
+     * Optional. If true, Pub/Sub provides the following guarantees for the
+     * delivery of a message with a given value of `message_id` on this
+     * subscription:
      *
      * * The message sent to a subscriber is guaranteed not to be resent
      * before the message's acknowledgement deadline expires.
@@ -4472,7 +4620,8 @@ public boolean getEnableExactlyOnceDelivery() {
      * by Pub/Sub and have distinct `message_id` values.
      * 

      *
-     * bool enable_exactly_once_delivery = 16;
+     * bool enable_exactly_once_delivery = 16 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @param value The enableExactlyOnceDelivery to set.
      * @return This builder for chaining.
@@ -4488,8 +4637,9 @@ public Builder setEnableExactlyOnceDelivery(boolean value) {
      *
      *
      * 
-     * If true, Pub/Sub provides the following guarantees for the delivery of
-     * a message with a given value of `message_id` on this subscription:
+     * Optional. If true, Pub/Sub provides the following guarantees for the
+     * delivery of a message with a given value of `message_id` on this
+     * subscription:
      *
      * * The message sent to a subscriber is guaranteed not to be resent
      * before the message's acknowledgement deadline expires.
@@ -4501,7 +4651,8 @@ public Builder setEnableExactlyOnceDelivery(boolean value) {
      * by Pub/Sub and have distinct `message_id` values.
      * 

      *
-     * bool enable_exactly_once_delivery = 16;
+     * bool enable_exactly_once_delivery = 16 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return This builder for chaining.
      */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
index c6b27d213..7aea7c12d 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -95,11 +95,12 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If push delivery is used with this subscription, this field is
+   * Optional. If push delivery is used with this subscription, this field is
    * used to configure it.
    * 

    *
-   * .google.pubsub.v1.PushConfig push_config = 4;
+   * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the pushConfig field is set.
    */
@@ -108,11 +109,12 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If push delivery is used with this subscription, this field is
+   * Optional. If push delivery is used with this subscription, this field is
    * used to configure it.
    * 

    *
-   * .google.pubsub.v1.PushConfig push_config = 4;
+   * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The pushConfig.
    */
@@ -121,11 +123,12 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If push delivery is used with this subscription, this field is
+   * Optional. If push delivery is used with this subscription, this field is
    * used to configure it.
    * 

    *
-   * .google.pubsub.v1.PushConfig push_config = 4;
+   * .google.pubsub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder();
 
@@ -133,11 +136,13 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If delivery to BigQuery is used with this subscription, this field is
-   * used to configure it.
+   * Optional. If delivery to BigQuery is used with this subscription, this
+   * field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+   * 
+   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the bigqueryConfig field is set.
    */
@@ -146,11 +151,13 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If delivery to BigQuery is used with this subscription, this field is
-   * used to configure it.
+   * Optional. If delivery to BigQuery is used with this subscription, this
+   * field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+   * 
+   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The bigqueryConfig.
    */
@@ -159,11 +166,13 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If delivery to BigQuery is used with this subscription, this field is
-   * used to configure it.
+   * Optional. If delivery to BigQuery is used with this subscription, this
+   * field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18;
+   * 
+   * .google.pubsub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.BigQueryConfigOrBuilder getBigqueryConfigOrBuilder();
 
@@ -171,11 +180,13 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If delivery to Google Cloud Storage is used with this subscription, this
-   * field is used to configure it.
+   * Optional. If delivery to Google Cloud Storage is used with this
+   * subscription, this field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the cloudStorageConfig field is set.
    */
@@ -184,11 +195,13 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If delivery to Google Cloud Storage is used with this subscription, this
-   * field is used to configure it.
+   * Optional. If delivery to Google Cloud Storage is used with this
+   * subscription, this field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The cloudStorageConfig.
    */
@@ -197,11 +210,13 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * If delivery to Google Cloud Storage is used with this subscription, this
-   * field is used to configure it.
+   * Optional. If delivery to Google Cloud Storage is used with this
+   * subscription, this field is used to configure it.
    * 

    *
-   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22;
+   * 
+   * .google.pubsub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.CloudStorageConfigOrBuilder getCloudStorageConfigOrBuilder();
 
@@ -209,11 +224,11 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * 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 _outstanding_. During that time period, the
-   * message will not be redelivered (on a best-effort basis).
+   * Optional. 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 _outstanding_. 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
@@ -231,7 +246,7 @@ public interface SubscriptionOrBuilder
    * system will eventually redeliver the message.
    * 

    *
-   * int32 ack_deadline_seconds = 5;
+   * int32 ack_deadline_seconds = 5 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The ackDeadlineSeconds.
    */
@@ -241,7 +256,7 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * Indicates whether to retain acknowledged messages. If true, then
+   * Optional. Indicates whether to retain acknowledged messages. If true, then
    * messages are not expunged from the subscription's backlog, even if they are
    * acknowledged, until they fall out of the `message_retention_duration`
    * window. This must be true if you would like to [`Seek` to a timestamp]
@@ -249,7 +264,7 @@ public interface SubscriptionOrBuilder
    * the past to replay previously-acknowledged messages.
    * 

    *
-   * bool retain_acked_messages = 7;
+   * bool retain_acked_messages = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The retainAckedMessages.
    */
@@ -259,15 +274,16 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * How long to retain unacknowledged messages in the subscription's backlog,
-   * from the moment a message is published.
-   * If `retain_acked_messages` is true, then this also configures the retention
-   * 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.
+   * Optional. How long to retain unacknowledged messages in the subscription's
+   * backlog, from the moment a message is published. If `retain_acked_messages`
+   * is true, then this also configures the retention 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.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the messageRetentionDuration field is set.
    */
@@ -276,15 +292,16 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * How long to retain unacknowledged messages in the subscription's backlog,
-   * from the moment a message is published.
-   * If `retain_acked_messages` is true, then this also configures the retention
-   * 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.
+   * Optional. How long to retain unacknowledged messages in the subscription's
+   * backlog, from the moment a message is published. If `retain_acked_messages`
+   * is true, then this also configures the retention 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.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The messageRetentionDuration.
    */
@@ -293,15 +310,16 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * How long to retain unacknowledged messages in the subscription's backlog,
-   * from the moment a message is published.
-   * If `retain_acked_messages` is true, then this also configures the retention
-   * 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.
+   * Optional. How long to retain unacknowledged messages in the subscription's
+   * backlog, from the moment a message is published. If `retain_acked_messages`
+   * is true, then this also configures the retention 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.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder();
 
@@ -309,22 +327,22 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   int getLabelsCount();
   /**
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   boolean containsLabels(java.lang.String key);
   /** Use {@link #getLabelsMap()} instead. */
@@ -334,22 +352,22 @@ public interface SubscriptionOrBuilder
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   java.util.Map getLabelsMap();
   /**
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   /* nullable */
   java.lang.String getLabelsOrDefault(
@@ -360,11 +378,11 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * See [Creating and managing
+   * Optional. See [Creating and managing
    * labels](https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 9;
+   * map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];
    */
   java.lang.String getLabelsOrThrow(java.lang.String key);
 
@@ -372,13 +390,13 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * If true, messages published with the same `ordering_key` in `PubsubMessage`
-   * will be delivered to the subscribers in the order in which they
-   * are received by the Pub/Sub system. Otherwise, they may be delivered in
-   * any order.
+   * Optional. If true, messages published with the same `ordering_key` in
+   * `PubsubMessage` will be delivered to the subscribers in the order in which
+   * they are received by the Pub/Sub system. Otherwise, they may be delivered
+   * in any order.
    * 

    *
-   * bool enable_message_ordering = 10;
+   * bool enable_message_ordering = 10 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The enableMessageOrdering.
    */
@@ -388,16 +406,18 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies the conditions for this subscription's expiration.
-   * A subscription is considered active as long as any connected subscriber is
-   * successfully consuming messages from the subscription or is issuing
-   * operations on the subscription. If `expiration_policy` is not set, a
-   * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+   * Optional. A policy that specifies the conditions for this subscription's
+   * expiration. A subscription is considered active as long as any connected
+   * subscriber is successfully consuming messages from the subscription or is
+   * issuing operations on the subscription. If `expiration_policy` is not set,
+   * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
    * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
    * but `expiration_policy.ttl` is not set, the subscription never expires.
    * 

    *
-   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+   * 
+   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the expirationPolicy field is set.
    */
@@ -406,16 +426,18 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies the conditions for this subscription's expiration.
-   * A subscription is considered active as long as any connected subscriber is
-   * successfully consuming messages from the subscription or is issuing
-   * operations on the subscription. If `expiration_policy` is not set, a
-   * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+   * Optional. A policy that specifies the conditions for this subscription's
+   * expiration. A subscription is considered active as long as any connected
+   * subscriber is successfully consuming messages from the subscription or is
+   * issuing operations on the subscription. If `expiration_policy` is not set,
+   * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
    * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
    * but `expiration_policy.ttl` is not set, the subscription never expires.
    * 

    *
-   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+   * 
+   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The expirationPolicy.
    */
@@ -424,16 +446,18 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies the conditions for this subscription's expiration.
-   * A subscription is considered active as long as any connected subscriber is
-   * successfully consuming messages from the subscription or is issuing
-   * operations on the subscription. If `expiration_policy` is not set, a
-   * *default policy* with `ttl` of 31 days will be used. The minimum allowed
+   * Optional. A policy that specifies the conditions for this subscription's
+   * expiration. A subscription is considered active as long as any connected
+   * subscriber is successfully consuming messages from the subscription or is
+   * issuing operations on the subscription. If `expiration_policy` is not set,
+   * a *default policy* with `ttl` of 31 days will be used. The minimum allowed
    * value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
    * but `expiration_policy.ttl` is not set, the subscription never expires.
    * 

    *
-   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
+   * 
+   * .google.pubsub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuilder();
 
@@ -441,14 +465,14 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * An expression written in the Pub/Sub [filter
+   * Optional. An expression written in the Pub/Sub [filter
    * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.
    * 

    *
-   * string filter = 12;
+   * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The filter.
    */
@@ -457,14 +481,14 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * An expression written in the Pub/Sub [filter
+   * Optional. An expression written in the Pub/Sub [filter
    * language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
    * then only `PubsubMessage`s whose `attributes` field matches the filter are
    * delivered on this subscription. If empty, then no messages are filtered
    * out.
    * 

    *
-   * string filter = 12;
+   * string filter = 12 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for filter.
    */
@@ -474,17 +498,19 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies the conditions for dead lettering messages in
-   * this subscription. If dead_letter_policy is not set, dead lettering
-   * is disabled.
+   * Optional. A policy that specifies the conditions for dead lettering
+   * messages in this subscription. If dead_letter_policy is not set, dead
+   * lettering is disabled.
    *
-   * The Cloud Pub/Sub service account associated with this subscriptions's
+   * The Pub/Sub service account associated with this subscriptions's
    * parent project (i.e.,
    * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
    * permission to Acknowledge() messages on this subscription.
    * 

    *
-   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+   * 
+   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the deadLetterPolicy field is set.
    */
@@ -493,17 +519,19 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies the conditions for dead lettering messages in
-   * this subscription. If dead_letter_policy is not set, dead lettering
-   * is disabled.
+   * Optional. A policy that specifies the conditions for dead lettering
+   * messages in this subscription. If dead_letter_policy is not set, dead
+   * lettering is disabled.
    *
-   * The Cloud Pub/Sub service account associated with this subscriptions's
+   * The Pub/Sub service account associated with this subscriptions's
    * parent project (i.e.,
    * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
    * permission to Acknowledge() messages on this subscription.
    * 

    *
-   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+   * 
+   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The deadLetterPolicy.
    */
@@ -512,17 +540,19 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies the conditions for dead lettering messages in
-   * this subscription. If dead_letter_policy is not set, dead lettering
-   * is disabled.
+   * Optional. A policy that specifies the conditions for dead lettering
+   * messages in this subscription. If dead_letter_policy is not set, dead
+   * lettering is disabled.
    *
-   * The Cloud Pub/Sub service account associated with this subscriptions's
+   * The Pub/Sub service account associated with this subscriptions's
    * parent project (i.e.,
    * service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
    * permission to Acknowledge() messages on this subscription.
    * 

    *
-   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
+   * 
+   * .google.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuilder();
 
@@ -530,8 +560,8 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies how Pub/Sub retries message delivery for this
-   * subscription.
+   * Optional. A policy that specifies how Pub/Sub retries message delivery for
+   * this subscription.
    *
    * If not set, the default retry policy is applied. This generally implies
    * that messages will be retried as soon as possible for healthy subscribers.
@@ -539,7 +569,9 @@ java.lang.String getLabelsOrDefault(
    * exceeded events for a given message.
    * 

    *
-   * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+   * 
+   * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the retryPolicy field is set.
    */
@@ -548,8 +580,8 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies how Pub/Sub retries message delivery for this
-   * subscription.
+   * Optional. A policy that specifies how Pub/Sub retries message delivery for
+   * this subscription.
    *
    * If not set, the default retry policy is applied. This generally implies
    * that messages will be retried as soon as possible for healthy subscribers.
@@ -557,7 +589,9 @@ java.lang.String getLabelsOrDefault(
    * exceeded events for a given message.
    * 

    *
-   * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+   * 
+   * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The retryPolicy.
    */
@@ -566,8 +600,8 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * A policy that specifies how Pub/Sub retries message delivery for this
-   * subscription.
+   * Optional. A policy that specifies how Pub/Sub retries message delivery for
+   * this subscription.
    *
    * If not set, the default retry policy is applied. This generally implies
    * that messages will be retried as soon as possible for healthy subscribers.
@@ -575,7 +609,9 @@ java.lang.String getLabelsOrDefault(
    * exceeded events for a given message.
    * 

    *
-   * .google.pubsub.v1.RetryPolicy retry_policy = 14;
+   * 
+   * .google.pubsub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder();
 
@@ -583,14 +619,14 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Indicates whether the subscription is detached from its topic. Detached
-   * subscriptions don't receive messages from their topic and don't retain any
-   * backlog. `Pull` and `StreamingPull` requests will return
+   * Optional. Indicates whether the subscription is detached from its topic.
+   * Detached subscriptions don't receive messages from their topic and don't
+   * retain any backlog. `Pull` and `StreamingPull` requests will return
    * FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
    * the endpoint will not be made.
    * 

    *
-   * bool detached = 15;
+   * bool detached = 15 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The detached.
    */
@@ -600,8 +636,9 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * If true, Pub/Sub provides the following guarantees for the delivery of
-   * a message with a given value of `message_id` on this subscription:
+   * Optional. If true, Pub/Sub provides the following guarantees for the
+   * delivery of a message with a given value of `message_id` on this
+   * subscription:
    *
    * * The message sent to a subscriber is guaranteed not to be resent
    * before the message's acknowledgement deadline expires.
@@ -613,7 +650,7 @@ java.lang.String getLabelsOrDefault(
    * by Pub/Sub and have distinct `message_id` values.
    * 

    *
-   * bool enable_exactly_once_delivery = 16;
+   * bool enable_exactly_once_delivery = 16 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The enableExactlyOnceDelivery.
    */
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
index 40ee471a5..760ec1fa6 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -40,6 +40,7 @@ private Topic(com.google.protobuf.GeneratedMessageV3.Builder builder) {
   private Topic() {
     name_ = "";
     kmsKeyName_ = "";
+    state_ = 0;
   }
 
   @java.lang.Override
@@ -72,6 +73,167 @@ protected com.google.protobuf.MapField internalGetMapField(int number) {
             com.google.pubsub.v1.Topic.class, com.google.pubsub.v1.Topic.Builder.class);
   }
 
+  /**
+   *
+   *
+   * 
+   * The state of the topic.
+   * 

+   *
+   * Protobuf enum {@code google.pubsub.v1.Topic.State}
+   */
+  public enum State implements com.google.protobuf.ProtocolMessageEnum {
+    /**
+     *
+     *
+     * 
+     * Default value. This value is unused.
+     * 

+     *
+     * STATE_UNSPECIFIED = 0;
+     */
+    STATE_UNSPECIFIED(0),
+    /**
+     *
+     *
+     * 
+     * The topic does not have any persistent errors.
+     * 

+     *
+     * ACTIVE = 1;
+     */
+    ACTIVE(1),
+    /**
+     *
+     *
+     * 
+     * Ingestion from the data source has encountered a permanent error.
+     * See the more detailed error state in the corresponding ingestion
+     * source configuration.
+     * 

+     *
+     * INGESTION_RESOURCE_ERROR = 2;
+     */
+    INGESTION_RESOURCE_ERROR(2),
+    UNRECOGNIZED(-1),
+    ;
+
+    /**
+     *
+     *
+     * 
+     * Default value. This value is unused.
+     * 

+     *
+     * STATE_UNSPECIFIED = 0;
+     */
+    public static final int STATE_UNSPECIFIED_VALUE = 0;
+    /**
+     *
+     *
+     * 
+     * The topic does not have any persistent errors.
+     * 

+     *
+     * ACTIVE = 1;
+     */
+    public static final int ACTIVE_VALUE = 1;
+    /**
+     *
+     *
+     * 
+     * Ingestion from the data source has encountered a permanent error.
+     * See the more detailed error state in the corresponding ingestion
+     * source configuration.
+     * 

+     *
+     * INGESTION_RESOURCE_ERROR = 2;
+     */
+    public static final int INGESTION_RESOURCE_ERROR_VALUE = 2;
+
+    public final int getNumber() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalArgumentException(
+            "Can't get the number of an unknown enum value.");
+      }
+      return value;
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
+    @java.lang.Deprecated
+    public static State valueOf(int value) {
+      return forNumber(value);
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     */
+    public static State forNumber(int value) {
+      switch (value) {
+        case 0:
+          return STATE_UNSPECIFIED;
+        case 1:
+          return ACTIVE;
+        case 2:
+          return INGESTION_RESOURCE_ERROR;
+        default:
+          return null;
+      }
+    }
+
+    public static com.google.protobuf.Internal.EnumLiteMap internalGetValueMap() {
+      return internalValueMap;
+    }
+
+    private static final com.google.protobuf.Internal.EnumLiteMap internalValueMap =
+        new com.google.protobuf.Internal.EnumLiteMap() {
+          public State findValueByNumber(int number) {
+            return State.forNumber(number);
+          }
+        };
+
+    public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalStateException(
+            "Can't get the descriptor of an unrecognized enum value.");
+      }
+      return getDescriptor().getValues().get(ordinal());
+    }
+
+    public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() {
+      return getDescriptor();
+    }
+
+    public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() {
+      return com.google.pubsub.v1.Topic.getDescriptor().getEnumTypes().get(0);
+    }
+
+    private static final State[] VALUES = values();
+
+    public static State valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc) {
+      if (desc.getType() != getDescriptor()) {
+        throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type.");
+      }
+      if (desc.getIndex() == -1) {
+        return UNRECOGNIZED;
+      }
+      return VALUES[desc.getIndex()];
+    }
+
+    private final int value;
+
+    private State(int value) {
+      this.value = value;
+    }
+
+    // @@protoc_insertion_point(enum_scope:google.pubsub.v1.Topic.State)
+  }
+
   public static final int NAME_FIELD_NUMBER = 1;
 
   @SuppressWarnings("serial")
@@ -163,11 +325,11 @@ public int getLabelsCount() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public boolean containsLabels(java.lang.String key) {
@@ -186,11 +348,11 @@ public java.util.Map getLabels() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public java.util.Map getLabelsMap() {
@@ -200,11 +362,11 @@ public java.util.Map getLabelsMap() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public /* nullable */ java.lang.String getLabelsOrDefault(
@@ -221,11 +383,11 @@ public java.util.Map getLabelsMap() {
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   @java.lang.Override
   public java.lang.String getLabelsOrThrow(java.lang.String key) {
@@ -245,12 +407,14 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) {
    *
    *
    * 
-   * Policy constraining the set of Google Cloud Platform regions where messages
-   * published to the topic may be stored. If not present, then no constraints
-   * are in effect.
+   * Optional. Policy constraining the set of Google Cloud Platform regions
+   * where messages published to the topic may be stored. If not present, then
+   * no constraints are in effect.
    * 

    *
-   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+   * 
+   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the messageStoragePolicy field is set.
    */
@@ -262,12 +426,14 @@ public boolean hasMessageStoragePolicy() {
    *
    *
    * 
-   * Policy constraining the set of Google Cloud Platform regions where messages
-   * published to the topic may be stored. If not present, then no constraints
-   * are in effect.
+   * Optional. Policy constraining the set of Google Cloud Platform regions
+   * where messages published to the topic may be stored. If not present, then
+   * no constraints are in effect.
    * 

    *
-   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+   * 
+   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The messageStoragePolicy.
    */
@@ -281,12 +447,14 @@ public com.google.pubsub.v1.MessageStoragePolicy getMessageStoragePolicy() {
    *
    *
    * 
-   * Policy constraining the set of Google Cloud Platform regions where messages
-   * published to the topic may be stored. If not present, then no constraints
-   * are in effect.
+   * Optional. Policy constraining the set of Google Cloud Platform regions
+   * where messages published to the topic may be stored. If not present, then
+   * no constraints are in effect.
    * 

    *
-   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+   * 
+   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.MessageStoragePolicyOrBuilder getMessageStoragePolicyOrBuilder() {
@@ -303,13 +471,13 @@ public com.google.pubsub.v1.MessageStoragePolicyOrBuilder getMessageStoragePolic
    *
    *
    * 
-   * The resource name of the Cloud KMS CryptoKey to be used to protect access
-   * to messages published on this topic.
+   * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+   * protect access to messages published on this topic.
    *
    * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
    * 

    *
-   * string kms_key_name = 5;
+   * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The kmsKeyName.
    */
@@ -329,13 +497,13 @@ public java.lang.String getKmsKeyName() {
    *
    *
    * 
-   * The resource name of the Cloud KMS CryptoKey to be used to protect access
-   * to messages published on this topic.
+   * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+   * protect access to messages published on this topic.
    *
    * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
    * 

    *
-   * string kms_key_name = 5;
+   * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for kmsKeyName.
    */
@@ -358,10 +526,12 @@ public com.google.protobuf.ByteString getKmsKeyNameBytes() {
    *
    *
    * 
-   * Settings for validating messages published against a schema.
+   * Optional. Settings for validating messages published against a schema.
    * 

    *
-   * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+   * 
+   * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the schemaSettings field is set.
    */
@@ -373,10 +543,12 @@ public boolean hasSchemaSettings() {
    *
    *
    * 
-   * Settings for validating messages published against a schema.
+   * Optional. Settings for validating messages published against a schema.
    * 

    *
-   * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+   * 
+   * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The schemaSettings.
    */
@@ -390,10 +562,12 @@ public com.google.pubsub.v1.SchemaSettings getSchemaSettings() {
    *
    *
    * 
-   * Settings for validating messages published against a schema.
+   * Optional. Settings for validating messages published against a schema.
    * 

    *
-   * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+   * 
+   * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.pubsub.v1.SchemaSettingsOrBuilder getSchemaSettingsOrBuilder() {
@@ -408,11 +582,11 @@ public com.google.pubsub.v1.SchemaSettingsOrBuilder getSchemaSettingsOrBuilder()
    *
    *
    * 
-   * Reserved for future use. This field is set only in responses from the
-   * server; it is ignored if it is set in any requests.
+   * Optional. Reserved for future use. This field is set only in responses from
+   * the server; it is ignored if it is set in any requests.
    * 

    *
-   * bool satisfies_pzs = 7;
+   * bool satisfies_pzs = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The satisfiesPzs.
    */
@@ -427,17 +601,20 @@ public boolean getSatisfiesPzs() {
    *
    *
    * 
-   * Indicates the minimum duration to retain a message after it is published to
-   * the topic. If this field is set, messages published to the topic in the
-   * last `message_retention_duration` are always available to subscribers. For
-   * instance, it allows any attached subscription to [seek to a
+   * Optional. Indicates the minimum duration to retain a message after it is
+   * published to the topic. If this field is set, messages published to the
+   * topic in the last `message_retention_duration` are always available to
+   * subscribers. For instance, it allows any attached subscription to [seek to
+   * a
    * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
    * that is up to `message_retention_duration` in the past. If this field is
    * not set, message retention is controlled by settings on individual
    * subscriptions. Cannot be more than 31 days or less than 10 minutes.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the messageRetentionDuration field is set.
    */
@@ -449,17 +626,20 @@ public boolean hasMessageRetentionDuration() {
    *
    *
    * 
-   * Indicates the minimum duration to retain a message after it is published to
-   * the topic. If this field is set, messages published to the topic in the
-   * last `message_retention_duration` are always available to subscribers. For
-   * instance, it allows any attached subscription to [seek to a
+   * Optional. Indicates the minimum duration to retain a message after it is
+   * published to the topic. If this field is set, messages published to the
+   * topic in the last `message_retention_duration` are always available to
+   * subscribers. For instance, it allows any attached subscription to [seek to
+   * a
    * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
    * that is up to `message_retention_duration` in the past. If this field is
    * not set, message retention is controlled by settings on individual
    * subscriptions. Cannot be more than 31 days or less than 10 minutes.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The messageRetentionDuration.
    */
@@ -473,17 +653,20 @@ public com.google.protobuf.Duration getMessageRetentionDuration() {
    *
    *
    * 
-   * Indicates the minimum duration to retain a message after it is published to
-   * the topic. If this field is set, messages published to the topic in the
-   * last `message_retention_duration` are always available to subscribers. For
-   * instance, it allows any attached subscription to [seek to a
+   * Optional. Indicates the minimum duration to retain a message after it is
+   * published to the topic. If this field is set, messages published to the
+   * topic in the last `message_retention_duration` are always available to
+   * subscribers. For instance, it allows any attached subscription to [seek to
+   * a
    * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
    * that is up to `message_retention_duration` in the past. If this field is
    * not set, message retention is controlled by settings on individual
    * subscriptions. Cannot be more than 31 days or less than 10 minutes.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   @java.lang.Override
   public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder() {
@@ -492,6 +675,102 @@ public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilde
         : messageRetentionDuration_;
   }
 
+  public static final int STATE_FIELD_NUMBER = 9;
+  private int state_ = 0;
+  /**
+   *
+   *
+   * 
+   * Output only. An output-only field indicating the state of the topic.
+   * 

+   *
+   * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   *
+   * @return The enum numeric value on the wire for state.
+   */
+  @java.lang.Override
+  public int getStateValue() {
+    return state_;
+  }
+  /**
+   *
+   *
+   * 
+   * Output only. An output-only field indicating the state of the topic.
+   * 

+   *
+   * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   *
+   * @return The state.
+   */
+  @java.lang.Override
+  public com.google.pubsub.v1.Topic.State getState() {
+    com.google.pubsub.v1.Topic.State result = com.google.pubsub.v1.Topic.State.forNumber(state_);
+    return result == null ? com.google.pubsub.v1.Topic.State.UNRECOGNIZED : result;
+  }
+
+  public static final int INGESTION_DATA_SOURCE_SETTINGS_FIELD_NUMBER = 10;
+  private com.google.pubsub.v1.IngestionDataSourceSettings ingestionDataSourceSettings_;
+  /**
+   *
+   *
+   * 
+   * Optional. Settings for managed ingestion from a data source into this
+   * topic.
+   * 

+   *
+   * 
+   * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return Whether the ingestionDataSourceSettings field is set.
+   */
+  @java.lang.Override
+  public boolean hasIngestionDataSourceSettings() {
+    return ingestionDataSourceSettings_ != null;
+  }
+  /**
+   *
+   *
+   * 
+   * Optional. Settings for managed ingestion from a data source into this
+   * topic.
+   * 

+   *
+   * 
+   * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return The ingestionDataSourceSettings.
+   */
+  @java.lang.Override
+  public com.google.pubsub.v1.IngestionDataSourceSettings getIngestionDataSourceSettings() {
+    return ingestionDataSourceSettings_ == null
+        ? com.google.pubsub.v1.IngestionDataSourceSettings.getDefaultInstance()
+        : ingestionDataSourceSettings_;
+  }
+  /**
+   *
+   *
+   * 
+   * Optional. Settings for managed ingestion from a data source into this
+   * topic.
+   * 

+   *
+   * 
+   * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   */
+  @java.lang.Override
+  public com.google.pubsub.v1.IngestionDataSourceSettingsOrBuilder
+      getIngestionDataSourceSettingsOrBuilder() {
+    return ingestionDataSourceSettings_ == null
+        ? com.google.pubsub.v1.IngestionDataSourceSettings.getDefaultInstance()
+        : ingestionDataSourceSettings_;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -526,6 +805,12 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (messageRetentionDuration_ != null) {
       output.writeMessage(8, getMessageRetentionDuration());
     }
+    if (state_ != com.google.pubsub.v1.Topic.State.STATE_UNSPECIFIED.getNumber()) {
+      output.writeEnum(9, state_);
+    }
+    if (ingestionDataSourceSettings_ != null) {
+      output.writeMessage(10, getIngestionDataSourceSettings());
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -566,6 +851,14 @@ public int getSerializedSize() {
           com.google.protobuf.CodedOutputStream.computeMessageSize(
               8, getMessageRetentionDuration());
     }
+    if (state_ != com.google.pubsub.v1.Topic.State.STATE_UNSPECIFIED.getNumber()) {
+      size += com.google.protobuf.CodedOutputStream.computeEnumSize(9, state_);
+    }
+    if (ingestionDataSourceSettings_ != null) {
+      size +=
+          com.google.protobuf.CodedOutputStream.computeMessageSize(
+              10, getIngestionDataSourceSettings());
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -597,6 +890,12 @@ public boolean equals(final java.lang.Object obj) {
     if (hasMessageRetentionDuration()) {
       if (!getMessageRetentionDuration().equals(other.getMessageRetentionDuration())) return false;
     }
+    if (state_ != other.state_) return false;
+    if (hasIngestionDataSourceSettings() != other.hasIngestionDataSourceSettings()) return false;
+    if (hasIngestionDataSourceSettings()) {
+      if (!getIngestionDataSourceSettings().equals(other.getIngestionDataSourceSettings()))
+        return false;
+    }
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -630,6 +929,12 @@ public int hashCode() {
       hash = (37 * hash) + MESSAGE_RETENTION_DURATION_FIELD_NUMBER;
       hash = (53 * hash) + getMessageRetentionDuration().hashCode();
     }
+    hash = (37 * hash) + STATE_FIELD_NUMBER;
+    hash = (53 * hash) + state_;
+    if (hasIngestionDataSourceSettings()) {
+      hash = (37 * hash) + INGESTION_DATA_SOURCE_SETTINGS_FIELD_NUMBER;
+      hash = (53 * hash) + getIngestionDataSourceSettings().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -805,6 +1110,12 @@ public Builder clear() {
         messageRetentionDurationBuilder_.dispose();
         messageRetentionDurationBuilder_ = null;
       }
+      state_ = 0;
+      ingestionDataSourceSettings_ = null;
+      if (ingestionDataSourceSettingsBuilder_ != null) {
+        ingestionDataSourceSettingsBuilder_.dispose();
+        ingestionDataSourceSettingsBuilder_ = null;
+      }
       return this;
     }
 
@@ -868,6 +1179,15 @@ private void buildPartial0(com.google.pubsub.v1.Topic result) {
                 ? messageRetentionDuration_
                 : messageRetentionDurationBuilder_.build();
       }
+      if (((from_bitField0_ & 0x00000080) != 0)) {
+        result.state_ = state_;
+      }
+      if (((from_bitField0_ & 0x00000100) != 0)) {
+        result.ingestionDataSourceSettings_ =
+            ingestionDataSourceSettingsBuilder_ == null
+                ? ingestionDataSourceSettings_
+                : ingestionDataSourceSettingsBuilder_.build();
+      }
     }
 
     @java.lang.Override
@@ -939,6 +1259,12 @@ public Builder mergeFrom(com.google.pubsub.v1.Topic other) {
       if (other.hasMessageRetentionDuration()) {
         mergeMessageRetentionDuration(other.getMessageRetentionDuration());
       }
+      if (other.state_ != 0) {
+        setStateValue(other.getStateValue());
+      }
+      if (other.hasIngestionDataSourceSettings()) {
+        mergeIngestionDataSourceSettings(other.getIngestionDataSourceSettings());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -1015,6 +1341,19 @@ public Builder mergeFrom(
                 bitField0_ |= 0x00000040;
                 break;
               } // case 66
+            case 72:
+              {
+                state_ = input.readEnum();
+                bitField0_ |= 0x00000080;
+                break;
+              } // case 72
+            case 82:
+              {
+                input.readMessage(
+                    getIngestionDataSourceSettingsFieldBuilder().getBuilder(), extensionRegistry);
+                bitField0_ |= 0x00000100;
+                break;
+              } // case 82
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -1194,11 +1533,11 @@ public int getLabelsCount() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 2;
+     * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public boolean containsLabels(java.lang.String key) {
@@ -1217,11 +1556,11 @@ public java.util.Map getLabels() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 2;
+     * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public java.util.Map getLabelsMap() {
@@ -1231,11 +1570,11 @@ public java.util.Map getLabelsMap() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 2;
+     * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public /* nullable */ java.lang.String getLabelsOrDefault(
@@ -1252,11 +1591,11 @@ public java.util.Map getLabelsMap() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 2;
+     * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     @java.lang.Override
     public java.lang.String getLabelsOrThrow(java.lang.String key) {
@@ -1279,11 +1618,11 @@ public Builder clearLabels() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 2;
+     * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder removeLabels(java.lang.String key) {
       if (key == null) {
@@ -1302,11 +1641,11 @@ public java.util.Map getMutableLabels() {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 2;
+     * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder putLabels(java.lang.String key, java.lang.String value) {
       if (key == null) {
@@ -1323,11 +1662,11 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
      *
      *
      * 
-     * See [Creating and managing labels]
+     * Optional. See [Creating and managing labels]
      * (https://cloud.google.com/pubsub/docs/labels).
      * 

      *
-     * map<string, string> labels = 2;
+     * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
      */
     public Builder putAllLabels(java.util.Map values) {
       internalGetMutableLabels().getMutableMap().putAll(values);
@@ -1345,12 +1684,14 @@ public Builder putAllLabels(java.util.Map va
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the messageStoragePolicy field is set.
      */
@@ -1361,12 +1702,14 @@ public boolean hasMessageStoragePolicy() {
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The messageStoragePolicy.
      */
@@ -1383,12 +1726,14 @@ public com.google.pubsub.v1.MessageStoragePolicy getMessageStoragePolicy() {
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMessageStoragePolicy(com.google.pubsub.v1.MessageStoragePolicy value) {
       if (messageStoragePolicyBuilder_ == null) {
@@ -1407,12 +1752,14 @@ public Builder setMessageStoragePolicy(com.google.pubsub.v1.MessageStoragePolicy
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMessageStoragePolicy(
         com.google.pubsub.v1.MessageStoragePolicy.Builder builderForValue) {
@@ -1429,12 +1776,14 @@ public Builder setMessageStoragePolicy(
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeMessageStoragePolicy(com.google.pubsub.v1.MessageStoragePolicy value) {
       if (messageStoragePolicyBuilder_ == null) {
@@ -1457,12 +1806,14 @@ public Builder mergeMessageStoragePolicy(com.google.pubsub.v1.MessageStoragePoli
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearMessageStoragePolicy() {
       bitField0_ = (bitField0_ & ~0x00000004);
@@ -1478,12 +1829,14 @@ public Builder clearMessageStoragePolicy() {
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.MessageStoragePolicy.Builder getMessageStoragePolicyBuilder() {
       bitField0_ |= 0x00000004;
@@ -1494,12 +1847,14 @@ public com.google.pubsub.v1.MessageStoragePolicy.Builder getMessageStoragePolicy
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.MessageStoragePolicyOrBuilder getMessageStoragePolicyOrBuilder() {
       if (messageStoragePolicyBuilder_ != null) {
@@ -1514,12 +1869,14 @@ public com.google.pubsub.v1.MessageStoragePolicyOrBuilder getMessageStoragePolic
      *
      *
      * 
-     * Policy constraining the set of Google Cloud Platform regions where messages
-     * published to the topic may be stored. If not present, then no constraints
-     * are in effect.
+     * Optional. Policy constraining the set of Google Cloud Platform regions
+     * where messages published to the topic may be stored. If not present, then
+     * no constraints are in effect.
      * 

      *
-     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+     * 
+     * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.MessageStoragePolicy,
@@ -1543,13 +1900,13 @@ public com.google.pubsub.v1.MessageStoragePolicyOrBuilder getMessageStoragePolic
      *
      *
      * 
-     * The resource name of the Cloud KMS CryptoKey to be used to protect access
-     * to messages published on this topic.
+     * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+     * protect access to messages published on this topic.
      *
      * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
      * 

      *
-     * string kms_key_name = 5;
+     * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The kmsKeyName.
      */
@@ -1568,13 +1925,13 @@ public java.lang.String getKmsKeyName() {
      *
      *
      * 
-     * The resource name of the Cloud KMS CryptoKey to be used to protect access
-     * to messages published on this topic.
+     * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+     * protect access to messages published on this topic.
      *
      * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
      * 

      *
-     * string kms_key_name = 5;
+     * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The bytes for kmsKeyName.
      */
@@ -1593,13 +1950,13 @@ public com.google.protobuf.ByteString getKmsKeyNameBytes() {
      *
      *
      * 
-     * The resource name of the Cloud KMS CryptoKey to be used to protect access
-     * to messages published on this topic.
+     * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+     * protect access to messages published on this topic.
      *
      * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
      * 

      *
-     * string kms_key_name = 5;
+     * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The kmsKeyName to set.
      * @return This builder for chaining.
@@ -1617,13 +1974,13 @@ public Builder setKmsKeyName(java.lang.String value) {
      *
      *
      * 
-     * The resource name of the Cloud KMS CryptoKey to be used to protect access
-     * to messages published on this topic.
+     * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+     * protect access to messages published on this topic.
      *
      * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
      * 

      *
-     * string kms_key_name = 5;
+     * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -1637,13 +1994,13 @@ public Builder clearKmsKeyName() {
      *
      *
      * 
-     * The resource name of the Cloud KMS CryptoKey to be used to protect access
-     * to messages published on this topic.
+     * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+     * protect access to messages published on this topic.
      *
      * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
      * 

      *
-     * string kms_key_name = 5;
+     * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The bytes for kmsKeyName to set.
      * @return This builder for chaining.
@@ -1669,10 +2026,12 @@ public Builder setKmsKeyNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the schemaSettings field is set.
      */
@@ -1683,10 +2042,12 @@ public boolean hasSchemaSettings() {
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The schemaSettings.
      */
@@ -1703,10 +2064,12 @@ public com.google.pubsub.v1.SchemaSettings getSchemaSettings() {
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setSchemaSettings(com.google.pubsub.v1.SchemaSettings value) {
       if (schemaSettingsBuilder_ == null) {
@@ -1725,10 +2088,12 @@ public Builder setSchemaSettings(com.google.pubsub.v1.SchemaSettings value) {
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setSchemaSettings(com.google.pubsub.v1.SchemaSettings.Builder builderForValue) {
       if (schemaSettingsBuilder_ == null) {
@@ -1744,10 +2109,12 @@ public Builder setSchemaSettings(com.google.pubsub.v1.SchemaSettings.Builder bui
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeSchemaSettings(com.google.pubsub.v1.SchemaSettings value) {
       if (schemaSettingsBuilder_ == null) {
@@ -1769,10 +2136,12 @@ public Builder mergeSchemaSettings(com.google.pubsub.v1.SchemaSettings value) {
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearSchemaSettings() {
       bitField0_ = (bitField0_ & ~0x00000010);
@@ -1788,10 +2157,12 @@ public Builder clearSchemaSettings() {
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.SchemaSettings.Builder getSchemaSettingsBuilder() {
       bitField0_ |= 0x00000010;
@@ -1802,10 +2173,12 @@ public com.google.pubsub.v1.SchemaSettings.Builder getSchemaSettingsBuilder() {
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.pubsub.v1.SchemaSettingsOrBuilder getSchemaSettingsOrBuilder() {
       if (schemaSettingsBuilder_ != null) {
@@ -1820,10 +2193,12 @@ public com.google.pubsub.v1.SchemaSettingsOrBuilder getSchemaSettingsOrBuilder()
      *
      *
      * 
-     * Settings for validating messages published against a schema.
+     * Optional. Settings for validating messages published against a schema.
      * 

      *
-     * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+     * 
+     * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.pubsub.v1.SchemaSettings,
@@ -1847,11 +2222,11 @@ public com.google.pubsub.v1.SchemaSettingsOrBuilder getSchemaSettingsOrBuilder()
      *
      *
      * 
-     * Reserved for future use. This field is set only in responses from the
-     * server; it is ignored if it is set in any requests.
+     * Optional. Reserved for future use. This field is set only in responses from
+     * the server; it is ignored if it is set in any requests.
      * 

      *
-     * bool satisfies_pzs = 7;
+     * bool satisfies_pzs = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return The satisfiesPzs.
      */
@@ -1863,11 +2238,11 @@ public boolean getSatisfiesPzs() {
      *
      *
      * 
-     * Reserved for future use. This field is set only in responses from the
-     * server; it is ignored if it is set in any requests.
+     * Optional. Reserved for future use. This field is set only in responses from
+     * the server; it is ignored if it is set in any requests.
      * 

      *
-     * bool satisfies_pzs = 7;
+     * bool satisfies_pzs = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @param value The satisfiesPzs to set.
      * @return This builder for chaining.
@@ -1883,11 +2258,11 @@ public Builder setSatisfiesPzs(boolean value) {
      *
      *
      * 
-     * Reserved for future use. This field is set only in responses from the
-     * server; it is ignored if it is set in any requests.
+     * Optional. Reserved for future use. This field is set only in responses from
+     * the server; it is ignored if it is set in any requests.
      * 

      *
-     * bool satisfies_pzs = 7;
+     * bool satisfies_pzs = 7 [(.google.api.field_behavior) = OPTIONAL];
      *
      * @return This builder for chaining.
      */
@@ -1908,17 +2283,20 @@ public Builder clearSatisfiesPzs() {
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return Whether the messageRetentionDuration field is set.
      */
@@ -1929,17 +2307,20 @@ public boolean hasMessageRetentionDuration() {
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      *
      * @return The messageRetentionDuration.
      */
@@ -1956,17 +2337,20 @@ public com.google.protobuf.Duration getMessageRetentionDuration() {
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMessageRetentionDuration(com.google.protobuf.Duration value) {
       if (messageRetentionDurationBuilder_ == null) {
@@ -1985,17 +2369,20 @@ public Builder setMessageRetentionDuration(com.google.protobuf.Duration value) {
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder setMessageRetentionDuration(
         com.google.protobuf.Duration.Builder builderForValue) {
@@ -2012,17 +2399,20 @@ public Builder setMessageRetentionDuration(
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder mergeMessageRetentionDuration(com.google.protobuf.Duration value) {
       if (messageRetentionDurationBuilder_ == null) {
@@ -2044,17 +2434,20 @@ public Builder mergeMessageRetentionDuration(com.google.protobuf.Duration value)
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public Builder clearMessageRetentionDuration() {
       bitField0_ = (bitField0_ & ~0x00000040);
@@ -2070,17 +2463,20 @@ public Builder clearMessageRetentionDuration() {
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.Duration.Builder getMessageRetentionDurationBuilder() {
       bitField0_ |= 0x00000040;
@@ -2091,17 +2487,20 @@ public com.google.protobuf.Duration.Builder getMessageRetentionDurationBuilder()
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder() {
       if (messageRetentionDurationBuilder_ != null) {
@@ -2116,17 +2515,20 @@ public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilde
      *
      *
      * 
-     * Indicates the minimum duration to retain a message after it is published to
-     * the topic. If this field is set, messages published to the topic in the
-     * last `message_retention_duration` are always available to subscribers. For
-     * instance, it allows any attached subscription to [seek to a
+     * Optional. Indicates the minimum duration to retain a message after it is
+     * published to the topic. If this field is set, messages published to the
+     * topic in the last `message_retention_duration` are always available to
+     * subscribers. For instance, it allows any attached subscription to [seek to
+     * a
      * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
      * that is up to `message_retention_duration` in the past. If this field is
      * not set, message retention is controlled by settings on individual
      * subscriptions. Cannot be more than 31 days or less than 10 minutes.
      * 

      *
-     * .google.protobuf.Duration message_retention_duration = 8;
+     * 
+     * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.Duration,
@@ -2145,6 +2547,316 @@ public com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilde
       return messageRetentionDurationBuilder_;
     }
 
+    private int state_ = 0;
+    /**
+     *
+     *
+     * 
+     * Output only. An output-only field indicating the state of the topic.
+     * 

+     *
+     * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     *
+     * @return The enum numeric value on the wire for state.
+     */
+    @java.lang.Override
+    public int getStateValue() {
+      return state_;
+    }
+    /**
+     *
+     *
+     * 
+     * Output only. An output-only field indicating the state of the topic.
+     * 

+     *
+     * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     *
+     * @param value The enum numeric value on the wire for state to set.
+     * @return This builder for chaining.
+     */
+    public Builder setStateValue(int value) {
+      state_ = value;
+      bitField0_ |= 0x00000080;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Output only. An output-only field indicating the state of the topic.
+     * 

+     *
+     * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     *
+     * @return The state.
+     */
+    @java.lang.Override
+    public com.google.pubsub.v1.Topic.State getState() {
+      com.google.pubsub.v1.Topic.State result = com.google.pubsub.v1.Topic.State.forNumber(state_);
+      return result == null ? com.google.pubsub.v1.Topic.State.UNRECOGNIZED : result;
+    }
+    /**
+     *
+     *
+     * 
+     * Output only. An output-only field indicating the state of the topic.
+     * 

+     *
+     * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     *
+     * @param value The state to set.
+     * @return This builder for chaining.
+     */
+    public Builder setState(com.google.pubsub.v1.Topic.State value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      bitField0_ |= 0x00000080;
+      state_ = value.getNumber();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Output only. An output-only field indicating the state of the topic.
+     * 

+     *
+     * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearState() {
+      bitField0_ = (bitField0_ & ~0x00000080);
+      state_ = 0;
+      onChanged();
+      return this;
+    }
+
+    private com.google.pubsub.v1.IngestionDataSourceSettings ingestionDataSourceSettings_;
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.pubsub.v1.IngestionDataSourceSettings,
+            com.google.pubsub.v1.IngestionDataSourceSettings.Builder,
+            com.google.pubsub.v1.IngestionDataSourceSettingsOrBuilder>
+        ingestionDataSourceSettingsBuilder_;
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     *
+     * @return Whether the ingestionDataSourceSettings field is set.
+     */
+    public boolean hasIngestionDataSourceSettings() {
+      return ((bitField0_ & 0x00000100) != 0);
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     *
+     * @return The ingestionDataSourceSettings.
+     */
+    public com.google.pubsub.v1.IngestionDataSourceSettings getIngestionDataSourceSettings() {
+      if (ingestionDataSourceSettingsBuilder_ == null) {
+        return ingestionDataSourceSettings_ == null
+            ? com.google.pubsub.v1.IngestionDataSourceSettings.getDefaultInstance()
+            : ingestionDataSourceSettings_;
+      } else {
+        return ingestionDataSourceSettingsBuilder_.getMessage();
+      }
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder setIngestionDataSourceSettings(
+        com.google.pubsub.v1.IngestionDataSourceSettings value) {
+      if (ingestionDataSourceSettingsBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ingestionDataSourceSettings_ = value;
+      } else {
+        ingestionDataSourceSettingsBuilder_.setMessage(value);
+      }
+      bitField0_ |= 0x00000100;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder setIngestionDataSourceSettings(
+        com.google.pubsub.v1.IngestionDataSourceSettings.Builder builderForValue) {
+      if (ingestionDataSourceSettingsBuilder_ == null) {
+        ingestionDataSourceSettings_ = builderForValue.build();
+      } else {
+        ingestionDataSourceSettingsBuilder_.setMessage(builderForValue.build());
+      }
+      bitField0_ |= 0x00000100;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder mergeIngestionDataSourceSettings(
+        com.google.pubsub.v1.IngestionDataSourceSettings value) {
+      if (ingestionDataSourceSettingsBuilder_ == null) {
+        if (((bitField0_ & 0x00000100) != 0)
+            && ingestionDataSourceSettings_ != null
+            && ingestionDataSourceSettings_
+                != com.google.pubsub.v1.IngestionDataSourceSettings.getDefaultInstance()) {
+          getIngestionDataSourceSettingsBuilder().mergeFrom(value);
+        } else {
+          ingestionDataSourceSettings_ = value;
+        }
+      } else {
+        ingestionDataSourceSettingsBuilder_.mergeFrom(value);
+      }
+      bitField0_ |= 0x00000100;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public Builder clearIngestionDataSourceSettings() {
+      bitField0_ = (bitField0_ & ~0x00000100);
+      ingestionDataSourceSettings_ = null;
+      if (ingestionDataSourceSettingsBuilder_ != null) {
+        ingestionDataSourceSettingsBuilder_.dispose();
+        ingestionDataSourceSettingsBuilder_ = null;
+      }
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public com.google.pubsub.v1.IngestionDataSourceSettings.Builder
+        getIngestionDataSourceSettingsBuilder() {
+      bitField0_ |= 0x00000100;
+      onChanged();
+      return getIngestionDataSourceSettingsFieldBuilder().getBuilder();
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    public com.google.pubsub.v1.IngestionDataSourceSettingsOrBuilder
+        getIngestionDataSourceSettingsOrBuilder() {
+      if (ingestionDataSourceSettingsBuilder_ != null) {
+        return ingestionDataSourceSettingsBuilder_.getMessageOrBuilder();
+      } else {
+        return ingestionDataSourceSettings_ == null
+            ? com.google.pubsub.v1.IngestionDataSourceSettings.getDefaultInstance()
+            : ingestionDataSourceSettings_;
+      }
+    }
+    /**
+     *
+     *
+     * 
+     * Optional. Settings for managed ingestion from a data source into this
+     * topic.
+     * 

+     *
+     * 
+     * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     */
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.pubsub.v1.IngestionDataSourceSettings,
+            com.google.pubsub.v1.IngestionDataSourceSettings.Builder,
+            com.google.pubsub.v1.IngestionDataSourceSettingsOrBuilder>
+        getIngestionDataSourceSettingsFieldBuilder() {
+      if (ingestionDataSourceSettingsBuilder_ == null) {
+        ingestionDataSourceSettingsBuilder_ =
+            new com.google.protobuf.SingleFieldBuilderV3<
+                com.google.pubsub.v1.IngestionDataSourceSettings,
+                com.google.pubsub.v1.IngestionDataSourceSettings.Builder,
+                com.google.pubsub.v1.IngestionDataSourceSettingsOrBuilder>(
+                getIngestionDataSourceSettings(), getParentForChildren(), isClean());
+        ingestionDataSourceSettings_ = null;
+      }
+      return ingestionDataSourceSettingsBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
index 6c8637285..a644cc313 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -62,22 +62,22 @@ public interface TopicOrBuilder
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   int getLabelsCount();
   /**
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   boolean containsLabels(java.lang.String key);
   /** Use {@link #getLabelsMap()} instead. */
@@ -87,22 +87,22 @@ public interface TopicOrBuilder
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   java.util.Map getLabelsMap();
   /**
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   /* nullable */
   java.lang.String getLabelsOrDefault(
@@ -113,11 +113,11 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * See [Creating and managing labels]
+   * Optional. See [Creating and managing labels]
    * (https://cloud.google.com/pubsub/docs/labels).
    * 

    *
-   * map<string, string> labels = 2;
+   * map<string, string> labels = 2 [(.google.api.field_behavior) = OPTIONAL];
    */
   java.lang.String getLabelsOrThrow(java.lang.String key);
 
@@ -125,12 +125,14 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Policy constraining the set of Google Cloud Platform regions where messages
-   * published to the topic may be stored. If not present, then no constraints
-   * are in effect.
+   * Optional. Policy constraining the set of Google Cloud Platform regions
+   * where messages published to the topic may be stored. If not present, then
+   * no constraints are in effect.
    * 

    *
-   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+   * 
+   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the messageStoragePolicy field is set.
    */
@@ -139,12 +141,14 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Policy constraining the set of Google Cloud Platform regions where messages
-   * published to the topic may be stored. If not present, then no constraints
-   * are in effect.
+   * Optional. Policy constraining the set of Google Cloud Platform regions
+   * where messages published to the topic may be stored. If not present, then
+   * no constraints are in effect.
    * 

    *
-   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+   * 
+   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The messageStoragePolicy.
    */
@@ -153,12 +157,14 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Policy constraining the set of Google Cloud Platform regions where messages
-   * published to the topic may be stored. If not present, then no constraints
-   * are in effect.
+   * Optional. Policy constraining the set of Google Cloud Platform regions
+   * where messages published to the topic may be stored. If not present, then
+   * no constraints are in effect.
    * 

    *
-   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3;
+   * 
+   * .google.pubsub.v1.MessageStoragePolicy message_storage_policy = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.MessageStoragePolicyOrBuilder getMessageStoragePolicyOrBuilder();
 
@@ -166,13 +172,13 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * The resource name of the Cloud KMS CryptoKey to be used to protect access
-   * to messages published on this topic.
+   * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+   * protect access to messages published on this topic.
    *
    * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
    * 

    *
-   * string kms_key_name = 5;
+   * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The kmsKeyName.
    */
@@ -181,13 +187,13 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * The resource name of the Cloud KMS CryptoKey to be used to protect access
-   * to messages published on this topic.
+   * Optional. The resource name of the Cloud KMS CryptoKey to be used to
+   * protect access to messages published on this topic.
    *
    * The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
    * 

    *
-   * string kms_key_name = 5;
+   * string kms_key_name = 5 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The bytes for kmsKeyName.
    */
@@ -197,10 +203,12 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Settings for validating messages published against a schema.
+   * Optional. Settings for validating messages published against a schema.
    * 

    *
-   * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+   * 
+   * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the schemaSettings field is set.
    */
@@ -209,10 +217,12 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Settings for validating messages published against a schema.
+   * Optional. Settings for validating messages published against a schema.
    * 

    *
-   * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+   * 
+   * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The schemaSettings.
    */
@@ -221,10 +231,12 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Settings for validating messages published against a schema.
+   * Optional. Settings for validating messages published against a schema.
    * 

    *
-   * .google.pubsub.v1.SchemaSettings schema_settings = 6;
+   * 
+   * .google.pubsub.v1.SchemaSettings schema_settings = 6 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.pubsub.v1.SchemaSettingsOrBuilder getSchemaSettingsOrBuilder();
 
@@ -232,11 +244,11 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Reserved for future use. This field is set only in responses from the
-   * server; it is ignored if it is set in any requests.
+   * Optional. Reserved for future use. This field is set only in responses from
+   * the server; it is ignored if it is set in any requests.
    * 

    *
-   * bool satisfies_pzs = 7;
+   * bool satisfies_pzs = 7 [(.google.api.field_behavior) = OPTIONAL];
    *
    * @return The satisfiesPzs.
    */
@@ -246,17 +258,20 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Indicates the minimum duration to retain a message after it is published to
-   * the topic. If this field is set, messages published to the topic in the
-   * last `message_retention_duration` are always available to subscribers. For
-   * instance, it allows any attached subscription to [seek to a
+   * Optional. Indicates the minimum duration to retain a message after it is
+   * published to the topic. If this field is set, messages published to the
+   * topic in the last `message_retention_duration` are always available to
+   * subscribers. For instance, it allows any attached subscription to [seek to
+   * a
    * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
    * that is up to `message_retention_duration` in the past. If this field is
    * not set, message retention is controlled by settings on individual
    * subscriptions. Cannot be more than 31 days or less than 10 minutes.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return Whether the messageRetentionDuration field is set.
    */
@@ -265,17 +280,20 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Indicates the minimum duration to retain a message after it is published to
-   * the topic. If this field is set, messages published to the topic in the
-   * last `message_retention_duration` are always available to subscribers. For
-   * instance, it allows any attached subscription to [seek to a
+   * Optional. Indicates the minimum duration to retain a message after it is
+   * published to the topic. If this field is set, messages published to the
+   * topic in the last `message_retention_duration` are always available to
+   * subscribers. For instance, it allows any attached subscription to [seek to
+   * a
    * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
    * that is up to `message_retention_duration` in the past. If this field is
    * not set, message retention is controlled by settings on individual
    * subscriptions. Cannot be more than 31 days or less than 10 minutes.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    *
    * @return The messageRetentionDuration.
    */
@@ -284,17 +302,92 @@ java.lang.String getLabelsOrDefault(
    *
    *
    * 
-   * Indicates the minimum duration to retain a message after it is published to
-   * the topic. If this field is set, messages published to the topic in the
-   * last `message_retention_duration` are always available to subscribers. For
-   * instance, it allows any attached subscription to [seek to a
+   * Optional. Indicates the minimum duration to retain a message after it is
+   * published to the topic. If this field is set, messages published to the
+   * topic in the last `message_retention_duration` are always available to
+   * subscribers. For instance, it allows any attached subscription to [seek to
+   * a
    * timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
    * that is up to `message_retention_duration` in the past. If this field is
    * not set, message retention is controlled by settings on individual
    * subscriptions. Cannot be more than 31 days or less than 10 minutes.
    * 

    *
-   * .google.protobuf.Duration message_retention_duration = 8;
+   * 
+   * .google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];
+   * 
    */
   com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder();
+
+  /**
+   *
+   *
+   * 
+   * Output only. An output-only field indicating the state of the topic.
+   * 

+   *
+   * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   *
+   * @return The enum numeric value on the wire for state.
+   */
+  int getStateValue();
+  /**
+   *
+   *
+   * 
+   * Output only. An output-only field indicating the state of the topic.
+   * 

+   *
+   * .google.pubsub.v1.Topic.State state = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   *
+   * @return The state.
+   */
+  com.google.pubsub.v1.Topic.State getState();
+
+  /**
+   *
+   *
+   * 
+   * Optional. Settings for managed ingestion from a data source into this
+   * topic.
+   * 

+   *
+   * 
+   * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return Whether the ingestionDataSourceSettings field is set.
+   */
+  boolean hasIngestionDataSourceSettings();
+  /**
+   *
+   *
+   * 
+   * Optional. Settings for managed ingestion from a data source into this
+   * topic.
+   * 

+   *
+   * 
+   * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   *
+   * @return The ingestionDataSourceSettings.
+   */
+  com.google.pubsub.v1.IngestionDataSourceSettings getIngestionDataSourceSettings();
+  /**
+   *
+   *
+   * 
+   * Optional. Settings for managed ingestion from a data source into this
+   * topic.
+   * 

+   *
+   * 
+   * .google.pubsub.v1.IngestionDataSourceSettings ingestion_data_source_settings = 10 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   */
+  com.google.pubsub.v1.IngestionDataSourceSettingsOrBuilder
+      getIngestionDataSourceSettingsOrBuilder();
 }
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java
index 03e24bcc3..19b2ed7aa 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequestOrBuilder.java
index 27027e92b..442f147ed 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSnapshotRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequest.java
index 921ead79e..744e91a07 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequestOrBuilder.java
index ab0f57de3..d812038a4 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateSubscriptionRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequest.java
index 49ef30ab3..415a8fa8f 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequestOrBuilder.java
index ce746a8ab..825ab31fd 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/UpdateTopicRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequest.java
index 8a5c924a6..fb823741c 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequestOrBuilder.java
index 30ee884fc..f4d4702b2 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponse.java
index b865330f1..e56de6312 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponse.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponse.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponseOrBuilder.java
index fb7717093..b20450cb4 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponseOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateMessageResponseOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequest.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequest.java
index e287bbd48..8a55996d7 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequest.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequest.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequestOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequestOrBuilder.java
index a7e443e7b..751ea98d5 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequestOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaRequestOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponse.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponse.java
index 002d5b390..99c7e1d36 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponse.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponse.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponseOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponseOrBuilder.java
index a6d1fa45f..9879319b9 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponseOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/ValidateSchemaResponseOrBuilder.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto b/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
index 393893b10..c548b2680 100644
--- a/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
+++ b/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
@@ -53,8 +53,8 @@ service Publisher {
     option (google.api.method_signature) = "name";
   }
 
-  // Updates an existing topic. Note that certain properties of a
-  // topic are not modifiable.
+  // Updates an existing topic by updating the fields specified in the update
+  // mask. Note that certain properties of a topic are not modifiable.
   rpc UpdateTopic(UpdateTopicRequest) returns (Topic) {
     option (google.api.http) = {
       patch: "/v1/{topic.name=projects/*/topics/*}"
@@ -137,13 +137,21 @@ service Publisher {
 
 // A policy constraining the storage of messages published to the topic.
 message MessageStoragePolicy {
-  // A list of IDs of Google Cloud regions where messages that are published
-  // to the topic may be persisted in storage. Messages published by publishers
-  // running in non-allowed Google Cloud regions (or running outside of Google
-  // Cloud altogether) are routed for storage in one of the allowed regions.
-  // An empty list means that no regions are allowed, and is not a valid
-  // configuration.
-  repeated string allowed_persistence_regions = 1;
+  // Optional. A list of IDs of Google Cloud regions where messages that are
+  // published to the topic may be persisted in storage. Messages published by
+  // publishers running in non-allowed Google Cloud regions (or running outside
+  // of Google Cloud altogether) are routed for storage in one of the allowed
+  // regions. An empty list means that no regions are allowed, and is not a
+  // valid configuration.
+  repeated string allowed_persistence_regions = 1
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, `allowed_persistence_regions` is also used to enforce
+  // in-transit guarantees for messages. That is, Pub/Sub will fail
+  // Publish operations on this topic and subscribe operations
+  // on any subscription attached to this topic in any region that is
+  // not in `allowed_persistence_regions`.
+  bool enforce_in_transit = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Settings for validating messages published against a schema.
@@ -157,18 +165,83 @@ message SchemaSettings {
     (google.api.resource_reference) = { type: "pubsub.googleapis.com/Schema" }
   ];
 
-  // The encoding of messages validated against `schema`.
-  Encoding encoding = 2;
+  // Optional. The encoding of messages validated against `schema`.
+  Encoding encoding = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The minimum (inclusive) revision allowed for validating messages. If empty
-  // or not present, allow any revision to be validated against last_revision or
-  // any revision created before.
-  string first_revision_id = 3;
+  // Optional. The minimum (inclusive) revision allowed for validating messages.
+  // If empty or not present, allow any revision to be validated against
+  // last_revision or any revision created before.
+  string first_revision_id = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // The maximum (inclusive) revision allowed for validating messages. If empty
-  // or not present, allow any revision to be validated against first_revision
-  // or any revision created after.
-  string last_revision_id = 4;
+  // Optional. The maximum (inclusive) revision allowed for validating messages.
+  // If empty or not present, allow any revision to be validated against
+  // first_revision or any revision created after.
+  string last_revision_id = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Settings for an ingestion data source on a topic.
+message IngestionDataSourceSettings {
+  // Ingestion settings for Amazon Kinesis Data Streams.
+  message AwsKinesis {
+    // Possible states for managed ingestion from Amazon Kinesis Data Streams.
+    enum State {
+      // Default value. This value is unused.
+      STATE_UNSPECIFIED = 0;
+
+      // Ingestion is active.
+      ACTIVE = 1;
+
+      // Permission denied encountered while consuming data from Kinesis.
+      // This can happen if:
+      //   - The provided `aws_role_arn` does not exist or does not have the
+      //     appropriate permissions attached.
+      //   - The provided `aws_role_arn` is not set up properly for Identity
+      //     Federation using `gcp_service_account`.
+      //   - The Pub/Sub SA is not granted the
+      //     `iam.serviceAccounts.getOpenIdToken` permission on
+      //     `gcp_service_account`.
+      KINESIS_PERMISSION_DENIED = 2;
+
+      // Permission denied encountered while publishing to the topic. This can
+      // happen due to Pub/Sub SA has not been granted the [appropriate publish
+      // permissions](https://cloud.google.com/pubsub/docs/access-control#pubsub.publisher)
+      PUBLISH_PERMISSION_DENIED = 3;
+
+      // The Kinesis stream does not exist.
+      STREAM_NOT_FOUND = 4;
+
+      // The Kinesis consumer does not exist.
+      CONSUMER_NOT_FOUND = 5;
+    }
+
+    // Output only. An output-only field that indicates the state of the Kinesis
+    // ingestion source.
+    State state = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Required. The Kinesis stream ARN to ingest data from.
+    string stream_arn = 2 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. The Kinesis consumer ARN to used for ingestion in Enhanced
+    // Fan-Out mode. The consumer must be already created and ready to be used.
+    string consumer_arn = 3 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. AWS role ARN to be used for Federated Identity authentication
+    // with Kinesis. Check the Pub/Sub docs for how to set up this role and the
+    // required permissions that need to be attached to it.
+    string aws_role_arn = 4 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. The GCP service account to be used for Federated Identity
+    // authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for
+    // the provided role). The `aws_role_arn` must be set up with
+    // `accounts.google.com:sub` equals to this service account number.
+    string gcp_service_account = 5 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Only one source type can have settings set.
+  oneof source {
+    // Optional. Amazon Kinesis Data Streams.
+    AwsKinesis aws_kinesis = 1 [(google.api.field_behavior) = OPTIONAL];
+  }
 }
 
 // A topic resource.
@@ -179,6 +252,20 @@ message Topic {
     pattern: "_deleted-topic_"
   };
 
+  // The state of the topic.
+  enum State {
+    // Default value. This value is unused.
+    STATE_UNSPECIFIED = 0;
+
+    // The topic does not have any persistent errors.
+    ACTIVE = 1;
+
+    // Ingestion from the data source has encountered a permanent error.
+    // See the more detailed error state in the corresponding ingestion
+    // source configuration.
+    INGESTION_RESOURCE_ERROR = 2;
+  }
+
   // Required. The name of the topic. It must have the format
   // `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
   // and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
@@ -187,37 +274,48 @@ message Topic {
   // must not start with `"goog"`.
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // See [Creating and managing labels]
+  // Optional. See [Creating and managing labels]
   // (https://cloud.google.com/pubsub/docs/labels).
-  map labels = 2;
+  map labels = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Policy constraining the set of Google Cloud Platform regions where messages
-  // published to the topic may be stored. If not present, then no constraints
-  // are in effect.
-  MessageStoragePolicy message_storage_policy = 3;
+  // Optional. Policy constraining the set of Google Cloud Platform regions
+  // where messages published to the topic may be stored. If not present, then
+  // no constraints are in effect.
+  MessageStoragePolicy message_storage_policy = 3
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // The resource name of the Cloud KMS CryptoKey to be used to protect access
-  // to messages published on this topic.
+  // Optional. The resource name of the Cloud KMS CryptoKey to be used to
+  // protect access to messages published on this topic.
   //
   // The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
-  string kms_key_name = 5;
+  string kms_key_name = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // Settings for validating messages published against a schema.
-  SchemaSettings schema_settings = 6;
+  // Optional. Settings for validating messages published against a schema.
+  SchemaSettings schema_settings = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // Reserved for future use. This field is set only in responses from the
-  // server; it is ignored if it is set in any requests.
-  bool satisfies_pzs = 7;
+  // Optional. Reserved for future use. This field is set only in responses from
+  // the server; it is ignored if it is set in any requests.
+  bool satisfies_pzs = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // Indicates the minimum duration to retain a message after it is published to
-  // the topic. If this field is set, messages published to the topic in the
-  // last `message_retention_duration` are always available to subscribers. For
-  // instance, it allows any attached subscription to [seek to a
+  // Optional. Indicates the minimum duration to retain a message after it is
+  // published to the topic. If this field is set, messages published to the
+  // topic in the last `message_retention_duration` are always available to
+  // subscribers. For instance, it allows any attached subscription to [seek to
+  // a
   // timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
   // that is up to `message_retention_duration` in the past. If this field is
   // not set, message retention is controlled by settings on individual
   // subscriptions. Cannot be more than 31 days or less than 10 minutes.
-  google.protobuf.Duration message_retention_duration = 8;
+  google.protobuf.Duration message_retention_duration = 8
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. An output-only field indicating the state of the topic.
+  State state = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Settings for managed ingestion from a data source into this
+  // topic.
+  IngestionDataSourceSettings ingestion_data_source_settings = 10
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A message that is published by publishers and consumed by subscribers. The
@@ -229,14 +327,14 @@ message Topic {
 // (https://cloud.google.com/pubsub/quotas) for more information about message
 // limits.
 message PubsubMessage {
-  // The message data field. If this field is empty, the message must contain
-  // at least one attribute.
-  bytes data = 1;
+  // Optional. The message data field. If this field is empty, the message must
+  // contain at least one attribute.
+  bytes data = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // Attributes for this message. If this field is empty, the message must
-  // contain non-empty data. This can be used to filter messages on the
+  // Optional. Attributes for this message. If this field is empty, the message
+  // must contain non-empty data. This can be used to filter messages on the
   // subscription.
-  map attributes = 2;
+  map attributes = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // ID of this message, assigned by the server when the message is published.
   // Guaranteed to be unique within the topic. This value may be read by a
@@ -249,15 +347,15 @@ message PubsubMessage {
   // publisher in a `Publish` call.
   google.protobuf.Timestamp publish_time = 4;
 
-  // If non-empty, identifies related messages for which publish order should be
-  // respected. If a `Subscription` has `enable_message_ordering` set to `true`,
-  // messages published with the same non-empty `ordering_key` value will be
-  // delivered to subscribers in the order in which they are received by the
-  // Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-  // must specify the same `ordering_key` value.
-  // For more information, see [ordering
+  // Optional. If non-empty, identifies related messages for which publish order
+  // should be respected. If a `Subscription` has `enable_message_ordering` set
+  // to `true`, messages published with the same non-empty `ordering_key` value
+  // will be delivered to subscribers in the order in which they are received by
+  // the Pub/Sub system. All `PubsubMessage`s published in a given
+  // `PublishRequest` must specify the same `ordering_key` value. For more
+  // information, see [ordering
   // messages](https://cloud.google.com/pubsub/docs/ordering).
-  string ordering_key = 5;
+  string ordering_key = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the GetTopic method.
@@ -299,10 +397,10 @@ message PublishRequest {
 
 // Response for the `Publish` method.
 message PublishResponse {
-  // The server-assigned ID of each published message, in the same order as
-  // the messages in the request. IDs are guaranteed to be unique within
-  // the topic.
-  repeated string message_ids = 1;
+  // Optional. The server-assigned ID of each published message, in the same
+  // order as the messages in the request. IDs are guaranteed to be unique
+  // within the topic.
+  repeated string message_ids = 1 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the `ListTopics` method.
@@ -316,23 +414,23 @@ message ListTopicsRequest {
     }
   ];
 
-  // Maximum number of topics to return.
-  int32 page_size = 2;
+  // Optional. Maximum number of topics to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The value returned by the last `ListTopicsResponse`; indicates that this is
-  // a continuation of a prior `ListTopics` call, and that the system should
-  // return the next page of data.
-  string page_token = 3;
+  // Optional. The value returned by the last `ListTopicsResponse`; indicates
+  // that this is a continuation of a prior `ListTopics` call, and that the
+  // system should return the next page of data.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for the `ListTopics` method.
 message ListTopicsResponse {
-  // The resulting topics.
-  repeated Topic topics = 1;
+  // Optional. The resulting topics.
+  repeated Topic topics = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // If not empty, indicates that there may be more topics that match the
-  // request; this value should be passed in a new `ListTopicsRequest`.
-  string next_page_token = 2;
+  // Optional. If not empty, indicates that there may be more topics that match
+  // the request; this value should be passed in a new `ListTopicsRequest`.
+  string next_page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the `ListTopicSubscriptions` method.
@@ -344,26 +442,30 @@ message ListTopicSubscriptionsRequest {
     (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
   ];
 
-  // Maximum number of subscription names to return.
-  int32 page_size = 2;
+  // Optional. Maximum number of subscription names to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-  // that this is a continuation of a prior `ListTopicSubscriptions` call, and
-  // that the system should return the next page of data.
-  string page_token = 3;
+  // Optional. The value returned by the last `ListTopicSubscriptionsResponse`;
+  // indicates that this is a continuation of a prior `ListTopicSubscriptions`
+  // call, and that the system should return the next page of data.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for the `ListTopicSubscriptions` method.
 message ListTopicSubscriptionsResponse {
-  // The names of subscriptions attached to the topic specified in the request.
-  repeated string subscriptions = 1 [(google.api.resource_reference) = {
-    type: "pubsub.googleapis.com/Subscription"
-  }];
+  // Optional. The names of subscriptions attached to the topic specified in the
+  // request.
+  repeated string subscriptions = 1 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
 
-  // If not empty, indicates that there may be more subscriptions that match
-  // the request; this value should be passed in a new
+  // Optional. If not empty, indicates that there may be more subscriptions that
+  // match the request; this value should be passed in a new
   // `ListTopicSubscriptionsRequest` to get more subscriptions.
-  string next_page_token = 2;
+  string next_page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the `ListTopicSnapshots` method.
@@ -375,24 +477,24 @@ message ListTopicSnapshotsRequest {
     (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
   ];
 
-  // Maximum number of snapshot names to return.
-  int32 page_size = 2;
+  // Optional. Maximum number of snapshot names to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The value returned by the last `ListTopicSnapshotsResponse`; indicates
-  // that this is a continuation of a prior `ListTopicSnapshots` call, and
-  // that the system should return the next page of data.
-  string page_token = 3;
+  // Optional. The value returned by the last `ListTopicSnapshotsResponse`;
+  // indicates that this is a continuation of a prior `ListTopicSnapshots` call,
+  // and that the system should return the next page of data.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for the `ListTopicSnapshots` method.
 message ListTopicSnapshotsResponse {
-  // The names of the snapshots that match the request.
-  repeated string snapshots = 1;
+  // Optional. The names of the snapshots that match the request.
+  repeated string snapshots = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // If not empty, indicates that there may be more snapshots that match
-  // the request; this value should be passed in a new
+  // Optional. If not empty, indicates that there may be more snapshots that
+  // match the request; this value should be passed in a new
   // `ListTopicSnapshotsRequest` to get more snapshots.
-  string next_page_token = 2;
+  string next_page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the `DeleteTopic` method.
@@ -458,8 +560,9 @@ service Subscriber {
     option (google.api.method_signature) = "subscription";
   }
 
-  // Updates an existing subscription. Note that certain properties of a
-  // subscription, such as its topic, are not modifiable.
+  // Updates an existing subscription by updating the fields specified in the
+  // update mask. Note that certain properties of a subscription, such as its
+  // topic, are not modifiable.
   rpc UpdateSubscription(UpdateSubscriptionRequest) returns (Subscription) {
     option (google.api.http) = {
       patch: "/v1/{subscription.name=projects/*/subscriptions/*}"
@@ -604,7 +707,8 @@ service Subscriber {
     option (google.api.method_signature) = "name,subscription";
   }
 
-  // Updates an existing snapshot. Snapshots are used in
+  // Updates an existing snapshot by updating the fields specified in the update
+  // mask. Snapshots are used in
   // [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
   // which allow you to manage message acknowledgments in bulk. That is, you can
   // set the acknowledgment state of messages in an existing subscription to the
@@ -687,23 +791,24 @@ message Subscription {
     (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
   ];
 
-  // If push delivery is used with this subscription, this field is
-  // used to configure it.
-  PushConfig push_config = 4;
-
-  // If delivery to BigQuery is used with this subscription, this field is
+  // Optional. If push delivery is used with this subscription, this field is
   // used to configure it.
-  BigQueryConfig bigquery_config = 18;
+  PushConfig push_config = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // If delivery to Google Cloud Storage is used with this subscription, this
+  // Optional. If delivery to BigQuery is used with this subscription, this
   // field is used to configure it.
-  CloudStorageConfig cloud_storage_config = 22;
-
-  // 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 _outstanding_. During that time period, the
-  // message will not be redelivered (on a best-effort basis).
+  BigQueryConfig bigquery_config = 18 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If delivery to Google Cloud Storage is used with this
+  // subscription, this field is used to configure it.
+  CloudStorageConfig cloud_storage_config = 22
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. 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 _outstanding_. 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
@@ -719,78 +824,81 @@ message Subscription {
   //
   // If the subscriber never acknowledges the message, the Pub/Sub
   // system will eventually redeliver the message.
-  int32 ack_deadline_seconds = 5;
+  int32 ack_deadline_seconds = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // Indicates whether to retain acknowledged messages. If true, then
+  // Optional. Indicates whether to retain acknowledged messages. If true, then
   // messages are not expunged from the subscription's backlog, even if they are
   // acknowledged, until they fall out of the `message_retention_duration`
   // window. This must be true if you would like to [`Seek` to a timestamp]
   // (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) in
   // the past to replay previously-acknowledged messages.
-  bool retain_acked_messages = 7;
+  bool retain_acked_messages = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // How long to retain unacknowledged messages in the subscription's backlog,
-  // from the moment a message is published.
-  // If `retain_acked_messages` is true, then this also configures the retention
-  // 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.
-  google.protobuf.Duration message_retention_duration = 8;
+  // Optional. How long to retain unacknowledged messages in the subscription's
+  // backlog, from the moment a message is published. If `retain_acked_messages`
+  // is true, then this also configures the retention 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.
+  google.protobuf.Duration message_retention_duration = 8
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // See [Creating and managing
+  // Optional. See [Creating and managing
   // labels](https://cloud.google.com/pubsub/docs/labels).
-  map labels = 9;
-
-  // If true, messages published with the same `ordering_key` in `PubsubMessage`
-  // will be delivered to the subscribers in the order in which they
-  // are received by the Pub/Sub system. Otherwise, they may be delivered in
-  // any order.
-  bool enable_message_ordering = 10;
-
-  // A policy that specifies the conditions for this subscription's expiration.
-  // A subscription is considered active as long as any connected subscriber is
-  // successfully consuming messages from the subscription or is issuing
-  // operations on the subscription. If `expiration_policy` is not set, a
-  // *default policy* with `ttl` of 31 days will be used. The minimum allowed
+  map labels = 9 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, messages published with the same `ordering_key` in
+  // `PubsubMessage` will be delivered to the subscribers in the order in which
+  // they are received by the Pub/Sub system. Otherwise, they may be delivered
+  // in any order.
+  bool enable_message_ordering = 10 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A policy that specifies the conditions for this subscription's
+  // expiration. A subscription is considered active as long as any connected
+  // subscriber is successfully consuming messages from the subscription or is
+  // issuing operations on the subscription. If `expiration_policy` is not set,
+  // a *default policy* with `ttl` of 31 days will be used. The minimum allowed
   // value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
   // but `expiration_policy.ttl` is not set, the subscription never expires.
-  ExpirationPolicy expiration_policy = 11;
+  ExpirationPolicy expiration_policy = 11
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // An expression written in the Pub/Sub [filter
+  // Optional. An expression written in the Pub/Sub [filter
   // language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
   // then only `PubsubMessage`s whose `attributes` field matches the filter are
   // delivered on this subscription. If empty, then no messages are filtered
   // out.
-  string filter = 12;
+  string filter = 12 [(google.api.field_behavior) = OPTIONAL];
 
-  // A policy that specifies the conditions for dead lettering messages in
-  // this subscription. If dead_letter_policy is not set, dead lettering
-  // is disabled.
+  // Optional. A policy that specifies the conditions for dead lettering
+  // messages in this subscription. If dead_letter_policy is not set, dead
+  // lettering is disabled.
   //
-  // The Cloud Pub/Sub service account associated with this subscriptions's
+  // The Pub/Sub service account associated with this subscriptions's
   // parent project (i.e.,
   // service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
   // permission to Acknowledge() messages on this subscription.
-  DeadLetterPolicy dead_letter_policy = 13;
+  DeadLetterPolicy dead_letter_policy = 13
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // A policy that specifies how Pub/Sub retries message delivery for this
-  // subscription.
+  // Optional. A policy that specifies how Pub/Sub retries message delivery for
+  // this subscription.
   //
   // If not set, the default retry policy is applied. This generally implies
   // that messages will be retried as soon as possible for healthy subscribers.
   // RetryPolicy will be triggered on NACKs or acknowledgement deadline
   // exceeded events for a given message.
-  RetryPolicy retry_policy = 14;
+  RetryPolicy retry_policy = 14 [(google.api.field_behavior) = OPTIONAL];
 
-  // Indicates whether the subscription is detached from its topic. Detached
-  // subscriptions don't receive messages from their topic and don't retain any
-  // backlog. `Pull` and `StreamingPull` requests will return
+  // Optional. Indicates whether the subscription is detached from its topic.
+  // Detached subscriptions don't receive messages from their topic and don't
+  // retain any backlog. `Pull` and `StreamingPull` requests will return
   // FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
   // the endpoint will not be made.
-  bool detached = 15;
+  bool detached = 15 [(google.api.field_behavior) = OPTIONAL];
 
-  // If true, Pub/Sub provides the following guarantees for the delivery of
-  // a message with a given value of `message_id` on this subscription:
+  // Optional. If true, Pub/Sub provides the following guarantees for the
+  // delivery of a message with a given value of `message_id` on this
+  // subscription:
   //
   // * The message sent to a subscriber is guaranteed not to be resent
   // before the message's acknowledgement deadline expires.
@@ -800,7 +908,8 @@ message Subscription {
   // when `enable_exactly_once_delivery` is true if the message was published
   // multiple times by a publisher client. These copies are  considered distinct
   // by Pub/Sub and have distinct `message_id` values.
-  bool enable_exactly_once_delivery = 16;
+  bool enable_exactly_once_delivery = 16
+      [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Indicates the minimum duration for which a message is retained
   // after it is published to the subscription's topic. If this field is set,
@@ -816,7 +925,7 @@ message Subscription {
   State state = 19 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
-// A policy that specifies how Cloud Pub/Sub retries message delivery.
+// A policy that specifies how Pub/Sub retries message delivery.
 //
 // Retry delay will be exponential based on provided minimum and maximum
 // backoffs. https://en.wikipedia.org/wiki/Exponential_backoff.
@@ -828,13 +937,16 @@ message Subscription {
 // between consecutive deliveries may not match the configuration. That is,
 // delay can be more or less than configured backoff.
 message RetryPolicy {
-  // The minimum delay between consecutive deliveries of a given message.
-  // Value should be between 0 and 600 seconds. Defaults to 10 seconds.
-  google.protobuf.Duration minimum_backoff = 1;
-
-  // The maximum delay between consecutive deliveries of a given message.
-  // Value should be between 0 and 600 seconds. Defaults to 600 seconds.
-  google.protobuf.Duration maximum_backoff = 2;
+  // Optional. The minimum delay between consecutive deliveries of a given
+  // message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+  google.protobuf.Duration minimum_backoff = 1
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The maximum delay between consecutive deliveries of a given
+  // message. Value should be between 0 and 600 seconds. Defaults to 600
+  // seconds.
+  google.protobuf.Duration maximum_backoff = 2
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Dead lettering is done on a best effort basis. The same message might be
@@ -843,19 +955,19 @@ message RetryPolicy {
 // If validation on any of the fields fails at subscription creation/updation,
 // the create/update subscription request will fail.
 message DeadLetterPolicy {
-  // The name of the topic to which dead letter messages should be published.
-  // Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
-  // account associated with the enclosing subscription's parent project (i.e.,
-  // service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-  // permission to Publish() to this topic.
+  // Optional. The name of the topic to which dead letter messages should be
+  // published. Format is `projects/{project}/topics/{topic}`.The Pub/Sub
+  // service account associated with the enclosing subscription's parent project
+  // (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must
+  // have permission to Publish() to this topic.
   //
   // The operation will fail if the topic does not exist.
   // Users should ensure that there is a subscription attached to this topic
   // since messages published to a topic with no subscriptions are lost.
-  string dead_letter_topic = 1;
+  string dead_letter_topic = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // The maximum number of delivery attempts for any message. The value must be
-  // between 5 and 100.
+  // Optional. The maximum number of delivery attempts for any message. The
+  // value must be between 5 and 100.
   //
   // The number of delivery attempts is defined as 1 + (the sum of number of
   // NACKs and number of times the acknowledgement deadline has been exceeded
@@ -867,19 +979,19 @@ message DeadLetterPolicy {
   // This field will be honored on a best effort basis.
   //
   // If this parameter is 0, a default value of 5 is used.
-  int32 max_delivery_attempts = 2;
+  int32 max_delivery_attempts = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A policy that specifies the conditions for resource expiration (i.e.,
 // automatic resource deletion).
 message ExpirationPolicy {
-  // Specifies the "time-to-live" duration for an associated resource. The
-  // resource expires if it is not active for a period of `ttl`. The definition
-  // of "activity" depends on the type of the associated resource. The minimum
-  // and maximum allowed values for `ttl` depend on the type of the associated
-  // resource, as well. If `ttl` is not set, the associated resource never
-  // expires.
-  google.protobuf.Duration ttl = 1;
+  // Optional. Specifies the "time-to-live" duration for an associated resource.
+  // The resource expires if it is not active for a period of `ttl`. The
+  // definition of "activity" depends on the type of the associated resource.
+  // The minimum and maximum allowed values for `ttl` depend on the type of the
+  // associated resource, as well. If `ttl` is not set, the associated resource
+  // never expires.
+  google.protobuf.Duration ttl = 1 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Configuration for a push delivery endpoint.
@@ -888,20 +1000,21 @@ message PushConfig {
   // [OpenID Connect
   // token](https://developers.google.com/identity/protocols/OpenIDConnect).
   message OidcToken {
-    // [Service account
+    // Optional. [Service account
     // email](https://cloud.google.com/iam/docs/service-accounts)
     // used for generating the OIDC token. For more information
     // on setting up authentication, see
     // [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
-    string service_account_email = 1;
-
-    // Audience to be used when generating OIDC token. The audience claim
-    // identifies the recipients that the JWT is intended for. The audience
-    // value is a single case-sensitive string. Having multiple values (array)
-    // for the audience field is not supported. More info about the OIDC JWT
-    // token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-    // Note: if not specified, the Push endpoint URL will be used.
-    string audience = 2;
+    string service_account_email = 1 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Audience to be used when generating OIDC token. The audience
+    // claim identifies the recipients that the JWT is intended for. The
+    // audience value is a single case-sensitive string. Having multiple values
+    // (array) for the audience field is not supported. More info about the OIDC
+    // JWT token audience here:
+    // https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified,
+    // the Push endpoint URL will be used.
+    string audience = 2 [(google.api.field_behavior) = OPTIONAL];
   }
 
   // The payload to the push endpoint is in the form of the JSON representation
@@ -911,18 +1024,18 @@ message PushConfig {
 
   // Sets the `data` field as the HTTP body for delivery.
   message NoWrapper {
-    // When true, writes the Pub/Sub message metadata to
+    // Optional. When true, writes the Pub/Sub message metadata to
     // `x-goog-pubsub-:` headers of the HTTP request. Writes the
     // Pub/Sub message attributes to `:` headers of the HTTP request.
-    bool write_metadata = 1;
+    bool write_metadata = 1 [(google.api.field_behavior) = OPTIONAL];
   }
 
-  // A URL locating the endpoint to which messages should be pushed.
+  // Optional. A URL locating the endpoint to which messages should be pushed.
   // For example, a Webhook endpoint might use `https://example.com/push`.
-  string push_endpoint = 1;
+  string push_endpoint = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // Endpoint configuration attributes that can be used to control different
-  // aspects of the message delivery.
+  // Optional. Endpoint configuration attributes that can be used to control
+  // different aspects of the message delivery.
   //
   // The only currently supported attribute is `x-goog-version`, which you can
   // use to change the format of the pushed message. This attribute
@@ -942,29 +1055,30 @@ message PushConfig {
   //
   // For example:
   // `attributes { "x-goog-version": "v1" }`
-  map attributes = 2;
+  map attributes = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // An authentication method used by push endpoints to verify the source of
   // push requests. This can be used with push endpoints that are private by
-  // default to allow requests only from the Cloud Pub/Sub system, for example.
+  // default to allow requests only from the Pub/Sub system, for example.
   // This field is optional and should be set only by users interested in
   // authenticated push.
   oneof authentication_method {
-    // If specified, Pub/Sub will generate and attach an OIDC JWT token as an
-    // `Authorization` header in the HTTP request for every pushed message.
-    OidcToken oidc_token = 3;
+    // Optional. If specified, Pub/Sub will generate and attach an OIDC JWT
+    // token as an `Authorization` header in the HTTP request for every pushed
+    // message.
+    OidcToken oidc_token = 3 [(google.api.field_behavior) = OPTIONAL];
   }
 
   // The format of the delivered message to the push endpoint is defined by
   // the chosen wrapper. When unset, `PubsubWrapper` is used.
   oneof wrapper {
-    // When set, the payload to the push endpoint is in the form of the JSON
-    // representation of a PubsubMessage
+    // Optional. When set, the payload to the push endpoint is in the form of
+    // the JSON representation of a PubsubMessage
     // (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
-    PubsubWrapper pubsub_wrapper = 4;
+    PubsubWrapper pubsub_wrapper = 4 [(google.api.field_behavior) = OPTIONAL];
 
-    // When set, the payload to the push endpoint is not wrapped.
-    NoWrapper no_wrapper = 5;
+    // Optional. When set, the payload to the push endpoint is not wrapped.
+    NoWrapper no_wrapper = 5 [(google.api.field_behavior) = OPTIONAL];
   }
 }
 
@@ -991,30 +1105,34 @@ message BigQueryConfig {
 
     // Cannot write to the BigQuery table due to a schema mismatch.
     SCHEMA_MISMATCH = 4;
+
+    // Cannot write to the destination because enforce_in_transit is set to true
+    // and the destination locations are not in the allowed regions.
+    IN_TRANSIT_LOCATION_RESTRICTION = 5;
   }
 
-  // The name of the table to which to write data, of the form
+  // Optional. The name of the table to which to write data, of the form
   // {projectId}.{datasetId}.{tableId}
-  string table = 1;
+  string table = 1 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. When true, use the topic's schema as the columns to write to in
   // BigQuery, if it exists. `use_topic_schema` and `use_table_schema` cannot be
   // enabled at the same time.
   bool use_topic_schema = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // When true, write the subscription name, message_id, publish_time,
+  // Optional. When true, write the subscription name, message_id, publish_time,
   // attributes, and ordering_key to additional columns in the table. The
   // subscription name, message_id, and publish_time fields are put in their own
   // columns while all other message properties (other than data) are written to
   // a JSON object in the attributes column.
-  bool write_metadata = 3;
+  bool write_metadata = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // When true and use_topic_schema is true, any fields that are a part of the
-  // topic schema that are not part of the BigQuery table schema are dropped
-  // when writing to BigQuery. Otherwise, the schemas must be kept in sync and
-  // any messages with extra fields are not written and remain in the
+  // Optional. When true and use_topic_schema is true, any fields that are a
+  // part of the topic schema that are not part of the BigQuery table schema are
+  // dropped when writing to BigQuery. Otherwise, the schemas must be kept in
+  // sync and any messages with extra fields are not written and remain in the
   // subscription's backlog.
-  bool drop_unknown_fields = 4;
+  bool drop_unknown_fields = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. An output-only field that indicates whether or not the
   // subscription can receive messages.
@@ -1036,13 +1154,13 @@ message CloudStorageConfig {
   // Configuration for writing message data in Avro format.
   // Message payloads and metadata will be written to files as an Avro binary.
   message AvroConfig {
-    // When true, write the subscription name, message_id, publish_time,
-    // attributes, and ordering_key as additional fields in the output. The
-    // subscription name, message_id, and publish_time fields are put in their
-    // own fields while all other message properties other than data (for
-    // example, an ordering_key, if present) are added as entries in the
-    // attributes map.
-    bool write_metadata = 1;
+    // Optional. When true, write the subscription name, message_id,
+    // publish_time, attributes, and ordering_key as additional fields in the
+    // output. The subscription name, message_id, and publish_time fields are
+    // put in their own fields while all other message properties other than
+    // data (for example, an ordering_key, if present) are added as entries in
+    // the attributes map.
+    bool write_metadata = 1 [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Possible states for a Cloud Storage subscription.
@@ -1059,6 +1177,10 @@ message CloudStorageConfig {
 
     // Cannot write to the Cloud Storage bucket because it does not exist.
     NOT_FOUND = 3;
+
+    // Cannot write to the destination because enforce_in_transit is set to true
+    // and the destination locations are not in the allowed regions.
+    IN_TRANSIT_LOCATION_RESTRICTION = 4;
   }
 
   // Required. User-provided name for the Cloud Storage bucket.
@@ -1067,33 +1189,36 @@ message CloudStorageConfig {
   // requirements] (https://cloud.google.com/storage/docs/buckets#naming).
   string bucket = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // User-provided prefix for Cloud Storage filename. See the [object naming
-  // requirements](https://cloud.google.com/storage/docs/objects#naming).
-  string filename_prefix = 2;
+  // Optional. User-provided prefix for Cloud Storage filename. See the [object
+  // naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+  string filename_prefix = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // User-provided suffix for Cloud Storage filename. See the [object naming
-  // requirements](https://cloud.google.com/storage/docs/objects#naming). Must
-  // not end in "/".
-  string filename_suffix = 3;
+  // Optional. User-provided suffix for Cloud Storage filename. See the [object
+  // naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+  // Must not end in "/".
+  string filename_suffix = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Defaults to text format.
   oneof output_format {
-    // If set, message data will be written to Cloud Storage in text format.
-    TextConfig text_config = 4;
+    // Optional. If set, message data will be written to Cloud Storage in text
+    // format.
+    TextConfig text_config = 4 [(google.api.field_behavior) = OPTIONAL];
 
-    // If set, message data will be written to Cloud Storage in Avro format.
-    AvroConfig avro_config = 5;
+    // Optional. If set, message data will be written to Cloud Storage in Avro
+    // format.
+    AvroConfig avro_config = 5 [(google.api.field_behavior) = OPTIONAL];
   }
 
-  // The maximum duration that can elapse before a new Cloud Storage file is
-  // created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
-  // the subscription's acknowledgement deadline.
-  google.protobuf.Duration max_duration = 6;
+  // Optional. The maximum duration that can elapse before a new Cloud Storage
+  // file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not
+  // exceed the subscription's acknowledgement deadline.
+  google.protobuf.Duration max_duration = 6
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // The maximum bytes that can be written to a Cloud Storage file before a new
-  // file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded
-  // in cases where messages are larger than the limit.
-  int64 max_bytes = 7;
+  // Optional. The maximum bytes that can be written to a Cloud Storage file
+  // before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may
+  // be exceeded in cases where messages are larger than the limit.
+  int64 max_bytes = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. An output-only field that indicates whether or not the
   // subscription can receive messages.
@@ -1102,14 +1227,14 @@ message CloudStorageConfig {
 
 // A message and its corresponding acknowledgment ID.
 message ReceivedMessage {
-  // This ID can be used to acknowledge the received message.
-  string ack_id = 1;
+  // Optional. This ID can be used to acknowledge the received message.
+  string ack_id = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // The message.
-  PubsubMessage message = 2;
+  // Optional. The message.
+  PubsubMessage message = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The approximate number of times that Cloud Pub/Sub has attempted to deliver
-  // the associated message to a subscriber.
+  // Optional. The approximate number of times that Pub/Sub has attempted to
+  // deliver the associated message to a subscriber.
   //
   // More precisely, this is 1 + (number of NACKs) +
   // (number of ack_deadline exceeds) for this message.
@@ -1124,7 +1249,7 @@ message ReceivedMessage {
   // value of 1. The value is calculated at best effort and is approximate.
   //
   // If a DeadLetterPolicy is not set on the subscription, this will be 0.
-  int32 delivery_attempt = 3;
+  int32 delivery_attempt = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the GetSubscription method.
@@ -1161,24 +1286,25 @@ message ListSubscriptionsRequest {
     }
   ];
 
-  // Maximum number of subscriptions to return.
-  int32 page_size = 2;
+  // Optional. Maximum number of subscriptions to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The value returned by the last `ListSubscriptionsResponse`; indicates that
-  // this is a continuation of a prior `ListSubscriptions` call, and that the
-  // system should return the next page of data.
-  string page_token = 3;
+  // Optional. The value returned by the last `ListSubscriptionsResponse`;
+  // indicates that this is a continuation of a prior `ListSubscriptions` call,
+  // and that the system should return the next page of data.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for the `ListSubscriptions` method.
 message ListSubscriptionsResponse {
-  // The subscriptions that match the request.
-  repeated Subscription subscriptions = 1;
+  // Optional. The subscriptions that match the request.
+  repeated Subscription subscriptions = 1
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // If not empty, indicates that there may be more subscriptions that match
-  // the request; this value should be passed in a new
+  // Optional. If not empty, indicates that there may be more subscriptions that
+  // match the request; this value should be passed in a new
   // `ListSubscriptionsRequest` to get more subscriptions.
-  string next_page_token = 2;
+  string next_page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the DeleteSubscription method.
@@ -1242,12 +1368,13 @@ message PullRequest {
 
 // Response for the `Pull` method.
 message PullResponse {
-  // Received Pub/Sub messages. The list will be empty if there are no more
-  // messages available in the backlog, or if no messages could be returned
+  // Optional. Received Pub/Sub messages. The list will be empty if there are no
+  // more messages available in the backlog, or if no messages could be returned
   // before the request timeout. For JSON, the response can be entirely
   // empty. The Pub/Sub system may return fewer than the `maxMessages` requested
   // even if there are more messages available in the backlog.
-  repeated ReceivedMessage received_messages = 1;
+  repeated ReceivedMessage received_messages = 1
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the ModifyAckDeadline method.
@@ -1271,7 +1398,8 @@ message ModifyAckDeadlineRequest {
   // 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).
+  // The maximum deadline you can specify in a single request is 600 seconds
+  // (10 minutes).
   int32 ack_deadline_seconds = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
@@ -1307,14 +1435,15 @@ message StreamingPullRequest {
     }
   ];
 
-  // List of acknowledgement IDs for acknowledging previously received messages
-  // (received on this stream or a different stream). If an ack ID has expired,
-  // the corresponding message may be redelivered later. Acknowledging a message
-  // more than once will not result in an error. If the acknowledgement ID is
-  // malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
-  repeated string ack_ids = 2;
+  // Optional. List of acknowledgement IDs for acknowledging previously received
+  // messages (received on this stream or a different stream). If an ack ID has
+  // expired, the corresponding message may be redelivered later. Acknowledging
+  // a message more than once will not result in an error. If the
+  // acknowledgement ID is malformed, the stream will be aborted with status
+  // `INVALID_ARGUMENT`.
+  repeated string ack_ids = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The list of new ack deadlines for the IDs listed in
+  // Optional. The list of new ack deadlines for the IDs listed in
   // `modify_deadline_ack_ids`. The size of this list must be the same as the
   // size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
   // with `INVALID_ARGUMENT`. Each element in this list is applied to the
@@ -1325,14 +1454,16 @@ message StreamingPullRequest {
   // the message is immediately made available for another streaming or
   // non-streaming pull request. If the value is < 0 (an error), the stream will
   // be aborted with status `INVALID_ARGUMENT`.
-  repeated int32 modify_deadline_seconds = 3;
+  repeated int32 modify_deadline_seconds = 3
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // List of acknowledgement IDs whose deadline will be modified based on the
-  // corresponding element in `modify_deadline_seconds`. This field can be used
-  // to indicate that more time is needed to process a message by the
+  // Optional. List of acknowledgement IDs whose deadline will be modified based
+  // on the corresponding element in `modify_deadline_seconds`. This field can
+  // be used to indicate that more time is needed to process a message by the
   // subscriber, or to make the message available for redelivery if the
   // processing was interrupted.
-  repeated string modify_deadline_ack_ids = 4;
+  repeated string modify_deadline_ack_ids = 4
+      [(google.api.field_behavior) = OPTIONAL];
 
   // Required. The ack deadline to use for the stream. This must be provided in
   // the first request on the stream, but it can also be updated on subsequent
@@ -1341,16 +1472,16 @@ message StreamingPullRequest {
   int32 stream_ack_deadline_seconds = 5
       [(google.api.field_behavior) = REQUIRED];
 
-  // A unique identifier that is used to distinguish client instances from each
-  // other. Only needs to be provided on the initial request. When a stream
-  // disconnects and reconnects for the same stream, the client_id should be set
-  // to the same value so that state associated with the old stream can be
-  // transferred to the new stream. The same client_id should not be used for
+  // Optional. A unique identifier that is used to distinguish client instances
+  // from each other. Only needs to be provided on the initial request. When a
+  // stream disconnects and reconnects for the same stream, the client_id should
+  // be set to the same value so that state associated with the old stream can
+  // be transferred to the new stream. The same client_id should not be used for
   // different client instances.
-  string client_id = 6;
+  string client_id = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // Flow control settings for the maximum number of outstanding messages. When
-  // there are `max_outstanding_messages` or more currently sent to the
+  // Optional. Flow control settings for the maximum number of outstanding
+  // messages. When there are `max_outstanding_messages` currently sent to the
   // streaming pull client that have not yet been acked or nacked, the server
   // stops sending more messages. The sending of messages resumes once the
   // number of outstanding messages is less than this value. If the value is
@@ -1358,18 +1489,18 @@ message StreamingPullRequest {
   // property can only be set on the initial StreamingPullRequest. If it is set
   // on a subsequent request, the stream will be aborted with status
   // `INVALID_ARGUMENT`.
-  int64 max_outstanding_messages = 7;
-
-  // Flow control settings for the maximum number of outstanding bytes. When
-  // there are `max_outstanding_bytes` or more worth of messages currently sent
-  // to the streaming pull client that have not yet been acked or nacked, the
-  // server will stop sending more messages. The sending of messages resumes
-  // once the number of outstanding bytes is less than this value. If the value
-  // is <= 0, there is no limit to the number of outstanding bytes. This
-  // property can only be set on the initial StreamingPullRequest. If it is set
-  // on a subsequent request, the stream will be aborted with status
+  int64 max_outstanding_messages = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Flow control settings for the maximum number of outstanding
+  // bytes. When there are `max_outstanding_bytes` or more worth of messages
+  // currently sent to the streaming pull client that have not yet been acked or
+  // nacked, the server will stop sending more messages. The sending of messages
+  // resumes once the number of outstanding bytes is less than this value. If
+  // the value is <= 0, there is no limit to the number of outstanding bytes.
+  // This property can only be set on the initial StreamingPullRequest. If it is
+  // set on a subsequent request, the stream will be aborted with status
   // `INVALID_ARGUMENT`.
-  int64 max_outstanding_bytes = 8;
+  int64 max_outstanding_bytes = 8 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for the `StreamingPull` method. This response is used to stream
@@ -1378,56 +1509,69 @@ message StreamingPullResponse {
   // Acknowledgement IDs sent in one or more previous requests to acknowledge a
   // previously received message.
   message AcknowledgeConfirmation {
-    // Successfully processed acknowledgement IDs.
-    repeated string ack_ids = 1;
-
-    // List of acknowledgement IDs that were malformed or whose acknowledgement
-    // deadline has expired.
-    repeated string invalid_ack_ids = 2;
-
-    // List of acknowledgement IDs that were out of order.
-    repeated string unordered_ack_ids = 3;
-
-    // List of acknowledgement IDs that failed processing with temporary issues.
-    repeated string temporary_failed_ack_ids = 4;
+    // Optional. Successfully processed acknowledgement IDs.
+    repeated string ack_ids = 1 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. List of acknowledgement IDs that were malformed or whose
+    // acknowledgement deadline has expired.
+    repeated string invalid_ack_ids = 2
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. List of acknowledgement IDs that were out of order.
+    repeated string unordered_ack_ids = 3
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. List of acknowledgement IDs that failed processing with
+    // temporary issues.
+    repeated string temporary_failed_ack_ids = 4
+        [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Acknowledgement IDs sent in one or more previous requests to modify the
   // deadline for a specific message.
   message ModifyAckDeadlineConfirmation {
-    // Successfully processed acknowledgement IDs.
-    repeated string ack_ids = 1;
-
-    // List of acknowledgement IDs that were malformed or whose acknowledgement
-    // deadline has expired.
-    repeated string invalid_ack_ids = 2;
-
-    // List of acknowledgement IDs that failed processing with temporary issues.
-    repeated string temporary_failed_ack_ids = 3;
+    // Optional. Successfully processed acknowledgement IDs.
+    repeated string ack_ids = 1 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. List of acknowledgement IDs that were malformed or whose
+    // acknowledgement deadline has expired.
+    repeated string invalid_ack_ids = 2
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. List of acknowledgement IDs that failed processing with
+    // temporary issues.
+    repeated string temporary_failed_ack_ids = 3
+        [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Subscription properties sent as part of the response.
   message SubscriptionProperties {
-    // True iff exactly once delivery is enabled for this subscription.
-    bool exactly_once_delivery_enabled = 1;
+    // Optional. True iff exactly once delivery is enabled for this
+    // subscription.
+    bool exactly_once_delivery_enabled = 1
+        [(google.api.field_behavior) = OPTIONAL];
 
-    // True iff message ordering is enabled for this subscription.
-    bool message_ordering_enabled = 2;
+    // Optional. True iff message ordering is enabled for this subscription.
+    bool message_ordering_enabled = 2 [(google.api.field_behavior) = OPTIONAL];
   }
 
-  // Received Pub/Sub messages. This will not be empty.
-  repeated ReceivedMessage received_messages = 1;
+  // Optional. Received Pub/Sub messages. This will not be empty.
+  repeated ReceivedMessage received_messages = 1
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // This field will only be set if `enable_exactly_once_delivery` is set to
-  // `true`.
-  AcknowledgeConfirmation acknowledge_confirmation = 5;
+  // Optional. This field will only be set if `enable_exactly_once_delivery` is
+  // set to `true`.
+  AcknowledgeConfirmation acknowledge_confirmation = 5
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // This field will only be set if `enable_exactly_once_delivery` is set to
-  // `true`.
-  ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3;
+  // Optional. This field will only be set if `enable_exactly_once_delivery` is
+  // set to `true`.
+  ModifyAckDeadlineConfirmation modify_ack_deadline_confirmation = 3
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // Properties associated with this subscription.
-  SubscriptionProperties subscription_properties = 4;
+  // Optional. Properties associated with this subscription.
+  SubscriptionProperties subscription_properties = 4
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the `CreateSnapshot` method.
@@ -1459,9 +1603,9 @@ message CreateSnapshotRequest {
     }
   ];
 
-  // See [Creating and managing
+  // Optional. See [Creating and managing
   // labels](https://cloud.google.com/pubsub/docs/labels).
-  map labels = 3;
+  map labels = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the UpdateSnapshot method.
@@ -1486,15 +1630,17 @@ message Snapshot {
     pattern: "projects/{project}/snapshots/{snapshot}"
   };
 
-  // The name of the snapshot.
-  string name = 1;
+  // Optional. The name of the snapshot.
+  string name = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // The name of the topic from which this snapshot is retaining messages.
+  // Optional. The name of the topic from which this snapshot is retaining
+  // messages.
   string topic = 2 [
+    (google.api.field_behavior) = OPTIONAL,
     (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
   ];
 
-  // The snapshot is guaranteed to exist up until this time.
+  // Optional. The snapshot is guaranteed to exist up until this time.
   // A newly-created snapshot expires no later than 7 days from the time of its
   // creation. Its exact lifetime is determined at creation by the existing
   // backlog in the source subscription. Specifically, the lifetime of the
@@ -1504,11 +1650,12 @@ message Snapshot {
   // will always capture this 3-day-old backlog as long as the snapshot
   // exists -- will expire in 4 days. The service will refuse to create a
   // snapshot that would expire in less than 1 hour after creation.
-  google.protobuf.Timestamp expire_time = 3;
+  google.protobuf.Timestamp expire_time = 3
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // See [Creating and managing labels]
+  // Optional. See [Creating and managing labels]
   // (https://cloud.google.com/pubsub/docs/labels).
-  map labels = 4;
+  map labels = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the GetSnapshot method.
@@ -1532,23 +1679,24 @@ message ListSnapshotsRequest {
     }
   ];
 
-  // Maximum number of snapshots to return.
-  int32 page_size = 2;
+  // Optional. Maximum number of snapshots to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // The value returned by the last `ListSnapshotsResponse`; indicates that this
-  // is a continuation of a prior `ListSnapshots` call, and that the system
-  // should return the next page of data.
-  string page_token = 3;
+  // Optional. The value returned by the last `ListSnapshotsResponse`; indicates
+  // that this is a continuation of a prior `ListSnapshots` call, and that the
+  // system should return the next page of data.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response for the `ListSnapshots` method.
 message ListSnapshotsResponse {
-  // The resulting snapshots.
-  repeated Snapshot snapshots = 1;
+  // Optional. The resulting snapshots.
+  repeated Snapshot snapshots = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // If not empty, indicates that there may be more snapshot that match the
-  // request; this value should be passed in a new `ListSnapshotsRequest`.
-  string next_page_token = 2;
+  // Optional. If not empty, indicates that there may be more snapshot that
+  // match the request; this value should be passed in a new
+  // `ListSnapshotsRequest`.
+  string next_page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the `DeleteSnapshot` method.
@@ -1572,7 +1720,7 @@ message SeekRequest {
   ];
 
   oneof target {
-    // The time to seek to.
+    // Optional. The time to seek to.
     // Messages retained in the subscription that were published before this
     // time are marked as acknowledged, and messages retained in the
     // subscription that were published after this time are marked as
@@ -1583,14 +1731,17 @@ message SeekRequest {
     // window (or to a point before the system's notion of the subscription
     // creation time), only retained messages will be marked as unacknowledged,
     // and already-expunged messages will not be restored.
-    google.protobuf.Timestamp time = 2;
-
-    // The snapshot to seek to. The snapshot's topic must be the same as that of
-    // the provided subscription.
-    // Format is `projects/{project}/snapshots/{snap}`.
-    string snapshot = 3 [(google.api.resource_reference) = {
-      type: "pubsub.googleapis.com/Snapshot"
-    }];
+    google.protobuf.Timestamp time = 2 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The snapshot to seek to. The snapshot's topic must be the same
+    // as that of the provided subscription. Format is
+    // `projects/{project}/snapshots/{snap}`.
+    string snapshot = 3 [
+      (google.api.field_behavior) = OPTIONAL,
+      (google.api.resource_reference) = {
+        type: "pubsub.googleapis.com/Snapshot"
+      }
+    ];
   }
 }
 
diff --git a/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/schema.proto b/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/schema.proto
index 32aa0d75c..bd17cf0f8 100644
--- a/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/schema.proto
+++ b/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/schema.proto
@@ -202,8 +202,8 @@ message CreateSchemaRequest {
   // The ID to use for the schema, which will become the final component of
   // the schema's resource name.
   //
-  // See https://cloud.google.com/pubsub/docs/admin#resource_names for resource
-  // name constraints.
+  // See https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names for
+  // resource name constraints.
   string schema_id = 3;
 }
MethodsMethods
MethodDescriptionMethod Variants
CreateTopic

CreateTopic

Creates the given topic with the given name. See the [resource name rules] (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createTopic(Topic request) + *

  • createTopic(Topic request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createTopic(TopicName name) - *
  • createTopic(String name) + *

  • createTopic(TopicName name) + *

  • createTopic(String name) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createTopicCallable() + *

  • createTopicCallable() *

*
UpdateTopic

Updates an existing topic. Note that certain properties of a topic are not modifiable.

UpdateTopic

Updates an existing topic by updating the fields specified in the update mask. Note that certain properties of a topic are not modifiable.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateTopic(UpdateTopicRequest request) + *

  • updateTopic(UpdateTopicRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateTopic(Topic topic, FieldMask updateMask) + *

  • updateTopic(Topic topic, FieldMask updateMask) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateTopicCallable() + *

  • updateTopicCallable() *

*
Publish

Publish

Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic does not exist.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • publish(PublishRequest request) + *

  • publish(PublishRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • publish(TopicName topic, List<PubsubMessage> messages) - *
  • publish(String topic, List<PubsubMessage> messages) + *

  • publish(TopicName topic, List<PubsubMessage> messages) + *

  • publish(String topic, List<PubsubMessage> messages) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • publishCallable() + *

  • publishCallable() *

*
GetTopic

GetTopic

Gets the configuration of a topic.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getTopic(GetTopicRequest request) + *

  • getTopic(GetTopicRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getTopic(TopicName topic) - *
  • getTopic(String topic) + *

  • getTopic(TopicName topic) + *

  • getTopic(String topic) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getTopicCallable() + *

  • getTopicCallable() *

*
ListTopics

ListTopics

Lists matching topics.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listTopics(ListTopicsRequest request) + *

  • listTopics(ListTopicsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listTopics(ProjectName project) - *
  • listTopics(String project) + *

  • listTopics(ProjectName project) + *

  • listTopics(String project) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listTopicsPagedCallable() - *
  • listTopicsCallable() + *

  • listTopicsPagedCallable() + *

  • listTopicsCallable() *

*
ListTopicSubscriptions

ListTopicSubscriptions

Lists the names of the attached subscriptions on this topic.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listTopicSubscriptions(ListTopicSubscriptionsRequest request) + *

  • listTopicSubscriptions(ListTopicSubscriptionsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listTopicSubscriptions(TopicName topic) - *
  • listTopicSubscriptions(String topic) + *

  • listTopicSubscriptions(TopicName topic) + *

  • listTopicSubscriptions(String topic) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listTopicSubscriptionsPagedCallable() - *
  • listTopicSubscriptionsCallable() + *

  • listTopicSubscriptionsPagedCallable() + *

  • listTopicSubscriptionsCallable() *

*
ListTopicSnapshots

ListTopicSnapshots

Lists the names of the snapshots on this topic. Snapshots are used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listTopicSnapshots(ListTopicSnapshotsRequest request) + *

  • listTopicSnapshots(ListTopicSnapshotsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listTopicSnapshots(TopicName topic) - *
  • listTopicSnapshots(String topic) + *

  • listTopicSnapshots(TopicName topic) + *

  • listTopicSnapshots(String topic) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listTopicSnapshotsPagedCallable() - *
  • listTopicSnapshotsCallable() + *

  • listTopicSnapshotsPagedCallable() + *

  • listTopicSnapshotsCallable() *

*
DeleteTopic

DeleteTopic

Deletes the topic with the given name. Returns `NOT_FOUND` if the topic does not exist. After a topic is deleted, a new topic may be created with the same name; this is an entirely new topic with none of the old configuration or subscriptions. Existing subscriptions to this topic are not deleted, but their `topic` field is set to `_deleted-topic_`.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteTopic(DeleteTopicRequest request) + *

  • deleteTopic(DeleteTopicRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteTopic(TopicName topic) - *
  • deleteTopic(String topic) + *

  • deleteTopic(TopicName topic) + *

  • deleteTopic(String topic) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • deleteTopicCallable() + *

  • deleteTopicCallable() *

*
DetachSubscription

DetachSubscription

Detaches a subscription from this topic. All messages retained in the subscription are dropped. Subsequent `Pull` and `StreamingPull` requests will return FAILED_PRECONDITION. If the subscription is a push subscription, pushes to the endpoint will stop.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • detachSubscription(DetachSubscriptionRequest request) + *

  • detachSubscription(DetachSubscriptionRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • detachSubscriptionCallable() + *

  • detachSubscriptionCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *

  • setIamPolicy(SetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setIamPolicyCallable() + *

  • setIamPolicyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *

  • getIamPolicy(GetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getIamPolicyCallable() + *

  • getIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

 *

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *

  • testIamPermissions(TestIamPermissionsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • testIamPermissionsCallable() + *

  • testIamPermissionsCallable() *

*