feat: add location to WriteStream and add WriteStreamView support (#295)

* feat: add location to WriteStream and add WriteStreamView support

PiperOrigin-RevId: 472835596

Source-Link: googleapis/googleapis@1cf9407

Source-Link: googleapis/googleapis-gen@59d0f10
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNTlkMGYxMGJhZGVjODY3OTEzZWJjMmViNGJhYzAyMWY3OTkwNDUxOSJ9

* 🦉 Updates from OwlBot post-processor

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

* feat: add proto annotation for non-ascii field mapping

PiperOrigin-RevId: 473815595

Source-Link: googleapis/googleapis@46cfc4c

Source-Link: googleapis/googleapis-gen@955ca31
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOTU1Y2EzMWQ4MTEwMGQ4MWVkN2UwYWUwNTIyMzU4YWM0NWQ1M2NjOSJ9

* chore: use gapic-generator-typescript v2.17.0

PiperOrigin-RevId: 474338479

Source-Link: googleapis/googleapis@d5d35e0

Source-Link: googleapis/googleapis-gen@efcd3f9
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZWZjZDNmOTM5NjJhMTAzZjY4ZjAwM2UyYTFlZWNkZTZmYTIxNmEyNyJ9

* test: use fully qualified request type name in tests

PiperOrigin-RevId: 475685359

Source-Link: googleapis/googleapis@7a12973

Source-Link: googleapis/googleapis-gen@370c729
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMzcwYzcyOWUyYmEwNjJhMTY3NDQ5YzI3ODgyYmE1ZjM3OWM1YzM0ZCJ9

* fix: regenerated locally

* fix(deps): use google-gax v3.5.2

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

packages/google-cloud-bigquery-storage/package.json

@@ -27,7 +27,7 @@
     "precompile": "gts clean"
   },
   "dependencies": {
-    "google-gax": "^3.3.0"
+    "google-gax": "^3.5.2"
   },
   "devDependencies": {
     "@types/mocha": "^9.0.0",
@@ -44,7 +44,7 @@
     "pack-n-play": "^1.0.0-2",
     "sinon": "^14.0.0",
     "ts-loader": "^9.0.0",
-    "typescript": "^4.6.4",
+    "typescript": "^4.8.3",
     "webpack": "^5.0.0",
     "webpack-cli": "^4.0.0"
   },

packages/google-cloud-bigquery-storage/protos/google/cloud/bigquery/storage/v1/annotations.proto

@@ -0,0 +1,28 @@
+syntax = "proto3";
+
+package google.cloud.bigquery.storage.v1;
+
+import "google/protobuf/descriptor.proto";
+
+option csharp_namespace = "Google.Cloud.BigQuery.Storage.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1;storage";
+option java_package = "com.google.cloud.bigquery.storage.v1";
+option java_multiple_files = true;
+option java_outer_classname = "AnnotationsProto";
+option php_namespace = "Google\\Cloud\\BigQuery\\Storage\\V1";
+
+extend google.protobuf.FieldOptions {
+  // Setting the column_name extension allows users to reference
+  // bigquery column independently of the field name in the protocol buffer
+  // message.
+  //
+  // The intended use of this annotation is to reference a destination column
+  // named using characters unavailable for protobuf field names (e.g. unicode
+  // characters).
+  //
+  // More details about BigQuery naming limitations can be found here:
+  // https://cloud.google.com/bigquery/docs/schemas#column_names
+  //
+  // This extension is currently experimental.
+  optional string column_name = 454943157;
+}

packages/google-cloud-bigquery-storage/protos/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`.

packages/google-cloud-bigquery-storage/protos/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];
 }