docs: mark BigQueryWrite v1beta2 as deprecated (#2421)

* docs: mark BigQueryWrite v1beta2 as deprecated

PiperOrigin-RevId: 610968688

Source-Link: googleapis/googleapis@8b91ac4

Source-Link: googleapis/googleapis-gen@c742e2b
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYzc0MmUyYmJkNmI4Mzc5YzVlNDZjNTkzZDQ2ZWE4ODI5ZTFhMjEwNiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteClient.java

@@ -209,8 +209,11 @@
  * }</pre>
  *
  * <p>Please refer to the GitHub repository's samples for more quickstart code snippets.
+ *
+ * @deprecated This class is deprecated and will be removed in the next major version update.
  */
 @BetaApi
+@Deprecated
 @Generated("by gapic-generator-java")
 public class BigQueryWriteClient implements BackgroundResource {
   private final BigQueryWriteSettings settings;
@@ -288,7 +291,9 @@ public BigQueryWriteStub getStub() {
    *     `projects/{project}/datasets/{dataset}/tables/{table}`.
    * @param writeStream Required. Stream to be created.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final WriteStream createWriteStream(TableName parent, WriteStream writeStream) {
     CreateWriteStreamRequest request =
         CreateWriteStreamRequest.newBuilder()
@@ -325,7 +330,9 @@ public final WriteStream createWriteStream(TableName parent, WriteStream writeSt
    *     `projects/{project}/datasets/{dataset}/tables/{table}`.
    * @param writeStream Required. Stream to be created.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final WriteStream createWriteStream(String parent, WriteStream writeStream) {
     CreateWriteStreamRequest request =
         CreateWriteStreamRequest.newBuilder().setParent(parent).setWriteStream(writeStream).build();
@@ -360,7 +367,9 @@ public final WriteStream createWriteStream(String parent, WriteStream writeStrea
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final WriteStream createWriteStream(CreateWriteStreamRequest request) {
     return createWriteStreamCallable().call(request);
   }
@@ -393,7 +402,10 @@ public final WriteStream createWriteStream(CreateWriteStreamRequest request) {
    *   WriteStream response = future.get();
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<CreateWriteStreamRequest, WriteStream> createWriteStreamCallable() {
     return stub.createWriteStreamCallable();
   }
@@ -441,7 +453,10 @@ public final UnaryCallable<CreateWriteStreamRequest, WriteStream> createWriteStr
    *   }
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final BidiStreamingCallable<AppendRowsRequest, AppendRowsResponse> appendRowsCallable() {
     return stub.appendRowsCallable();
   }
@@ -467,7 +482,9 @@ public final BidiStreamingCallable<AppendRowsRequest, AppendRowsResponse> append
    * @param name Required. Name of the stream to get, in the form of
    *     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final WriteStream getWriteStream(WriteStreamName name) {
     GetWriteStreamRequest request =
         GetWriteStreamRequest.newBuilder().setName(name == null ? null : name.toString()).build();
@@ -495,7 +512,9 @@ public final WriteStream getWriteStream(WriteStreamName name) {
    * @param name Required. Name of the stream to get, in the form of
    *     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final WriteStream getWriteStream(String name) {
     GetWriteStreamRequest request = GetWriteStreamRequest.newBuilder().setName(name).build();
     return getWriteStream(request);
@@ -525,7 +544,9 @@ public final WriteStream getWriteStream(String name) {
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final WriteStream getWriteStream(GetWriteStreamRequest request) {
     return getWriteStreamCallable().call(request);
   }
@@ -554,7 +575,10 @@ public final WriteStream getWriteStream(GetWriteStreamRequest request) {
    *   WriteStream response = future.get();
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<GetWriteStreamRequest, WriteStream> getWriteStreamCallable() {
     return stub.getWriteStreamCallable();
   }
@@ -581,7 +605,9 @@ public final UnaryCallable<GetWriteStreamRequest, WriteStream> getWriteStreamCal
    * @param name Required. Name of the stream to finalize, in the form of
    *     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final FinalizeWriteStreamResponse finalizeWriteStream(WriteStreamName name) {
     FinalizeWriteStreamRequest request =
         FinalizeWriteStreamRequest.newBuilder()
@@ -612,7 +638,9 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(WriteStreamName nam
    * @param name Required. Name of the stream to finalize, in the form of
    *     `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final FinalizeWriteStreamResponse finalizeWriteStream(String name) {
     FinalizeWriteStreamRequest request =
         FinalizeWriteStreamRequest.newBuilder().setName(name).build();
@@ -644,7 +672,9 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(String name) {
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStreamRequest request) {
     return finalizeWriteStreamCallable().call(request);
   }
@@ -674,7 +704,10 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
    *   FinalizeWriteStreamResponse response = future.get();
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<FinalizeWriteStreamRequest, FinalizeWriteStreamResponse>
       finalizeWriteStreamCallable() {
     return stub.finalizeWriteStreamCallable();
@@ -704,7 +737,9 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
    * @param parent Required. Parent table that all the streams should belong to, in the form of
    *     `projects/{project}/datasets/{dataset}/tables/{table}`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(String parent) {
     BatchCommitWriteStreamsRequest request =
         BatchCommitWriteStreamsRequest.newBuilder().setParent(parent).build();
@@ -738,7 +773,9 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(String pare
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
       BatchCommitWriteStreamsRequest request) {
     return batchCommitWriteStreamsCallable().call(request);
@@ -770,7 +807,10 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
    *   BatchCommitWriteStreamsResponse response = future.get();
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<BatchCommitWriteStreamsRequest, BatchCommitWriteStreamsResponse>
       batchCommitWriteStreamsCallable() {
     return stub.batchCommitWriteStreamsCallable();
@@ -800,7 +840,9 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
    *
    * @param writeStream Required. The stream that is the target of the flush operation.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final FlushRowsResponse flushRows(WriteStreamName writeStream) {
     FlushRowsRequest request =
         FlushRowsRequest.newBuilder()
@@ -833,7 +875,9 @@ public final FlushRowsResponse flushRows(WriteStreamName writeStream) {
    *
    * @param writeStream Required. The stream that is the target of the flush operation.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final FlushRowsResponse flushRows(String writeStream) {
     FlushRowsRequest request = FlushRowsRequest.newBuilder().setWriteStream(writeStream).build();
     return flushRows(request);
@@ -867,7 +911,9 @@ public final FlushRowsResponse flushRows(String writeStream) {
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final FlushRowsResponse flushRows(FlushRowsRequest request) {
     return flushRowsCallable().call(request);
   }
@@ -900,7 +946,10 @@ public final FlushRowsResponse flushRows(FlushRowsRequest request) {
    *   FlushRowsResponse response = future.get();
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<FlushRowsRequest, FlushRowsResponse> flushRowsCallable() {
     return stub.flushRowsCallable();
   }

google-cloud-bigquerystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteSettings.java

@@ -68,39 +68,72 @@
  *             .build());
  * BigQueryWriteSettings bigQueryWriteSettings = bigQueryWriteSettingsBuilder.build();
  * }</pre>
+ *
+ * @deprecated This class is deprecated and will be removed in the next major version update.
  */
 @BetaApi
+@Deprecated
 @Generated("by gapic-generator-java")
 public class BigQueryWriteSettings extends ClientSettings<BigQueryWriteSettings> {
 
-  /** Returns the object with the settings used for calls to createWriteStream. */
+  /**
+   * Returns the object with the settings used for calls to createWriteStream.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public UnaryCallSettings<CreateWriteStreamRequest, WriteStream> createWriteStreamSettings() {
     return ((BigQueryWriteStubSettings) getStubSettings()).createWriteStreamSettings();
   }
 
-  /** Returns the object with the settings used for calls to appendRows. */
+  /**
+   * Returns the object with the settings used for calls to appendRows.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public StreamingCallSettings<AppendRowsRequest, AppendRowsResponse> appendRowsSettings() {
     return ((BigQueryWriteStubSettings) getStubSettings()).appendRowsSettings();
   }
 
-  /** Returns the object with the settings used for calls to getWriteStream. */
+  /**
+   * Returns the object with the settings used for calls to getWriteStream.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public UnaryCallSettings<GetWriteStreamRequest, WriteStream> getWriteStreamSettings() {
     return ((BigQueryWriteStubSettings) getStubSettings()).getWriteStreamSettings();
   }
 
-  /** Returns the object with the settings used for calls to finalizeWriteStream. */
+  /**
+   * Returns the object with the settings used for calls to finalizeWriteStream.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public UnaryCallSettings<FinalizeWriteStreamRequest, FinalizeWriteStreamResponse>
       finalizeWriteStreamSettings() {
     return ((BigQueryWriteStubSettings) getStubSettings()).finalizeWriteStreamSettings();
   }
 
-  /** Returns the object with the settings used for calls to batchCommitWriteStreams. */
+  /**
+   * Returns the object with the settings used for calls to batchCommitWriteStreams.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public UnaryCallSettings<BatchCommitWriteStreamsRequest, BatchCommitWriteStreamsResponse>
       batchCommitWriteStreamsSettings() {
     return ((BigQueryWriteStubSettings) getStubSettings()).batchCommitWriteStreamsSettings();
   }
 
-  /** Returns the object with the settings used for calls to flushRows. */
+  /**
+   * Returns the object with the settings used for calls to flushRows.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public UnaryCallSettings<FlushRowsRequest, FlushRowsResponse> flushRowsSettings() {
     return ((BigQueryWriteStubSettings) getStubSettings()).flushRowsSettings();
   }
@@ -201,37 +234,67 @@ public Builder applyToAllUnaryMethods(
       return this;
     }
 
-    /** Returns the builder for the settings used for calls to createWriteStream. */
+    /**
+     * Returns the builder for the settings used for calls to createWriteStream.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public UnaryCallSettings.Builder<CreateWriteStreamRequest, WriteStream>
         createWriteStreamSettings() {
       return getStubSettingsBuilder().createWriteStreamSettings();
     }
 
-    /** Returns the builder for the settings used for calls to appendRows. */
+    /**
+     * Returns the builder for the settings used for calls to appendRows.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public StreamingCallSettings.Builder<AppendRowsRequest, AppendRowsResponse>
         appendRowsSettings() {
       return getStubSettingsBuilder().appendRowsSettings();
     }
 
-    /** Returns the builder for the settings used for calls to getWriteStream. */
+    /**
+     * Returns the builder for the settings used for calls to getWriteStream.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public UnaryCallSettings.Builder<GetWriteStreamRequest, WriteStream> getWriteStreamSettings() {
       return getStubSettingsBuilder().getWriteStreamSettings();
     }
 
-    /** Returns the builder for the settings used for calls to finalizeWriteStream. */
+    /**
+     * Returns the builder for the settings used for calls to finalizeWriteStream.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public UnaryCallSettings.Builder<FinalizeWriteStreamRequest, FinalizeWriteStreamResponse>
         finalizeWriteStreamSettings() {
       return getStubSettingsBuilder().finalizeWriteStreamSettings();
     }
 
-    /** Returns the builder for the settings used for calls to batchCommitWriteStreams. */
+    /**
+     * Returns the builder for the settings used for calls to batchCommitWriteStreams.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public UnaryCallSettings.Builder<
             BatchCommitWriteStreamsRequest, BatchCommitWriteStreamsResponse>
         batchCommitWriteStreamsSettings() {
       return getStubSettingsBuilder().batchCommitWriteStreamsSettings();
     }
 
-    /** Returns the builder for the settings used for calls to flushRows. */
+    /**
+     * Returns the builder for the settings used for calls to flushRows.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public UnaryCallSettings.Builder<FlushRowsRequest, FlushRowsResponse> flushRowsSettings() {
       return getStubSettingsBuilder().flushRowsSettings();
     }