diff --git a/README.md b/README.md index 8385dc98e1..6cbfc72ed5 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ If you are using Maven without BOM, add this to your dependencies: If you are using Gradle 5.x or later, add this to your dependencies: ```Groovy -implementation platform('com.google.cloud:libraries-bom:26.1.0') +implementation platform('com.google.cloud:libraries-bom:26.1.1') implementation 'com.google.cloud:google-cloud-bigquerystorage' ``` diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadClient.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadClient.java index b36e10c54f..5455e617bc 100644 --- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadClient.java +++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadClient.java @@ -35,8 +35,11 @@ * calls that map to API methods. Sample code to get started: * *
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
  *   ProjectName parent = ProjectName.of("[PROJECT]");
  *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -76,8 +79,11 @@
  * 

To customize credentials: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryReadSettings baseBigQueryReadSettings =
  *     BaseBigQueryReadSettings.newBuilder()
  *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -89,8 +95,11 @@
  * 

To customize the endpoint: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryReadSettings baseBigQueryReadSettings =
  *     BaseBigQueryReadSettings.newBuilder().setEndpoint(myEndpoint).build();
  * BaseBigQueryReadClient baseBigQueryReadClient =
@@ -171,8 +180,11 @@ public BigQueryReadStub getStub() {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   ProjectName parent = ProjectName.of("[PROJECT]");
    *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -227,8 +239,11 @@ public final ReadSession createReadSession(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   String parent = ProjectName.of("[PROJECT]").toString();
    *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -283,8 +298,11 @@ public final ReadSession createReadSession(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   CreateReadSessionRequest request =
    *       CreateReadSessionRequest.newBuilder()
@@ -326,8 +344,11 @@ public final ReadSession createReadSession(CreateReadSessionRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   CreateReadSessionRequest request =
    *       CreateReadSessionRequest.newBuilder()
@@ -359,8 +380,11 @@ public final UnaryCallable createReadSess
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   ReadRowsRequest request =
    *       ReadRowsRequest.newBuilder()
@@ -396,8 +420,11 @@ public final ServerStreamingCallable readRows
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   SplitReadStreamRequest request =
    *       SplitReadStreamRequest.newBuilder()
@@ -432,8 +459,11 @@ public final SplitReadStreamResponse splitReadStream(SplitReadStreamRequest requ
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   SplitReadStreamRequest request =
    *       SplitReadStreamRequest.newBuilder()
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadSettings.java
index 356170363d..1e6cb3fd29 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BaseBigQueryReadSettings.java
@@ -51,8 +51,11 @@
  * 

For example, to set the total timeout of createReadSession to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryReadSettings.Builder baseBigQueryReadSettingsBuilder =
  *     BaseBigQueryReadSettings.newBuilder();
  * baseBigQueryReadSettingsBuilder
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClient.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClient.java
index 5a1d7147dd..89be9c8065 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClient.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClient.java
@@ -38,8 +38,11 @@
  * calls that map to API methods. Sample code to get started:
  *
  * 
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
  *   TableName parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]");
  *   WriteStream writeStream = WriteStream.newBuilder().build();
@@ -76,8 +79,11 @@
  * 

To customize credentials: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteSettings bigQueryWriteSettings =
  *     BigQueryWriteSettings.newBuilder()
  *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -88,8 +94,11 @@
  * 

To customize the endpoint: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteSettings bigQueryWriteSettings =
  *     BigQueryWriteSettings.newBuilder().setEndpoint(myEndpoint).build();
  * BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create(bigQueryWriteSettings);
@@ -157,8 +166,11 @@ public BigQueryWriteStub getStub() {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   TableName parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]");
    *   WriteStream writeStream = WriteStream.newBuilder().build();
@@ -190,8 +202,11 @@ public final WriteStream createWriteStream(TableName parent, WriteStream writeSt
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]").toString();
    *   WriteStream writeStream = WriteStream.newBuilder().build();
@@ -220,8 +235,11 @@ public final WriteStream createWriteStream(String parent, WriteStream writeStrea
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   CreateWriteStreamRequest request =
    *       CreateWriteStreamRequest.newBuilder()
@@ -249,8 +267,11 @@ public final WriteStream createWriteStream(CreateWriteStreamRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   CreateWriteStreamRequest request =
    *       CreateWriteStreamRequest.newBuilder()
@@ -313,8 +334,11 @@ public final UnaryCallable createWriteStr
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   BidiStream bidiStream =
    *       bigQueryWriteClient.appendRowsCallable().call();
@@ -343,8 +367,11 @@ public final BidiStreamingCallable append
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   WriteStreamName name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]");
    *   WriteStream response = bigQueryWriteClient.getWriteStream(name);
@@ -368,8 +395,11 @@ public final WriteStream getWriteStream(WriteStreamName name) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString();
    *   WriteStream response = bigQueryWriteClient.getWriteStream(name);
@@ -392,13 +422,17 @@ public final WriteStream getWriteStream(String name) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   GetWriteStreamRequest request =
    *       GetWriteStreamRequest.newBuilder()
    *           .setName(
    *               WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString())
+   *           .setView(WriteStreamView.forNumber(0))
    *           .build();
    *   WriteStream response = bigQueryWriteClient.getWriteStream(request);
    * }
@@ -418,13 +452,17 @@ public final WriteStream getWriteStream(GetWriteStreamRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   GetWriteStreamRequest request =
    *       GetWriteStreamRequest.newBuilder()
    *           .setName(
    *               WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString())
+   *           .setView(WriteStreamView.forNumber(0))
    *           .build();
    *   ApiFuture future =
    *       bigQueryWriteClient.getWriteStreamCallable().futureCall(request);
@@ -445,8 +483,11 @@ public final UnaryCallable getWriteStreamCal
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   WriteStreamName name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]");
    *   FinalizeWriteStreamResponse response = bigQueryWriteClient.finalizeWriteStream(name);
@@ -473,8 +514,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(WriteStreamName nam
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString();
    *   FinalizeWriteStreamResponse response = bigQueryWriteClient.finalizeWriteStream(name);
@@ -499,8 +543,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(String name) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FinalizeWriteStreamRequest request =
    *       FinalizeWriteStreamRequest.newBuilder()
@@ -526,8 +573,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FinalizeWriteStreamRequest request =
    *       FinalizeWriteStreamRequest.newBuilder()
@@ -556,8 +606,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   TableName parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]");
    *   BatchCommitWriteStreamsResponse response =
@@ -587,8 +640,11 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(TableName p
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]").toString();
    *   BatchCommitWriteStreamsResponse response =
@@ -616,8 +672,11 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(String pare
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   BatchCommitWriteStreamsRequest request =
    *       BatchCommitWriteStreamsRequest.newBuilder()
@@ -647,8 +706,11 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   BatchCommitWriteStreamsRequest request =
    *       BatchCommitWriteStreamsRequest.newBuilder()
@@ -680,8 +742,11 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   WriteStreamName writeStream =
    *       WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]");
@@ -713,8 +778,11 @@ public final FlushRowsResponse flushRows(WriteStreamName writeStream) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String writeStream =
    *       WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString();
@@ -743,8 +811,11 @@ public final FlushRowsResponse flushRows(String writeStream) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FlushRowsRequest request =
    *       FlushRowsRequest.newBuilder()
@@ -776,8 +847,11 @@ public final FlushRowsResponse flushRows(FlushRowsRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FlushRowsRequest request =
    *       FlushRowsRequest.newBuilder()
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteSettings.java
index 1ca1332aad..867c5b91d2 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteSettings.java
@@ -51,16 +51,16 @@
  * 

For example, to set the total timeout of createWriteStream to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteSettings.Builder bigQueryWriteSettingsBuilder = BigQueryWriteSettings.newBuilder();
  * bigQueryWriteSettingsBuilder
  *     .createWriteStreamSettings()
  *     .setRetrySettings(
- *         bigQueryWriteSettingsBuilder
- *             .createWriteStreamSettings()
- *             .getRetrySettings()
- *             .toBuilder()
+ *         bigQueryWriteSettingsBuilder.createWriteStreamSettings().getRetrySettings().toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * BigQueryWriteSettings bigQueryWriteSettings = bigQueryWriteSettingsBuilder.build();
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/package-info.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/package-info.java
index 816b781e04..0f3d464e01 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/package-info.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/package-info.java
@@ -26,8 +26,11 @@
  * 

Sample for BaseBigQueryReadClient: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
  *   ProjectName parent = ProjectName.of("[PROJECT]");
  *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -49,8 +52,11 @@
  * 

Sample for BigQueryWriteClient: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
  *   TableName parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]");
  *   WriteStream writeStream = WriteStream.newBuilder().build();
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryReadStubSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryReadStubSettings.java
index 5e1c372454..d000dcda30 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryReadStubSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryReadStubSettings.java
@@ -66,8 +66,11 @@
  * 

For example, to set the total timeout of createReadSession to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryReadStubSettings.Builder baseBigQueryReadSettingsBuilder =
  *     BigQueryReadStubSettings.newBuilder();
  * baseBigQueryReadSettingsBuilder
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryWriteStubSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryWriteStubSettings.java
index e026fd68cd..50e4824e2f 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryWriteStubSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1/stub/BigQueryWriteStubSettings.java
@@ -71,17 +71,17 @@
  * 

For example, to set the total timeout of createWriteStream to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteStubSettings.Builder bigQueryWriteSettingsBuilder =
  *     BigQueryWriteStubSettings.newBuilder();
  * bigQueryWriteSettingsBuilder
  *     .createWriteStreamSettings()
  *     .setRetrySettings(
- *         bigQueryWriteSettingsBuilder
- *             .createWriteStreamSettings()
- *             .getRetrySettings()
- *             .toBuilder()
+ *         bigQueryWriteSettingsBuilder.createWriteStreamSettings().getRetrySettings().toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * BigQueryWriteStubSettings bigQueryWriteSettings = bigQueryWriteSettingsBuilder.build();
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageClient.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageClient.java
index 93d5aa1766..de2b208041 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageClient.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageClient.java
@@ -37,8 +37,11 @@
  * calls that map to API methods. Sample code to get started:
  *
  * 
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
  *   TableReferenceProto.TableReference tableReference =
  *       TableReferenceProto.TableReference.newBuilder().build();
@@ -79,8 +82,11 @@
  * 

To customize credentials: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryStorageSettings baseBigQueryStorageSettings =
  *     BaseBigQueryStorageSettings.newBuilder()
  *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -92,8 +98,11 @@
  * 

To customize the endpoint: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryStorageSettings baseBigQueryStorageSettings =
  *     BaseBigQueryStorageSettings.newBuilder().setEndpoint(myEndpoint).build();
  * BaseBigQueryStorageClient baseBigQueryStorageClient =
@@ -169,8 +178,11 @@ public BigQueryStorageStub getStub() {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   TableReferenceProto.TableReference tableReference =
    *       TableReferenceProto.TableReference.newBuilder().build();
@@ -218,8 +230,11 @@ public final Storage.ReadSession createReadSession(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   TableReferenceProto.TableReference tableReference =
    *       TableReferenceProto.TableReference.newBuilder().build();
@@ -267,8 +282,11 @@ public final Storage.ReadSession createReadSession(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.CreateReadSessionRequest request =
    *       Storage.CreateReadSessionRequest.newBuilder()
@@ -307,8 +325,11 @@ public final Storage.ReadSession createReadSession(Storage.CreateReadSessionRequ
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.CreateReadSessionRequest request =
    *       Storage.CreateReadSessionRequest.newBuilder()
@@ -346,8 +367,11 @@ public final Storage.ReadSession createReadSession(Storage.CreateReadSessionRequ
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.ReadRowsRequest request =
    *       Storage.ReadRowsRequest.newBuilder()
@@ -374,8 +398,11 @@ public final Storage.ReadSession createReadSession(Storage.CreateReadSessionRequ
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.ReadSession session = Storage.ReadSession.newBuilder().build();
    *   int requestedStreams = 1017221410;
@@ -408,8 +435,11 @@ public final Storage.BatchCreateReadSessionStreamsResponse batchCreateReadSessio
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.BatchCreateReadSessionStreamsRequest request =
    *       Storage.BatchCreateReadSessionStreamsRequest.newBuilder()
@@ -437,8 +467,11 @@ public final Storage.BatchCreateReadSessionStreamsResponse batchCreateReadSessio
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.BatchCreateReadSessionStreamsRequest request =
    *       Storage.BatchCreateReadSessionStreamsRequest.newBuilder()
@@ -476,8 +509,11 @@ public final Storage.BatchCreateReadSessionStreamsResponse batchCreateReadSessio
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.Stream stream = Storage.Stream.newBuilder().build();
    *   baseBigQueryStorageClient.finalizeStream(stream);
@@ -510,8 +546,11 @@ public final void finalizeStream(Storage.Stream stream) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.FinalizeStreamRequest request =
    *       Storage.FinalizeStreamRequest.newBuilder()
@@ -545,8 +584,11 @@ public final void finalizeStream(Storage.FinalizeStreamRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.FinalizeStreamRequest request =
    *       Storage.FinalizeStreamRequest.newBuilder()
@@ -580,8 +622,11 @@ public final UnaryCallable finalizeStreamC
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.Stream originalStream = Storage.Stream.newBuilder().build();
    *   Storage.SplitReadStreamResponse response =
@@ -615,8 +660,11 @@ public final Storage.SplitReadStreamResponse splitReadStream(Storage.Stream orig
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.SplitReadStreamRequest request =
    *       Storage.SplitReadStreamRequest.newBuilder()
@@ -652,8 +700,11 @@ public final Storage.SplitReadStreamResponse splitReadStream(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
    *   Storage.SplitReadStreamRequest request =
    *       Storage.SplitReadStreamRequest.newBuilder()
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageSettings.java
index 3ac32aa559..4df22dfce9 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/BaseBigQueryStorageSettings.java
@@ -52,8 +52,11 @@
  * 

For example, to set the total timeout of createReadSession to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryStorageSettings.Builder baseBigQueryStorageSettingsBuilder =
  *     BaseBigQueryStorageSettings.newBuilder();
  * baseBigQueryStorageSettingsBuilder
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/package-info.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/package-info.java
index 4653decccb..8a620b33aa 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/package-info.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/package-info.java
@@ -26,8 +26,11 @@
  * 

Sample for BaseBigQueryStorageClient: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BaseBigQueryStorageClient baseBigQueryStorageClient = BaseBigQueryStorageClient.create()) {
  *   TableReferenceProto.TableReference tableReference =
  *       TableReferenceProto.TableReference.newBuilder().build();
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/stub/BigQueryStorageStubSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/stub/BigQueryStorageStubSettings.java
index 9eebd22b94..641363fc68 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/stub/BigQueryStorageStubSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta1/stub/BigQueryStorageStubSettings.java
@@ -62,8 +62,11 @@
  * 

For example, to set the total timeout of createReadSession to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryStorageStubSettings.Builder baseBigQueryStorageSettingsBuilder =
  *     BigQueryStorageStubSettings.newBuilder();
  * baseBigQueryStorageSettingsBuilder
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadClient.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadClient.java
index 9c697775c4..28f9b98d13 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadClient.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadClient.java
@@ -39,8 +39,11 @@
  * calls that map to API methods. Sample code to get started:
  *
  * 
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
  *   ProjectName parent = ProjectName.of("[PROJECT]");
  *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -80,8 +83,11 @@
  * 

To customize credentials: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryReadSettings baseBigQueryReadSettings =
  *     BaseBigQueryReadSettings.newBuilder()
  *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -93,8 +99,11 @@
  * 

To customize the endpoint: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryReadSettings baseBigQueryReadSettings =
  *     BaseBigQueryReadSettings.newBuilder().setEndpoint(myEndpoint).build();
  * BaseBigQueryReadClient baseBigQueryReadClient =
@@ -176,8 +185,11 @@ public BigQueryReadStub getStub() {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   ProjectName parent = ProjectName.of("[PROJECT]");
    *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -231,8 +243,11 @@ public final ReadSession createReadSession(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   String parent = ProjectName.of("[PROJECT]").toString();
    *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -286,8 +301,11 @@ public final ReadSession createReadSession(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   CreateReadSessionRequest request =
    *       CreateReadSessionRequest.newBuilder()
@@ -328,8 +346,11 @@ public final ReadSession createReadSession(CreateReadSessionRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   CreateReadSessionRequest request =
    *       CreateReadSessionRequest.newBuilder()
@@ -360,8 +381,11 @@ public final UnaryCallable createReadSess
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   ReadRowsRequest request =
    *       ReadRowsRequest.newBuilder()
@@ -397,8 +421,11 @@ public final ServerStreamingCallable readRows
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   SplitReadStreamRequest request =
    *       SplitReadStreamRequest.newBuilder()
@@ -433,8 +460,11 @@ public final SplitReadStreamResponse splitReadStream(SplitReadStreamRequest requ
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
    *   SplitReadStreamRequest request =
    *       SplitReadStreamRequest.newBuilder()
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadSettings.java
index b8b312103d..8d7217f7e6 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BaseBigQueryReadSettings.java
@@ -51,8 +51,11 @@
  * 

For example, to set the total timeout of createReadSession to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BaseBigQueryReadSettings.Builder baseBigQueryReadSettingsBuilder =
  *     BaseBigQueryReadSettings.newBuilder();
  * baseBigQueryReadSettingsBuilder
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteClient.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteClient.java
index 329d2e9aca..7b8af278a1 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteClient.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteClient.java
@@ -36,8 +36,11 @@
  * calls that map to API methods. Sample code to get started:
  *
  * 
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
  *   TableName parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]");
  *   WriteStream writeStream = WriteStream.newBuilder().build();
@@ -74,8 +77,11 @@
  * 

To customize credentials: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteSettings bigQueryWriteSettings =
  *     BigQueryWriteSettings.newBuilder()
  *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -86,8 +92,11 @@
  * 

To customize the endpoint: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteSettings bigQueryWriteSettings =
  *     BigQueryWriteSettings.newBuilder().setEndpoint(myEndpoint).build();
  * BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create(bigQueryWriteSettings);
@@ -157,8 +166,11 @@ public BigQueryWriteStub getStub() {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   TableName parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]");
    *   WriteStream writeStream = WriteStream.newBuilder().build();
@@ -191,8 +203,11 @@ public final WriteStream createWriteStream(TableName parent, WriteStream writeSt
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]").toString();
    *   WriteStream writeStream = WriteStream.newBuilder().build();
@@ -222,8 +237,11 @@ public final WriteStream createWriteStream(String parent, WriteStream writeStrea
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   CreateWriteStreamRequest request =
    *       CreateWriteStreamRequest.newBuilder()
@@ -252,8 +270,11 @@ public final WriteStream createWriteStream(CreateWriteStreamRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   CreateWriteStreamRequest request =
    *       CreateWriteStreamRequest.newBuilder()
@@ -293,8 +314,11 @@ public final UnaryCallable createWriteStr
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   BidiStream bidiStream =
    *       bigQueryWriteClient.appendRowsCallable().call();
@@ -323,8 +347,11 @@ public final BidiStreamingCallable append
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   WriteStreamName name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]");
    *   WriteStream response = bigQueryWriteClient.getWriteStream(name);
@@ -348,8 +375,11 @@ public final WriteStream getWriteStream(WriteStreamName name) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString();
    *   WriteStream response = bigQueryWriteClient.getWriteStream(name);
@@ -372,8 +402,11 @@ public final WriteStream getWriteStream(String name) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   GetWriteStreamRequest request =
    *       GetWriteStreamRequest.newBuilder()
@@ -398,8 +431,11 @@ public final WriteStream getWriteStream(GetWriteStreamRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   GetWriteStreamRequest request =
    *       GetWriteStreamRequest.newBuilder()
@@ -425,8 +461,11 @@ public final UnaryCallable getWriteStreamCal
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   WriteStreamName name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]");
    *   FinalizeWriteStreamResponse response = bigQueryWriteClient.finalizeWriteStream(name);
@@ -453,8 +492,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(WriteStreamName nam
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String name = WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString();
    *   FinalizeWriteStreamResponse response = bigQueryWriteClient.finalizeWriteStream(name);
@@ -479,8 +521,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(String name) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FinalizeWriteStreamRequest request =
    *       FinalizeWriteStreamRequest.newBuilder()
@@ -506,8 +551,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FinalizeWriteStreamRequest request =
    *       FinalizeWriteStreamRequest.newBuilder()
@@ -535,8 +583,11 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String parent = "parent-995424086";
    *   BatchCommitWriteStreamsResponse response =
@@ -563,8 +614,11 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(String pare
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   BatchCommitWriteStreamsRequest request =
    *       BatchCommitWriteStreamsRequest.newBuilder()
@@ -593,8 +647,11 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   BatchCommitWriteStreamsRequest request =
    *       BatchCommitWriteStreamsRequest.newBuilder()
@@ -623,8 +680,11 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   WriteStreamName writeStream =
    *       WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]");
@@ -653,8 +713,11 @@ public final FlushRowsResponse flushRows(WriteStreamName writeStream) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   String writeStream =
    *       WriteStreamName.of("[PROJECT]", "[DATASET]", "[TABLE]", "[STREAM]").toString();
@@ -680,8 +743,11 @@ public final FlushRowsResponse flushRows(String writeStream) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FlushRowsRequest request =
    *       FlushRowsRequest.newBuilder()
@@ -710,8 +776,11 @@ public final FlushRowsResponse flushRows(FlushRowsRequest request) {
    * 

Sample code: * *

{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
    *   FlushRowsRequest request =
    *       FlushRowsRequest.newBuilder()
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteSettings.java
index dc5f17c0da..9b26e05535 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteSettings.java
@@ -51,16 +51,16 @@
  * 

For example, to set the total timeout of createWriteStream to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteSettings.Builder bigQueryWriteSettingsBuilder = BigQueryWriteSettings.newBuilder();
  * bigQueryWriteSettingsBuilder
  *     .createWriteStreamSettings()
  *     .setRetrySettings(
- *         bigQueryWriteSettingsBuilder
- *             .createWriteStreamSettings()
- *             .getRetrySettings()
- *             .toBuilder()
+ *         bigQueryWriteSettingsBuilder.createWriteStreamSettings().getRetrySettings().toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * BigQueryWriteSettings bigQueryWriteSettings = bigQueryWriteSettingsBuilder.build();
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/package-info.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/package-info.java
index 3308995a62..850dfdda20 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/package-info.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/package-info.java
@@ -29,8 +29,11 @@
  * 

Sample for BaseBigQueryReadClient: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BaseBigQueryReadClient baseBigQueryReadClient = BaseBigQueryReadClient.create()) {
  *   ProjectName parent = ProjectName.of("[PROJECT]");
  *   ReadSession readSession = ReadSession.newBuilder().build();
@@ -49,8 +52,11 @@
  * 

Sample for BigQueryWriteClient: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * try (BigQueryWriteClient bigQueryWriteClient = BigQueryWriteClient.create()) {
  *   TableName parent = TableName.of("[PROJECT]", "[DATASET]", "[TABLE]");
  *   WriteStream writeStream = WriteStream.newBuilder().build();
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryReadStubSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryReadStubSettings.java
index 9258fecf7c..fc45582e5b 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryReadStubSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryReadStubSettings.java
@@ -66,8 +66,11 @@
  * 

For example, to set the total timeout of createReadSession to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryReadStubSettings.Builder baseBigQueryReadSettingsBuilder =
  *     BigQueryReadStubSettings.newBuilder();
  * baseBigQueryReadSettingsBuilder
diff --git a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryWriteStubSettings.java b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryWriteStubSettings.java
index a064c12990..28e5ca43a1 100644
--- a/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryWriteStubSettings.java
+++ b/google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/stub/BigQueryWriteStubSettings.java
@@ -71,17 +71,17 @@
  * 

For example, to set the total timeout of createWriteStream to 30 seconds: * *

{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
  * BigQueryWriteStubSettings.Builder bigQueryWriteSettingsBuilder =
  *     BigQueryWriteStubSettings.newBuilder();
  * bigQueryWriteSettingsBuilder
  *     .createWriteStreamSettings()
  *     .setRetrySettings(
- *         bigQueryWriteSettingsBuilder
- *             .createWriteStreamSettings()
- *             .getRetrySettings()
- *             .toBuilder()
+ *         bigQueryWriteSettingsBuilder.createWriteStreamSettings().getRetrySettings().toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * BigQueryWriteStubSettings bigQueryWriteSettings = bigQueryWriteSettingsBuilder.build();
diff --git a/google-cloud-bigquerystorage/src/test/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClientTest.java b/google-cloud-bigquerystorage/src/test/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClientTest.java
index dbe48c243d..980ca568ea 100644
--- a/google-cloud-bigquerystorage/src/test/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClientTest.java
+++ b/google-cloud-bigquerystorage/src/test/java/com/google/cloud/bigquery/storage/v1/BigQueryWriteClientTest.java
@@ -91,6 +91,7 @@ public void createWriteStreamTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setCommitTime(Timestamp.newBuilder().build())
             .setTableSchema(TableSchema.newBuilder().build())
+            .setLocation("location1901043637")
             .build();
     mockBigQueryWrite.addResponse(expectedResponse);
 
@@ -135,6 +136,7 @@ public void createWriteStreamTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setCommitTime(Timestamp.newBuilder().build())
             .setTableSchema(TableSchema.newBuilder().build())
+            .setLocation("location1901043637")
             .build();
     mockBigQueryWrite.addResponse(expectedResponse);
 
@@ -242,6 +244,7 @@ public void getWriteStreamTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setCommitTime(Timestamp.newBuilder().build())
             .setTableSchema(TableSchema.newBuilder().build())
+            .setLocation("location1901043637")
             .build();
     mockBigQueryWrite.addResponse(expectedResponse);
 
@@ -283,6 +286,7 @@ public void getWriteStreamTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setCommitTime(Timestamp.newBuilder().build())
             .setTableSchema(TableSchema.newBuilder().build())
+            .setLocation("location1901043637")
             .build();
     mockBigQueryWrite.addResponse(expectedResponse);
 
diff --git a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequest.java b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequest.java
index fafc9d8d48..f004d52fe0 100644
--- a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequest.java
+++ b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequest.java
@@ -39,6 +39,7 @@ private GetWriteStreamRequest(com.google.protobuf.GeneratedMessageV3.Builder
 
   private GetWriteStreamRequest() {
     name_ = "";
+    view_ = 0;
   }
 
   @java.lang.Override
@@ -77,6 +78,13 @@ private GetWriteStreamRequest(
               name_ = s;
               break;
             }
+          case 24:
+            {
+              int rawValue = input.readEnum();
+
+              view_ = rawValue;
+              break;
+            }
           default:
             {
               if (!parseUnknownField(input, unknownFields, extensionRegistry, tag)) {
@@ -168,6 +176,46 @@ public com.google.protobuf.ByteString getNameBytes() {
     }
   }
 
+  public static final int VIEW_FIELD_NUMBER = 3;
+  private int view_;
+  /**
+   *
+   *
+   * 
+   * Indicates whether to get full or partial view of the WriteStream. If
+   * not set, view returned will be basic.
+   * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @return The enum numeric value on the wire for view. + */ + @java.lang.Override + public int getViewValue() { + return view_; + } + /** + * + * + *
+   * Indicates whether to get full or partial view of the WriteStream. If
+   * not set, view returned will be basic.
+   * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @return The view. + */ + @java.lang.Override + public com.google.cloud.bigquery.storage.v1.WriteStreamView getView() { + @SuppressWarnings("deprecation") + com.google.cloud.bigquery.storage.v1.WriteStreamView result = + com.google.cloud.bigquery.storage.v1.WriteStreamView.valueOf(view_); + return result == null + ? com.google.cloud.bigquery.storage.v1.WriteStreamView.UNRECOGNIZED + : result; + } + private byte memoizedIsInitialized = -1; @java.lang.Override @@ -185,6 +233,11 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(name_)) { com.google.protobuf.GeneratedMessageV3.writeString(output, 1, name_); } + if (view_ + != com.google.cloud.bigquery.storage.v1.WriteStreamView.WRITE_STREAM_VIEW_UNSPECIFIED + .getNumber()) { + output.writeEnum(3, view_); + } unknownFields.writeTo(output); } @@ -197,6 +250,11 @@ public int getSerializedSize() { if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(name_)) { size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, name_); } + if (view_ + != com.google.cloud.bigquery.storage.v1.WriteStreamView.WRITE_STREAM_VIEW_UNSPECIFIED + .getNumber()) { + size += com.google.protobuf.CodedOutputStream.computeEnumSize(3, view_); + } size += unknownFields.getSerializedSize(); memoizedSize = size; return size; @@ -214,6 +272,7 @@ public boolean equals(final java.lang.Object obj) { (com.google.cloud.bigquery.storage.v1.GetWriteStreamRequest) obj; if (!getName().equals(other.getName())) return false; + if (view_ != other.view_) return false; if (!unknownFields.equals(other.unknownFields)) return false; return true; } @@ -227,6 +286,8 @@ public int hashCode() { hash = (19 * hash) + getDescriptor().hashCode(); hash = (37 * hash) + NAME_FIELD_NUMBER; hash = (53 * hash) + getName().hashCode(); + hash = (37 * hash) + VIEW_FIELD_NUMBER; + hash = (53 * hash) + view_; hash = (29 * hash) + unknownFields.hashCode(); memoizedHashCode = hash; return hash; @@ -375,6 +436,8 @@ public Builder clear() { super.clear(); name_ = ""; + view_ = 0; + return this; } @@ -403,6 +466,7 @@ public com.google.cloud.bigquery.storage.v1.GetWriteStreamRequest buildPartial() com.google.cloud.bigquery.storage.v1.GetWriteStreamRequest result = new com.google.cloud.bigquery.storage.v1.GetWriteStreamRequest(this); result.name_ = name_; + result.view_ = view_; onBuilt(); return result; } @@ -457,6 +521,9 @@ public Builder mergeFrom(com.google.cloud.bigquery.storage.v1.GetWriteStreamRequ name_ = other.name_; onChanged(); } + if (other.view_ != 0) { + setViewValue(other.getViewValue()); + } this.mergeUnknownFields(other.unknownFields); onChanged(); return this; @@ -608,6 +675,104 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) { return this; } + private int view_ = 0; + /** + * + * + *
+     * Indicates whether to get full or partial view of the WriteStream. If
+     * not set, view returned will be basic.
+     * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @return The enum numeric value on the wire for view. + */ + @java.lang.Override + public int getViewValue() { + return view_; + } + /** + * + * + *
+     * Indicates whether to get full or partial view of the WriteStream. If
+     * not set, view returned will be basic.
+     * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @param value The enum numeric value on the wire for view to set. + * @return This builder for chaining. + */ + public Builder setViewValue(int value) { + + view_ = value; + onChanged(); + return this; + } + /** + * + * + *
+     * Indicates whether to get full or partial view of the WriteStream. If
+     * not set, view returned will be basic.
+     * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @return The view. + */ + @java.lang.Override + public com.google.cloud.bigquery.storage.v1.WriteStreamView getView() { + @SuppressWarnings("deprecation") + com.google.cloud.bigquery.storage.v1.WriteStreamView result = + com.google.cloud.bigquery.storage.v1.WriteStreamView.valueOf(view_); + return result == null + ? com.google.cloud.bigquery.storage.v1.WriteStreamView.UNRECOGNIZED + : result; + } + /** + * + * + *
+     * Indicates whether to get full or partial view of the WriteStream. If
+     * not set, view returned will be basic.
+     * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @param value The view to set. + * @return This builder for chaining. + */ + public Builder setView(com.google.cloud.bigquery.storage.v1.WriteStreamView value) { + if (value == null) { + throw new NullPointerException(); + } + + view_ = value.getNumber(); + onChanged(); + return this; + } + /** + * + * + *
+     * Indicates whether to get full or partial view of the WriteStream. If
+     * not set, view returned will be basic.
+     * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @return This builder for chaining. + */ + public Builder clearView() { + + view_ = 0; + 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-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequestOrBuilder.java b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequestOrBuilder.java index fbe97e3a0e..816792d231 100644 --- a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequestOrBuilder.java +++ b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/GetWriteStreamRequestOrBuilder.java @@ -53,4 +53,31 @@ public interface GetWriteStreamRequestOrBuilder * @return The bytes for name. */ com.google.protobuf.ByteString getNameBytes(); + + /** + * + * + *
+   * Indicates whether to get full or partial view of the WriteStream. If
+   * not set, view returned will be basic.
+   * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @return The enum numeric value on the wire for view. + */ + int getViewValue(); + /** + * + * + *
+   * Indicates whether to get full or partial view of the WriteStream. If
+   * not set, view returned will be basic.
+   * 
+ * + * .google.cloud.bigquery.storage.v1.WriteStreamView view = 3; + * + * @return The view. + */ + com.google.cloud.bigquery.storage.v1.WriteStreamView getView(); } diff --git a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StorageProto.java b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StorageProto.java index 41a86d47f0..09b7f4b778 100644 --- a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StorageProto.java +++ b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StorageProto.java @@ -193,103 +193,104 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "igquery.storage.v1.RowError\022\024\n\014write_str" + "eam\030\005 \001(\t\032;\n\014AppendResult\022+\n\006offset\030\001 \001(" + "\0132\033.google.protobuf.Int64ValueB\n\n\010respon" - + "se\"Y\n\025GetWriteStreamRequest\022@\n\004name\030\001 \001(" - + "\tB2\340A\002\372A,\n*bigquerystorage.googleapis.co" - + "m/WriteStream\"s\n\036BatchCommitWriteStreams" - + "Request\0225\n\006parent\030\001 \001(\tB%\340A\002\372A\037\n\035bigquer" - + "y.googleapis.com/Table\022\032\n\rwrite_streams\030" - + "\002 \003(\tB\003\340A\002\"\231\001\n\037BatchCommitWriteStreamsRe" - + "sponse\022/\n\013commit_time\030\001 \001(\0132\032.google.pro" - + "tobuf.Timestamp\022E\n\rstream_errors\030\002 \003(\0132." - + ".google.cloud.bigquery.storage.v1.Storag" - + "eError\"^\n\032FinalizeWriteStreamRequest\022@\n\004" - + "name\030\001 \001(\tB2\340A\002\372A,\n*bigquerystorage.goog" - + "leapis.com/WriteStream\"0\n\033FinalizeWriteS" - + "treamResponse\022\021\n\trow_count\030\001 \001(\003\"\211\001\n\020Flu" - + "shRowsRequest\022H\n\014write_stream\030\001 \001(\tB2\340A\002" - + "\372A,\n*bigquerystorage.googleapis.com/Writ" - + "eStream\022+\n\006offset\030\002 \001(\0132\033.google.protobu" - + "f.Int64Value\"#\n\021FlushRowsResponse\022\016\n\006off" - + "set\030\001 \001(\003\"\245\003\n\014StorageError\022M\n\004code\030\001 \001(\016" - + "2?.google.cloud.bigquery.storage.v1.Stor" - + "ageError.StorageErrorCode\022\016\n\006entity\030\002 \001(" - + "\t\022\025\n\rerror_message\030\003 \001(\t\"\236\002\n\020StorageErro" - + "rCode\022\"\n\036STORAGE_ERROR_CODE_UNSPECIFIED\020" - + "\000\022\023\n\017TABLE_NOT_FOUND\020\001\022\034\n\030STREAM_ALREADY" - + "_COMMITTED\020\002\022\024\n\020STREAM_NOT_FOUND\020\003\022\027\n\023IN" - + "VALID_STREAM_TYPE\020\004\022\030\n\024INVALID_STREAM_ST" - + "ATE\020\005\022\024\n\020STREAM_FINALIZED\020\006\022 \n\034SCHEMA_MI" - + "SMATCH_EXTRA_FIELDS\020\007\022\031\n\025OFFSET_ALREADY_" - + "EXISTS\020\010\022\027\n\023OFFSET_OUT_OF_RANGE\020\t\"\263\001\n\010Ro" - + "wError\022\r\n\005index\030\001 \001(\003\022E\n\004code\030\002 \001(\01627.go" - + "ogle.cloud.bigquery.storage.v1.RowError." - + "RowErrorCode\022\017\n\007message\030\003 \001(\t\"@\n\014RowErro" - + "rCode\022\036\n\032ROW_ERROR_CODE_UNSPECIFIED\020\000\022\020\n" - + "\014FIELDS_ERROR\020\0012\222\006\n\014BigQueryRead\022\351\001\n\021Cre" - + "ateReadSession\022:.google.cloud.bigquery.s" - + "torage.v1.CreateReadSessionRequest\032-.goo" - + "gle.cloud.bigquery.storage.v1.ReadSessio" - + "n\"i\202\323\344\223\002<\"7/v1/{read_session.table=proje" - + "cts/*/datasets/*/tables/*}:\001*\332A$parent,r" - + "ead_session,max_stream_count\022\317\001\n\010ReadRow" - + "s\0221.google.cloud.bigquery.storage.v1.Rea" - + "dRowsRequest\0322.google.cloud.bigquery.sto" - + "rage.v1.ReadRowsResponse\"Z\202\323\344\223\002?\022=/v1/{r" - + "ead_stream=projects/*/locations/*/sessio" - + "ns/*/streams/*}\332A\022read_stream,offset0\001\022\306" - + "\001\n\017SplitReadStream\0228.google.cloud.bigque" - + "ry.storage.v1.SplitReadStreamRequest\0329.g" - + "oogle.cloud.bigquery.storage.v1.SplitRea" - + "dStreamResponse\">\202\323\344\223\0028\0226/v1/{name=proje" - + "cts/*/locations/*/sessions/*/streams/*}\032" - + "{\312A\036bigquerystorage.googleapis.com\322AWhtt" - + "ps://www.googleapis.com/auth/bigquery,ht" - + "tps://www.googleapis.com/auth/cloud-plat" - + "form2\274\013\n\rBigQueryWrite\022\327\001\n\021CreateWriteSt" - + "ream\022:.google.cloud.bigquery.storage.v1." - + "CreateWriteStreamRequest\032-.google.cloud." - + "bigquery.storage.v1.WriteStream\"W\202\323\344\223\002;\"" - + "+/v1/{parent=projects/*/datasets/*/table" - + "s/*}:\014write_stream\332A\023parent,write_stream" - + "\022\322\001\n\nAppendRows\0223.google.cloud.bigquery." - + "storage.v1.AppendRowsRequest\0324.google.cl" - + "oud.bigquery.storage.v1.AppendRowsRespon" - + "se\"U\202\323\344\223\002@\";/v1/{write_stream=projects/*" - + "/datasets/*/tables/*/streams/*}:\001*\332A\014wri" - + "te_stream(\0010\001\022\277\001\n\016GetWriteStream\0227.googl" - + "e.cloud.bigquery.storage.v1.GetWriteStre" - + "amRequest\032-.google.cloud.bigquery.storag" - + "e.v1.WriteStream\"E\202\323\344\223\0028\"3/v1/{name=proj" - + "ects/*/datasets/*/tables/*/streams/*}:\001*" - + "\332A\004name\022\331\001\n\023FinalizeWriteStream\022<.google" - + ".cloud.bigquery.storage.v1.FinalizeWrite" - + "StreamRequest\032=.google.cloud.bigquery.st" - + "orage.v1.FinalizeWriteStreamResponse\"E\202\323" - + "\344\223\0028\"3/v1/{name=projects/*/datasets/*/ta" - + "bles/*/streams/*}:\001*\332A\004name\022\334\001\n\027BatchCom" - + "mitWriteStreams\022@.google.cloud.bigquery." - + "storage.v1.BatchCommitWriteStreamsReques" - + "t\032A.google.cloud.bigquery.storage.v1.Bat" - + "chCommitWriteStreamsResponse\"<\202\323\344\223\002-\022+/v" - + "1/{parent=projects/*/datasets/*/tables/*" - + "}\332A\006parent\022\313\001\n\tFlushRows\0222.google.cloud." - + "bigquery.storage.v1.FlushRowsRequest\0323.g" - + "oogle.cloud.bigquery.storage.v1.FlushRow" - + "sResponse\"U\202\323\344\223\002@\";/v1/{write_stream=pro" - + "jects/*/datasets/*/tables/*/streams/*}:\001" - + "*\332A\014write_stream\032\260\001\312A\036bigquerystorage.go" - + "ogleapis.com\322A\213\001https://www.googleapis.c" - + "om/auth/bigquery,https://www.googleapis." - + "com/auth/bigquery.insertdata,https://www" - + ".googleapis.com/auth/cloud-platformB\235\002\n$" - + "com.google.cloud.bigquery.storage.v1B\014St" - + "orageProtoP\001ZGgoogle.golang.org/genproto" - + "/googleapis/cloud/bigquery/storage/v1;st" - + "orage\252\002 Google.Cloud.BigQuery.Storage.V1" - + "\312\002 Google\\Cloud\\BigQuery\\Storage\\V1\352AU\n\035" - + "bigquery.googleapis.com/Table\0224projects/" - + "{project}/datasets/{dataset}/tables/{tab" - + "le}b\006proto3" + + "se\"\232\001\n\025GetWriteStreamRequest\022@\n\004name\030\001 \001" + + "(\tB2\340A\002\372A,\n*bigquerystorage.googleapis.c" + + "om/WriteStream\022?\n\004view\030\003 \001(\01621.google.cl" + + "oud.bigquery.storage.v1.WriteStreamView\"" + + "s\n\036BatchCommitWriteStreamsRequest\0225\n\006par" + + "ent\030\001 \001(\tB%\340A\002\372A\037\n\035bigquery.googleapis.c" + + "om/Table\022\032\n\rwrite_streams\030\002 \003(\tB\003\340A\002\"\231\001\n" + + "\037BatchCommitWriteStreamsResponse\022/\n\013comm" + + "it_time\030\001 \001(\0132\032.google.protobuf.Timestam" + + "p\022E\n\rstream_errors\030\002 \003(\0132..google.cloud." + + "bigquery.storage.v1.StorageError\"^\n\032Fina" + + "lizeWriteStreamRequest\022@\n\004name\030\001 \001(\tB2\340A" + + "\002\372A,\n*bigquerystorage.googleapis.com/Wri" + + "teStream\"0\n\033FinalizeWriteStreamResponse\022" + + "\021\n\trow_count\030\001 \001(\003\"\211\001\n\020FlushRowsRequest\022" + + "H\n\014write_stream\030\001 \001(\tB2\340A\002\372A,\n*bigquerys" + + "torage.googleapis.com/WriteStream\022+\n\006off" + + "set\030\002 \001(\0132\033.google.protobuf.Int64Value\"#" + + "\n\021FlushRowsResponse\022\016\n\006offset\030\001 \001(\003\"\245\003\n\014" + + "StorageError\022M\n\004code\030\001 \001(\0162?.google.clou" + + "d.bigquery.storage.v1.StorageError.Stora" + + "geErrorCode\022\016\n\006entity\030\002 \001(\t\022\025\n\rerror_mes" + + "sage\030\003 \001(\t\"\236\002\n\020StorageErrorCode\022\"\n\036STORA" + + "GE_ERROR_CODE_UNSPECIFIED\020\000\022\023\n\017TABLE_NOT" + + "_FOUND\020\001\022\034\n\030STREAM_ALREADY_COMMITTED\020\002\022\024" + + "\n\020STREAM_NOT_FOUND\020\003\022\027\n\023INVALID_STREAM_T" + + "YPE\020\004\022\030\n\024INVALID_STREAM_STATE\020\005\022\024\n\020STREA" + + "M_FINALIZED\020\006\022 \n\034SCHEMA_MISMATCH_EXTRA_F" + + "IELDS\020\007\022\031\n\025OFFSET_ALREADY_EXISTS\020\010\022\027\n\023OF" + + "FSET_OUT_OF_RANGE\020\t\"\263\001\n\010RowError\022\r\n\005inde" + + "x\030\001 \001(\003\022E\n\004code\030\002 \001(\01627.google.cloud.big" + + "query.storage.v1.RowError.RowErrorCode\022\017" + + "\n\007message\030\003 \001(\t\"@\n\014RowErrorCode\022\036\n\032ROW_E" + + "RROR_CODE_UNSPECIFIED\020\000\022\020\n\014FIELDS_ERROR\020" + + "\0012\222\006\n\014BigQueryRead\022\351\001\n\021CreateReadSession" + + "\022:.google.cloud.bigquery.storage.v1.Crea" + + "teReadSessionRequest\032-.google.cloud.bigq" + + "uery.storage.v1.ReadSession\"i\202\323\344\223\002<\"7/v1" + + "/{read_session.table=projects/*/datasets" + + "/*/tables/*}:\001*\332A$parent,read_session,ma" + + "x_stream_count\022\317\001\n\010ReadRows\0221.google.clo" + + "ud.bigquery.storage.v1.ReadRowsRequest\0322" + + ".google.cloud.bigquery.storage.v1.ReadRo" + + "wsResponse\"Z\202\323\344\223\002?\022=/v1/{read_stream=pro" + + "jects/*/locations/*/sessions/*/streams/*" + + "}\332A\022read_stream,offset0\001\022\306\001\n\017SplitReadSt" + + "ream\0228.google.cloud.bigquery.storage.v1." + + "SplitReadStreamRequest\0329.google.cloud.bi" + + "gquery.storage.v1.SplitReadStreamRespons" + + "e\">\202\323\344\223\0028\0226/v1/{name=projects/*/location" + + "s/*/sessions/*/streams/*}\032{\312A\036bigqueryst" + + "orage.googleapis.com\322AWhttps://www.googl" + + "eapis.com/auth/bigquery,https://www.goog" + + "leapis.com/auth/cloud-platform2\274\013\n\rBigQu" + + "eryWrite\022\327\001\n\021CreateWriteStream\022:.google." + + "cloud.bigquery.storage.v1.CreateWriteStr" + + "eamRequest\032-.google.cloud.bigquery.stora" + + "ge.v1.WriteStream\"W\202\323\344\223\002;\"+/v1/{parent=p" + + "rojects/*/datasets/*/tables/*}:\014write_st" + + "ream\332A\023parent,write_stream\022\322\001\n\nAppendRow" + + "s\0223.google.cloud.bigquery.storage.v1.App" + + "endRowsRequest\0324.google.cloud.bigquery.s" + + "torage.v1.AppendRowsResponse\"U\202\323\344\223\002@\";/v" + + "1/{write_stream=projects/*/datasets/*/ta" + + "bles/*/streams/*}:\001*\332A\014write_stream(\0010\001\022" + + "\277\001\n\016GetWriteStream\0227.google.cloud.bigque" + + "ry.storage.v1.GetWriteStreamRequest\032-.go" + + "ogle.cloud.bigquery.storage.v1.WriteStre" + + "am\"E\202\323\344\223\0028\"3/v1/{name=projects/*/dataset" + + "s/*/tables/*/streams/*}:\001*\332A\004name\022\331\001\n\023Fi" + + "nalizeWriteStream\022<.google.cloud.bigquer" + + "y.storage.v1.FinalizeWriteStreamRequest\032" + + "=.google.cloud.bigquery.storage.v1.Final" + + "izeWriteStreamResponse\"E\202\323\344\223\0028\"3/v1/{nam" + + "e=projects/*/datasets/*/tables/*/streams" + + "/*}:\001*\332A\004name\022\334\001\n\027BatchCommitWriteStream" + + "s\022@.google.cloud.bigquery.storage.v1.Bat" + + "chCommitWriteStreamsRequest\032A.google.clo" + + "ud.bigquery.storage.v1.BatchCommitWriteS" + + "treamsResponse\"<\202\323\344\223\002-\022+/v1/{parent=proj" + + "ects/*/datasets/*/tables/*}\332A\006parent\022\313\001\n" + + "\tFlushRows\0222.google.cloud.bigquery.stora" + + "ge.v1.FlushRowsRequest\0323.google.cloud.bi" + + "gquery.storage.v1.FlushRowsResponse\"U\202\323\344" + + "\223\002@\";/v1/{write_stream=projects/*/datase" + + "ts/*/tables/*/streams/*}:\001*\332A\014write_stre" + + "am\032\260\001\312A\036bigquerystorage.googleapis.com\322A" + + "\213\001https://www.googleapis.com/auth/bigque" + + "ry,https://www.googleapis.com/auth/bigqu" + + "ery.insertdata,https://www.googleapis.co" + + "m/auth/cloud-platformB\235\002\n$com.google.clo" + + "ud.bigquery.storage.v1B\014StorageProtoP\001ZG" + + "google.golang.org/genproto/googleapis/cl" + + "oud/bigquery/storage/v1;storage\252\002 Google" + + ".Cloud.BigQuery.Storage.V1\312\002 Google\\Clou" + + "d\\BigQuery\\Storage\\V1\352AU\n\035bigquery.googl" + + "eapis.com/Table\0224projects/{project}/data" + + "sets/{dataset}/tables/{table}b\006proto3" }; descriptor = com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom( @@ -432,7 +433,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_cloud_bigquery_storage_v1_GetWriteStreamRequest_descriptor, new java.lang.String[] { - "Name", + "Name", "View", }); internal_static_google_cloud_bigquery_storage_v1_BatchCommitWriteStreamsRequest_descriptor = getDescriptor().getMessageTypes().get(11); diff --git a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StreamProto.java b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StreamProto.java index 737f7e7ef9..ab597149fa 100644 --- a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StreamProto.java +++ b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/StreamProto.java @@ -97,7 +97,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "ame\030\001 \001(\tB\003\340A\003:{\352Ax\n)bigquerystorage.goo" + "gleapis.com/ReadStream\022Kprojects/{projec" + "t}/locations/{location}/sessions/{sessio" - + "n}/streams/{stream}\"\344\004\n\013WriteStream\022\021\n\004n" + + "n}/streams/{stream}\"\373\004\n\013WriteStream\022\021\n\004n" + "ame\030\001 \001(\tB\003\340A\003\022E\n\004type\030\002 \001(\01622.google.cl" + "oud.bigquery.storage.v1.WriteStream.Type" + "B\003\340A\005\0224\n\013create_time\030\003 \001(\0132\032.google.prot" @@ -106,20 +106,23 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "le_schema\030\005 \001(\0132-.google.cloud.bigquery." + "storage.v1.TableSchemaB\003\340A\003\022P\n\nwrite_mod" + "e\030\007 \001(\01627.google.cloud.bigquery.storage." - + "v1.WriteStream.WriteModeB\003\340A\005\"F\n\004Type\022\024\n" - + "\020TYPE_UNSPECIFIED\020\000\022\r\n\tCOMMITTED\020\001\022\013\n\007PE" - + "NDING\020\002\022\014\n\010BUFFERED\020\003\"3\n\tWriteMode\022\032\n\026WR" - + "ITE_MODE_UNSPECIFIED\020\000\022\n\n\006INSERT\020\001:v\352As\n" - + "*bigquerystorage.googleapis.com/WriteStr" - + "eam\022Eprojects/{project}/datasets/{datase" - + "t}/tables/{table}/streams/{stream}*>\n\nDa" - + "taFormat\022\033\n\027DATA_FORMAT_UNSPECIFIED\020\000\022\010\n" - + "\004AVRO\020\001\022\t\n\005ARROW\020\002B\304\001\n$com.google.cloud." - + "bigquery.storage.v1B\013StreamProtoP\001ZGgoog" - + "le.golang.org/genproto/googleapis/cloud/" - + "bigquery/storage/v1;storage\252\002 Google.Clo" - + "ud.BigQuery.Storage.V1\312\002 Google\\Cloud\\Bi" - + "gQuery\\Storage\\V1b\006proto3" + + "v1.WriteStream.WriteModeB\003\340A\005\022\025\n\010locatio" + + "n\030\010 \001(\tB\003\340A\005\"F\n\004Type\022\024\n\020TYPE_UNSPECIFIED" + + "\020\000\022\r\n\tCOMMITTED\020\001\022\013\n\007PENDING\020\002\022\014\n\010BUFFER" + + "ED\020\003\"3\n\tWriteMode\022\032\n\026WRITE_MODE_UNSPECIF" + + "IED\020\000\022\n\n\006INSERT\020\001:v\352As\n*bigquerystorage." + + "googleapis.com/WriteStream\022Eprojects/{pr" + + "oject}/datasets/{dataset}/tables/{table}" + + "/streams/{stream}*>\n\nDataFormat\022\033\n\027DATA_" + + "FORMAT_UNSPECIFIED\020\000\022\010\n\004AVRO\020\001\022\t\n\005ARROW\020" + + "\002*I\n\017WriteStreamView\022!\n\035WRITE_STREAM_VIE" + + "W_UNSPECIFIED\020\000\022\t\n\005BASIC\020\001\022\010\n\004FULL\020\002B\304\001\n" + + "$com.google.cloud.bigquery.storage.v1B\013S" + + "treamProtoP\001ZGgoogle.golang.org/genproto" + + "/googleapis/cloud/bigquery/storage/v1;st" + + "orage\252\002 Google.Cloud.BigQuery.Storage.V1" + + "\312\002 Google\\Cloud\\BigQuery\\Storage\\V1b\006pro" + + "to3" }; descriptor = com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom( @@ -189,7 +192,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable( internal_static_google_cloud_bigquery_storage_v1_WriteStream_descriptor, new java.lang.String[] { - "Name", "Type", "CreateTime", "CommitTime", "TableSchema", "WriteMode", + "Name", "Type", "CreateTime", "CommitTime", "TableSchema", "WriteMode", "Location", }); com.google.protobuf.ExtensionRegistry registry = com.google.protobuf.ExtensionRegistry.newInstance(); diff --git a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStream.java b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStream.java index ad94a441a4..be224223f2 100644 --- a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStream.java +++ b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStream.java @@ -41,6 +41,7 @@ private WriteStream() { name_ = ""; type_ = 0; writeMode_ = 0; + location_ = ""; } @java.lang.Override @@ -139,6 +140,13 @@ private WriteStream( writeMode_ = rawValue; break; } + case 66: + { + java.lang.String s = input.readStringRequireUtf8(); + + location_ = s; + break; + } default: { if (!parseUnknownField(input, unknownFields, extensionRegistry, tag)) { @@ -801,6 +809,59 @@ public com.google.cloud.bigquery.storage.v1.WriteStream.WriteMode getWriteMode() : result; } + public static final int LOCATION_FIELD_NUMBER = 8; + private volatile java.lang.Object location_; + /** + * + * + *
+   * Immutable. The geographic location where the stream's dataset resides. See
+   * https://cloud.google.com/bigquery/docs/locations for supported
+   * locations.
+   * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @return The location. + */ + @java.lang.Override + public java.lang.String getLocation() { + java.lang.Object ref = location_; + 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(); + location_ = s; + return s; + } + } + /** + * + * + *
+   * Immutable. The geographic location where the stream's dataset resides. See
+   * https://cloud.google.com/bigquery/docs/locations for supported
+   * locations.
+   * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @return The bytes for location. + */ + @java.lang.Override + public com.google.protobuf.ByteString getLocationBytes() { + java.lang.Object ref = location_; + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + location_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + private byte memoizedIsInitialized = -1; @java.lang.Override @@ -836,6 +897,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io .getNumber()) { output.writeEnum(7, writeMode_); } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(location_)) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 8, location_); + } unknownFields.writeTo(output); } @@ -866,6 +930,9 @@ public int getSerializedSize() { .getNumber()) { size += com.google.protobuf.CodedOutputStream.computeEnumSize(7, writeMode_); } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(location_)) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(8, location_); + } size += unknownFields.getSerializedSize(); memoizedSize = size; return size; @@ -897,6 +964,7 @@ public boolean equals(final java.lang.Object obj) { if (!getTableSchema().equals(other.getTableSchema())) return false; } if (writeMode_ != other.writeMode_) return false; + if (!getLocation().equals(other.getLocation())) return false; if (!unknownFields.equals(other.unknownFields)) return false; return true; } @@ -926,6 +994,8 @@ public int hashCode() { } hash = (37 * hash) + WRITE_MODE_FIELD_NUMBER; hash = (53 * hash) + writeMode_; + hash = (37 * hash) + LOCATION_FIELD_NUMBER; + hash = (53 * hash) + getLocation().hashCode(); hash = (29 * hash) + unknownFields.hashCode(); memoizedHashCode = hash; return hash; @@ -1095,6 +1165,8 @@ public Builder clear() { } writeMode_ = 0; + location_ = ""; + return this; } @@ -1140,6 +1212,7 @@ public com.google.cloud.bigquery.storage.v1.WriteStream buildPartial() { result.tableSchema_ = tableSchemaBuilder_.build(); } result.writeMode_ = writeMode_; + result.location_ = location_; onBuilt(); return result; } @@ -1209,6 +1282,10 @@ public Builder mergeFrom(com.google.cloud.bigquery.storage.v1.WriteStream other) if (other.writeMode_ != 0) { setWriteModeValue(other.getWriteModeValue()); } + if (!other.getLocation().isEmpty()) { + location_ = other.location_; + onChanged(); + } this.mergeUnknownFields(other.unknownFields); onChanged(); return this; @@ -2224,6 +2301,122 @@ public Builder clearWriteMode() { return this; } + private java.lang.Object location_ = ""; + /** + * + * + *
+     * Immutable. The geographic location where the stream's dataset resides. See
+     * https://cloud.google.com/bigquery/docs/locations for supported
+     * locations.
+     * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @return The location. + */ + public java.lang.String getLocation() { + java.lang.Object ref = location_; + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + location_ = s; + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + *
+     * Immutable. The geographic location where the stream's dataset resides. See
+     * https://cloud.google.com/bigquery/docs/locations for supported
+     * locations.
+     * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @return The bytes for location. + */ + public com.google.protobuf.ByteString getLocationBytes() { + java.lang.Object ref = location_; + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + location_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + *
+     * Immutable. The geographic location where the stream's dataset resides. See
+     * https://cloud.google.com/bigquery/docs/locations for supported
+     * locations.
+     * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @param value The location to set. + * @return This builder for chaining. + */ + public Builder setLocation(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + + location_ = value; + onChanged(); + return this; + } + /** + * + * + *
+     * Immutable. The geographic location where the stream's dataset resides. See
+     * https://cloud.google.com/bigquery/docs/locations for supported
+     * locations.
+     * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @return This builder for chaining. + */ + public Builder clearLocation() { + + location_ = getDefaultInstance().getLocation(); + onChanged(); + return this; + } + /** + * + * + *
+     * Immutable. The geographic location where the stream's dataset resides. See
+     * https://cloud.google.com/bigquery/docs/locations for supported
+     * locations.
+     * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @param value The bytes for location to set. + * @return This builder for chaining. + */ + public Builder setLocationBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + + location_ = value; + 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-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStreamOrBuilder.java b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStreamOrBuilder.java index 029de2eff0..27aca3d4f1 100644 --- a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStreamOrBuilder.java +++ b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStreamOrBuilder.java @@ -245,4 +245,33 @@ public interface WriteStreamOrBuilder * @return The writeMode. */ com.google.cloud.bigquery.storage.v1.WriteStream.WriteMode getWriteMode(); + + /** + * + * + *
+   * Immutable. The geographic location where the stream's dataset resides. See
+   * https://cloud.google.com/bigquery/docs/locations for supported
+   * locations.
+   * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @return The location. + */ + java.lang.String getLocation(); + /** + * + * + *
+   * Immutable. The geographic location where the stream's dataset resides. See
+   * https://cloud.google.com/bigquery/docs/locations for supported
+   * locations.
+   * 
+ * + * string location = 8 [(.google.api.field_behavior) = IMMUTABLE]; + * + * @return The bytes for location. + */ + com.google.protobuf.ByteString getLocationBytes(); } diff --git a/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStreamView.java b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStreamView.java new file mode 100644 index 0000000000..7382e19730 --- /dev/null +++ b/proto-google-cloud-bigquerystorage-v1/src/main/java/com/google/cloud/bigquery/storage/v1/WriteStreamView.java @@ -0,0 +1,185 @@ +/* + * Copyright 2020 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/cloud/bigquery/storage/v1/stream.proto + +package com.google.cloud.bigquery.storage.v1; + +/** + * + * + *
+ * WriteStreamView is a view enum that controls what details about a write
+ * stream should be returned.
+ * 
+ * + * Protobuf enum {@code google.cloud.bigquery.storage.v1.WriteStreamView} + */ +public enum WriteStreamView implements com.google.protobuf.ProtocolMessageEnum { + /** + * + * + *
+   * The default / unset value.
+   * 
+ * + * WRITE_STREAM_VIEW_UNSPECIFIED = 0; + */ + WRITE_STREAM_VIEW_UNSPECIFIED(0), + /** + * + * + *
+   * The BASIC projection returns basic metadata about a write stream.  The
+   * basic view does not include schema information.  This is the default view
+   * returned by GetWriteStream.
+   * 
+ * + * BASIC = 1; + */ + BASIC(1), + /** + * + * + *
+   * The FULL projection returns all available write stream metadata, including
+   * the schema.  CreateWriteStream returns the full projection of write stream
+   * metadata.
+   * 
+ * + * FULL = 2; + */ + FULL(2), + UNRECOGNIZED(-1), + ; + + /** + * + * + *
+   * The default / unset value.
+   * 
+ * + * WRITE_STREAM_VIEW_UNSPECIFIED = 0; + */ + public static final int WRITE_STREAM_VIEW_UNSPECIFIED_VALUE = 0; + /** + * + * + *
+   * The BASIC projection returns basic metadata about a write stream.  The
+   * basic view does not include schema information.  This is the default view
+   * returned by GetWriteStream.
+   * 
+ * + * BASIC = 1; + */ + public static final int BASIC_VALUE = 1; + /** + * + * + *
+   * The FULL projection returns all available write stream metadata, including
+   * the schema.  CreateWriteStream returns the full projection of write stream
+   * metadata.
+   * 
+ * + * FULL = 2; + */ + public static final int FULL_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 WriteStreamView 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 WriteStreamView forNumber(int value) { + switch (value) { + case 0: + return WRITE_STREAM_VIEW_UNSPECIFIED; + case 1: + return BASIC; + case 2: + return FULL; + 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 WriteStreamView findValueByNumber(int number) { + return WriteStreamView.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.cloud.bigquery.storage.v1.StreamProto.getDescriptor().getEnumTypes().get(1); + } + + private static final WriteStreamView[] VALUES = values(); + + public static WriteStreamView 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 WriteStreamView(int value) { + this.value = value; + } + + // @@protoc_insertion_point(enum_scope:google.cloud.bigquery.storage.v1.WriteStreamView) +} diff --git a/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/storage.proto b/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/storage.proto index e0b25c1afe..a49e1a389c 100644 --- a/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/storage.proto +++ b/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/storage.proto @@ -524,6 +524,10 @@ message GetWriteStreamRequest { type: "bigquerystorage.googleapis.com/WriteStream" } ]; + + // Indicates whether to get full or partial view of the WriteStream. If + // not set, view returned will be basic. + WriteStreamView view = 3; } // Request message for `BatchCommitWriteStreams`. diff --git a/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/stream.proto b/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/stream.proto index 3735c73d67..fe71adfa6b 100644 --- a/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/stream.proto +++ b/proto-google-cloud-bigquerystorage-v1/src/main/proto/google/cloud/bigquery/storage/v1/stream.proto @@ -203,6 +203,23 @@ message ReadStream { string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } +// WriteStreamView is a view enum that controls what details about a write +// stream should be returned. +enum WriteStreamView { + // The default / unset value. + WRITE_STREAM_VIEW_UNSPECIFIED = 0; + + // The BASIC projection returns basic metadata about a write stream. The + // basic view does not include schema information. This is the default view + // returned by GetWriteStream. + BASIC = 1; + + // The FULL projection returns all available write stream metadata, including + // the schema. CreateWriteStream returns the full projection of write stream + // metadata. + FULL = 2; +} + // Information about a single stream that gets data inside the storage system. message WriteStream { option (google.api.resource) = { @@ -261,4 +278,9 @@ message WriteStream { // Immutable. Mode of the stream. WriteMode write_mode = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The geographic location where the stream's dataset resides. See + // https://cloud.google.com/bigquery/docs/locations for supported + // locations. + string location = 8 [(google.api.field_behavior) = IMMUTABLE]; }