feat: add beta2 deprecation message

Google APIs · copybara-github · commit 29b8ec7ad787 · 2023-08-14T12:26:16.000-07:00
PiperOrigin-RevId: 556875976
diff --git a/google/cloud/bigquery/storage/v1beta2/storage.proto b/google/cloud/bigquery/storage/v1beta2/storage.proto
@@ -70,7 +70,8 @@ service BigQueryRead {
       post: "/v1beta2/{read_session.table=projects/*/datasets/*/tables/*}"
       body: "*"
     };
-    option (google.api.method_signature) = "parent,read_session,max_stream_count";
+    option (google.api.method_signature) =
+        "parent,read_session,max_stream_count";
   }
 
   // Reads rows from the stream in the format prescribed by the ReadSession.
@@ -99,7 +100,8 @@ service BigQueryRead {
   // original, primary, and residual, that original[0-j] = primary[0-j] and
   // original[j-n] = residual[0-m] once the streams have been read to
   // completion.
-  rpc SplitReadStream(SplitReadStreamRequest) returns (SplitReadStreamResponse) {
+  rpc SplitReadStream(SplitReadStreamRequest)
+      returns (SplitReadStreamResponse) {
     option (google.api.http) = {
       get: "/v1beta2/{name=projects/*/locations/*/sessions/*/streams/*}"
     };
@@ -109,6 +111,10 @@ service BigQueryRead {
 // BigQuery Write API.
 //
 // 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 (google.api.default_host) = "bigquerystorage.googleapis.com";
   option (google.api.oauth_scopes) =
@@ -168,7 +174,8 @@ service BigQueryWrite {
 
   // Finalize a write stream so that no new data can be appended to the
   // stream. Finalize is not supported on the '_default' stream.
-  rpc FinalizeWriteStream(FinalizeWriteStreamRequest) returns (FinalizeWriteStreamResponse) {
+  rpc FinalizeWriteStream(FinalizeWriteStreamRequest)
+      returns (FinalizeWriteStreamResponse) {
     option (google.api.http) = {
       post: "/v1beta2/{name=projects/*/datasets/*/tables/*/streams/*}"
       body: "*"
@@ -181,7 +188,8 @@ service BigQueryWrite {
   // Streams must be finalized before commit and cannot be committed multiple
   // times. Once a stream is committed, data in the stream becomes available
   // for read operations.
-  rpc BatchCommitWriteStreams(BatchCommitWriteStreamsRequest) returns (BatchCommitWriteStreamsResponse) {
+  rpc BatchCommitWriteStreams(BatchCommitWriteStreamsRequest)
+      returns (BatchCommitWriteStreamsResponse) {
     option (google.api.http) = {
       get: "/v1beta2/{parent=projects/*/datasets/*/tables/*}"
     };
@@ -350,9 +358,7 @@ message CreateWriteStreamRequest {
   // of `projects/{project}/datasets/{dataset}/tables/{table}`.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = {
-      type: "bigquery.googleapis.com/Table"
-    }
+    (google.api.resource_reference) = { type: "bigquery.googleapis.com/Table" }
   ];
 
   // Required. Stream to be created.
@@ -370,9 +376,9 @@ message AppendRowsRequest {
     ProtoRows rows = 2;
   }
 
-  // Required. The stream that is the target of the append operation. This value must be
-  // specified for the initial request. If subsequent requests specify the
-  // stream name, it must equal to the value provided in the first request.
+  // Required. The stream that is the target of the append operation. This value
+  // must be specified for the initial request. If subsequent requests specify
+  // the stream name, it must equal to the value provided in the first request.
   // To write to the _default stream, populate this field with a string in the
   // format `projects/{project}/datasets/{dataset}/tables/{table}/_default`.
   string write_stream = 1 [
@@ -458,11 +464,9 @@ message GetWriteStreamRequest {
 
 // Request message for `BatchCommitWriteStreams`.
 message BatchCommitWriteStreamsRequest {
-  // Required. Parent table that all the streams should belong to, in the form of
-  // `projects/{project}/datasets/{dataset}/tables/{table}`.
-  string parent = 1 [
-    (google.api.field_behavior) = REQUIRED
-  ];
+  // Required. Parent table that all the streams should belong to, in the form
+  // of `projects/{project}/datasets/{dataset}/tables/{table}`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The group of streams that will be committed atomically.
   repeated string write_streams = 2 [(google.api.field_behavior) = REQUIRED];
