docs: mark BigQueryWrite v1beta2 as deprecated

Google APIs · copybara-github · commit 8b91ac45618d · 2024-02-27T20:57:21.000-08:00
PiperOrigin-RevId: 610968688
diff --git a/google/cloud/bigquery/storage/v1beta2/storage.proto b/google/cloud/bigquery/storage/v1beta2/storage.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -112,10 +112,12 @@ service BigQueryRead {
 //
 // The Write API can be used to write data to BigQuery.
 //
+//
 // The [google.cloud.bigquery.storage.v1
 //   API](/bigquery/docs/reference/storage/rpc/google.cloud.bigquery.storage.v1)
 //   should be used instead of the v1beta2 API for BigQueryWrite operations.
 service BigQueryWrite {
+  option deprecated = true;
   option (google.api.default_host) = "bigquerystorage.googleapis.com";
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/bigquery,"
@@ -129,6 +131,7 @@ service BigQueryWrite {
   // number of clients. Data written to this stream is considered committed as
   // soon as an acknowledgement is received.
   rpc CreateWriteStream(CreateWriteStreamRequest) returns (WriteStream) {
+    option deprecated = true;
     option (google.api.http) = {
       post: "/v1beta2/{parent=projects/*/datasets/*/tables/*}"
       body: "write_stream"
@@ -156,6 +159,7 @@ service BigQueryWrite {
   // If the stream is of `PENDING` type, data will only be available for read
   // operations after the stream is committed.
   rpc AppendRows(stream AppendRowsRequest) returns (stream AppendRowsResponse) {
+    option deprecated = true;
     option (google.api.http) = {
       post: "/v1beta2/{write_stream=projects/*/datasets/*/tables/*/streams/*}"
       body: "*"
@@ -165,6 +169,7 @@ service BigQueryWrite {
 
   // Gets a write stream.
   rpc GetWriteStream(GetWriteStreamRequest) returns (WriteStream) {
+    option deprecated = true;
     option (google.api.http) = {
       post: "/v1beta2/{name=projects/*/datasets/*/tables/*/streams/*}"
       body: "*"
@@ -176,6 +181,7 @@ service BigQueryWrite {
   // stream. Finalize is not supported on the '_default' stream.
   rpc FinalizeWriteStream(FinalizeWriteStreamRequest)
       returns (FinalizeWriteStreamResponse) {
+    option deprecated = true;
     option (google.api.http) = {
       post: "/v1beta2/{name=projects/*/datasets/*/tables/*/streams/*}"
       body: "*"
@@ -190,6 +196,7 @@ service BigQueryWrite {
   // for read operations.
   rpc BatchCommitWriteStreams(BatchCommitWriteStreamsRequest)
       returns (BatchCommitWriteStreamsResponse) {
+    option deprecated = true;
     option (google.api.http) = {
       get: "/v1beta2/{parent=projects/*/datasets/*/tables/*}"
     };
@@ -203,6 +210,7 @@ service BigQueryWrite {
   // stream, to the offset specified in the request.
   // Flush is not supported on the _default stream, since it is not BUFFERED.
   rpc FlushRows(FlushRowsRequest) returns (FlushRowsResponse) {
+    option deprecated = true;
     option (google.api.http) = {
       post: "/v1beta2/{write_stream=projects/*/datasets/*/tables/*/streams/*}"
       body: "*"
@@ -309,7 +317,7 @@ message ReadRowsResponse {
 
   // The schema for the read. If read_options.selected_fields is set, the
   // schema may be different from the table schema as it will only contain
-  // the selected fields. This schema is equivelant to the one returned by
+  // the selected fields. This schema is equivalent to the one returned by
   // CreateSession. This field is only populated in the first ReadRowsResponse
   // RPC.
   oneof schema {
