fix: use full link in comment to fix JSDoc broken link (#851)

* docs(samples): include metadata file, add exclusions for samples to handwritten libraries

PiperOrigin-RevId: 429395631

Source-Link: googleapis/googleapis@84594b3

Source-Link: https://github.com/googleapis/googleapis-gen/commit/ed74f970fd82914874e6b27b04763cfa66bafe9b
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZWQ3NGY5NzBmZDgyOTE0ODc0ZTZiMjdiMDQ3NjNjZmE2NmJhZmU5YiJ9

* 🦉 Updates from OwlBot

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

* chore: update v2.14.1 gapic-generator-typescript

Committer: @summer-ji-eng
PiperOrigin-RevId: 433031262

Source-Link: googleapis/googleapis@2a55d13

Source-Link: https://github.com/googleapis/googleapis-gen/commit/2fce3893ae9da47763e0872c4a3a87d9ff78771f
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMmZjZTM4OTNhZTlkYTQ3NzYzZTA4NzJjNGEzYTg3ZDlmZjc4NzcxZiJ9

* 🦉 Updates from OwlBot post-processor

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

* chore: update v2.14.2 gapic-generator-typescript

Committer: @summer-ji-eng
PiperOrigin-RevId: 434859890

Source-Link: googleapis/googleapis@bc2432d

Source-Link: https://github.com/googleapis/googleapis-gen/commit/930b673103e92523f8cfed38decd7d3afae8ebe7
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOTMwYjY3MzEwM2U5MjUyM2Y4Y2ZlZDM4ZGVjZDdkM2FmYWU4ZWJlNyJ9

* 🦉 Updates from OwlBot post-processor

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

* chore: remove unused imports

PiperOrigin-RevId: 439629269

Source-Link: googleapis/googleapis@8d458c8

Source-Link: https://github.com/googleapis/googleapis-gen/commit/065f18138630ac4c920ac4bc71b447098389dba2
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDY1ZjE4MTM4NjMwYWM0YzkyMGFjNGJjNzFiNDQ3MDk4Mzg5ZGJhMiJ9

* 🦉 Updates from OwlBot post-processor

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

* fix: use full link in comment to fix JSDoc broken link

Committer: @summer-ji-eng
PiperOrigin-RevId: 440481666

Source-Link: googleapis/googleapis@6a21110

Source-Link: https://github.com/googleapis/googleapis-gen/commit/e6e39aff33b90a63a18e9081e480b08a41c548ac
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZTZlMzlhZmYzM2I5MGE2M2ExOGU5MDgxZTQ4MGIwOGE0MWM1NDhhYyJ9

* 🦉 Updates from OwlBot post-processor

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

* fix: manual test

* fix test case for recognize voice

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Jeffrey Rennie <[email protected]>
Co-authored-by: Summer Ji <[email protected]>

Author: 3 people

linkinator.config.json

@@ -3,8 +3,14 @@
   "skip": [
     "https://codecov.io/gh/googleapis/",
     "www.googleapis.com",
-    "img.shields.io"
+    "img.shields.io",
+    "https://console.cloud.google.com/cloudshell",
+    "https://support.google.com"
   ],
   "silent": true,
-  "concurrency": 5
+  "concurrency": 5,
+  "retry": true,
+  "retryErrors": true,
+  "retryErrorsCount": 5,
+  "retryErrorsJitter": 3000
 }

package.json

@@ -48,7 +48,7 @@
   "dependencies": {
     "@google-cloud/common": "^3.0.0",
     "@types/pumpify": "^1.4.1",
-    "google-gax": "^2.24.1",
+    "google-gax": "^2.30.1",
     "protobufjs": "^6.8.6",
     "pumpify": "^2.0.0",
     "stream-events": "^1.0.4",

protos/google/cloud/speech/v1/cloud_speech.proto

@@ -21,7 +21,6 @@ import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/cloud/speech/v1/resource.proto";
 import "google/longrunning/operations.proto";
-import "google/protobuf/any.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";

protos/google/cloud/speech/v1/resource.proto

@@ -17,8 +17,6 @@ syntax = "proto3";
 package google.cloud.speech.v1;
 
 import "google/api/resource.proto";
-import "google/protobuf/timestamp.proto";
-import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/cloud/speech/v1;speech";

protos/google/cloud/speech/v1p1beta1/cloud_speech_adaptation.proto

@@ -34,7 +34,8 @@ option objc_class_prefix = "GCS";
 // Service that implements Google Cloud Speech Adaptation API.
 service Adaptation {
   option (google.api.default_host) = "speech.googleapis.com";
-  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
 
   // Create a set of phrase hints. Each item in the set can be a single word or
   // a multi-word phrase. The items in the PhraseSet are favored by the
@@ -86,7 +87,8 @@ service Adaptation {
       post: "/v1p1beta1/{parent=projects/*/locations/*}/customClasses"
       body: "*"
     };
-    option (google.api.method_signature) = "parent,custom_class,custom_class_id";
+    option (google.api.method_signature) =
+        "parent,custom_class,custom_class_id";
   }
 
   // Get a custom class.
@@ -98,7 +100,8 @@ service Adaptation {
   }
 
   // List custom classes.
-  rpc ListCustomClasses(ListCustomClassesRequest) returns (ListCustomClassesResponse) {
+  rpc ListCustomClasses(ListCustomClassesRequest)
+      returns (ListCustomClassesResponse) {
     option (google.api.http) = {
       get: "/v1p1beta1/{parent=projects/*/locations/*}/customClasses"
     };
@@ -115,7 +118,8 @@ service Adaptation {
   }
 
   // Delete a custom class.
-  rpc DeleteCustomClass(DeleteCustomClassRequest) returns (google.protobuf.Empty) {
+  rpc DeleteCustomClass(DeleteCustomClassRequest)
+      returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1p1beta1/{name=projects/*/locations/*/customClasses/*}"
     };
@@ -125,15 +129,16 @@ service Adaptation {
 
 // Message sent by the client for the `CreatePhraseSet` method.
 message CreatePhraseSetRequest {
-  // Required. The parent resource where this phrase set will be created. Format:
+  // Required. The parent resource where this phrase set will be created.
+  // Format:
   //
   // `projects/{project}/locations/{location}/phraseSets`
   //
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -164,8 +169,8 @@ message UpdatePhraseSetRequest {
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   PhraseSet phrase_set = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The list of fields to be updated.
@@ -181,8 +186,8 @@ message GetPhraseSetRequest {
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -200,8 +205,8 @@ message ListPhraseSetRequest {
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -248,15 +253,16 @@ message DeletePhraseSetRequest {
 
 // Message sent by the client for the `CreateCustomClass` method.
 message CreateCustomClassRequest {
-  // Required. The parent resource where this custom class will be created. Format:
+  // Required. The parent resource where this custom class will be created.
+  // Format:
   //
   // `projects/{project}/locations/{location}/customClasses`
   //
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -287,8 +293,8 @@ message UpdateCustomClassRequest {
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   CustomClass custom_class = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The list of fields to be updated.
@@ -317,8 +323,8 @@ message ListCustomClassesRequest {
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -359,8 +365,8 @@ message DeleteCustomClassRequest {
   // Speech-to-Text supports three locations: `global`, `us` (US North America),
   // and `eu` (Europe). If you are calling the `speech.googleapis.com`
   // endpoint, use the `global` location. To specify a region, use a
-  // [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or
-  // `eu` location value.
+  // [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints)
+  // with matching `us` or `eu` location value.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {