feat: expose google.cloud.location.Locations API (#6243)

* feat: expose google.cloud.location.Locations API
feat: add new fields to CustomClass and PhraseSet.Phrase messages
feat: add ALAW support to RecognitionConfig
feat: make transcript_normalization field optional
feat: deprecating speaker_tag (int) for speaker_label (string)
docs: miscellaneous clarifications

PiperOrigin-RevId: 743615436

Source-Link: googleapis/googleapis@3891337

Source-Link: googleapis/googleapis-gen@a36bdfd
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXNwZWVjaC8uT3dsQm90LnlhbWwiLCJoIjoiYTM2YmRmZGNjZTFiMTZkNGU3ZTc4OWJhNTkyYzM3MzA0ZGFhMTZjMCJ9

* 🦉 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>

Author: gcf-owl-bot[bot]

packages/google-cloud-speech/protos/google/cloud/speech/v1p1beta1/cloud_speech.proto

@@ -26,7 +26,6 @@ import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
 import "google/rpc/status.proto";
 
-option cc_enable_arenas = true;
 option go_package = "cloud.google.com/go/speech/apiv1p1beta1/speechpb;speechpb";
 option java_multiple_files = true;
 option java_outer_classname = "SpeechProto";
@@ -163,8 +162,9 @@ message StreamingRecognitionConfig {
   // `true`.
   //
   // The `single_utterance` field can only be used with specified models,
-  // otherwise an error is thrown. The `model` field in [`RecognitionConfig`][]
-  // must be set to:
+  // otherwise an error is thrown. The `model` field in
+  // [RecognitionConfig][google.cloud.speech.v1p1beta1.RecognitionConfig] must
+  // be set to:
   //
   // * `command_and_search`
   // * `phone_call` AND additional field `useEnhanced`=`true`
@@ -267,9 +267,12 @@ message RecognitionConfig {
     MP3 = 8;
 
     // Opus encoded audio frames in WebM container
-    // ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be
-    // one of 8000, 12000, 16000, 24000, or 48000.
+    // ([WebM](https://www.webmproject.org/docs/container/)).
+    // `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.
     WEBM_OPUS = 9;
+
+    // 8-bit samples that compand 13-bit audio samples using G.711 PCMU/a-law.
+    ALAW = 10;
   }
 
   // Encoding of audio data sent in all `RecognitionAudio` messages.
@@ -349,11 +352,12 @@ message RecognitionConfig {
   // When speech adaptation is set it supersedes the `speech_contexts` field.
   SpeechAdaptation adaptation = 20;
 
-  // Use transcription normalization to automatically replace parts of the
-  // transcript with phrases of your choosing. For StreamingRecognize, this
+  // Optional. Use transcription normalization to automatically replace parts of
+  // the transcript with phrases of your choosing. For StreamingRecognize, this
   // normalization only applies to stable partial transcripts (stability > 0.8)
   // and final transcripts.
-  TranscriptNormalization transcript_normalization = 24;
+  TranscriptNormalization transcript_normalization = 24
+      [(google.api.field_behavior) = OPTIONAL];
 
   // Array of [SpeechContext][google.cloud.speech.v1p1beta1.SpeechContext].
   // A means to provide context to assist the speech recognition. For more
@@ -396,8 +400,8 @@ message RecognitionConfig {
   google.protobuf.BoolValue enable_spoken_emojis = 23;
 
   // If 'true', enables speaker detection for each recognized word in
-  // the top alternative of the recognition result using a speaker_tag provided
-  // in the WordInfo.
+  // the top alternative of the recognition result using a speaker_label
+  // provided in the WordInfo.
   // Note: Use diarization_config instead.
   bool enable_speaker_diarization = 16 [deprecated = true];
 
@@ -486,8 +490,8 @@ message RecognitionConfig {
 // Config to enable speaker diarization.
 message SpeakerDiarizationConfig {
   // If 'true', enables speaker detection for each recognized word in
-  // the top alternative of the recognition result using a speaker_tag provided
-  // in the WordInfo.
+  // the top alternative of the recognition result using a speaker_label
+  // provided in the WordInfo.
   bool enable_speaker_diarization = 1;
 
   // Minimum number of speakers in the conversation. This range gives you more
@@ -708,6 +712,10 @@ message RecognizeResponse {
   // The ID associated with the request. This is a unique ID specific only to
   // the given request.
   int64 request_id = 8;
+
+  // Whether request used legacy asr models (was not automatically migrated to
+  // use conformer models).
+  bool using_legacy_models = 9;
 }
 
 // The only message returned to the client by the `LongRunningRecognize` method.
@@ -988,9 +996,19 @@ message WordInfo {
   // Output only. A distinct integer value is assigned for every speaker within
   // the audio. This field specifies which one of those speakers was detected to
   // have spoken this word. Value ranges from '1' to diarization_speaker_count.
-  // speaker_tag is set if enable_speaker_diarization = 'true' and only in the
+  // speaker_tag is set if enable_speaker_diarization = 'true' and only for the
   // top alternative.
-  int32 speaker_tag = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Note: Use speaker_label instead.
+  int32 speaker_tag = 5
+      [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A label value assigned for every unique speaker within the
+  // audio. This field specifies which speaker was detected to have spoken this
+  // word. For some models, like medical_conversation this can be actual speaker
+  // role, for example "patient" or "provider", but generally this would be a
+  // number identifying a speaker. This field is only set if
+  // enable_speaker_diarization = 'true' and only for the top alternative.
+  string speaker_label = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Information on speech adaptation use in results

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

@@ -24,7 +24,6 @@ import "google/cloud/speech/v1p1beta1/resource.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 
-option cc_enable_arenas = true;
 option go_package = "cloud.google.com/go/speech/apiv1p1beta1/speechpb;speechpb";
 option java_multiple_files = true;
 option java_outer_classname = "SpeechAdaptationProto";

packages/google-cloud-speech/protos/google/cloud/speech/v1p1beta1/resource.proto

@@ -16,14 +16,23 @@ syntax = "proto3";
 
 package google.cloud.speech.v1p1beta1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
 
-option cc_enable_arenas = true;
 option go_package = "cloud.google.com/go/speech/apiv1p1beta1/speechpb;speechpb";
 option java_multiple_files = true;
 option java_outer_classname = "SpeechResourceProto";
 option java_package = "com.google.cloud.speech.v1p1beta1";
 option objc_class_prefix = "GCS";
+option (google.api.resource_definition) = {
+  type: "cloudkms.googleapis.com/CryptoKey"
+  pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}"
+};
+option (google.api.resource_definition) = {
+  type: "cloudkms.googleapis.com/CryptoKeyVersion"
+  pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}"
+};
 
 // A set of words or phrases that represents a common concept likely to appear
 // in your audio, for example a list of passenger ship names. CustomClass items
@@ -40,6 +49,19 @@ message CustomClass {
     string value = 1;
   }
 
+  // Set of states that define the lifecycle of a CustomClass.
+  enum State {
+    // Unspecified state.  This is only used/useful for distinguishing
+    // unset values.
+    STATE_UNSPECIFIED = 0;
+
+    // The normal and active state.
+    ACTIVE = 2;
+
+    // This CustomClass has been deleted.
+    DELETED = 4;
+  }
+
   // The resource name of the custom class.
   string name = 1;
 
@@ -49,6 +71,67 @@ message CustomClass {
 
   // A collection of class items.
   repeated ClassItem items = 3;
+
+  // Output only. The [KMS key
+  // name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which
+  // the content of the ClassItem is encrypted. The expected format is
+  // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+  string kms_key_name = 6 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
+
+  // Output only. The [KMS key version
+  // name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions)
+  // with which content of the ClassItem is encrypted. The expected format is
+  // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.
+  string kms_key_version_name = 7 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
+
+  // Output only. System-assigned unique identifier for the CustomClass.
+  // This field is not used.
+  string uid = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. User-settable, human-readable name for the CustomClass. Must
+  // be 63 characters or less. This field is not used.
+  string display_name = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The CustomClass lifecycle state.
+  // This field is not used.
+  State state = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time at which this resource was requested for deletion.
+  // This field is not used.
+  google.protobuf.Timestamp delete_time = 11
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time at which this resource will be purged.
+  // This field is not used.
+  google.protobuf.Timestamp expire_time = 12
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Allows users to store small amounts of arbitrary data.
+  // Both the key and the value must be 63 characters or less each.
+  // At most 100 annotations.
+  // This field is not used.
+  map<string, string> annotations = 13
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. This checksum is computed by the server based on the value of
+  // other fields. This may be sent on update, undelete, and delete requests to
+  // ensure the client has an up-to-date value before proceeding. This field is
+  // not used.
+  string etag = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Whether or not this CustomClass is in the process of being
+  // updated. This field is not used.
+  bool reconciling = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Provides "hints" to the speech recognizer to favor specific words and phrases
@@ -100,6 +183,19 @@ message PhraseSet {
     float boost = 2;
   }
 
+  // Set of states that define the lifecycle of a CustomClass.
+  enum State {
+    // Unspecified state.  This is only used/useful for distinguishing
+    // unset values.
+    STATE_UNSPECIFIED = 0;
+
+    // The normal and active state.
+    ACTIVE = 2;
+
+    // This CustomClass has been deleted.
+    DELETED = 4;
+  }
+
   // The resource name of the phrase set.
   string name = 1;
 
@@ -116,6 +212,67 @@ message PhraseSet {
   // approach to finding the optimal value for your use case as well as adding
   // phrases both with and without boost to your requests.
   float boost = 4;
+
+  // Output only. The [KMS key
+  // name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which
+  // the content of the PhraseSet is encrypted. The expected format is
+  // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+  string kms_key_name = 7 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
+
+  // Output only. The [KMS key version
+  // name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions)
+  // with which content of the PhraseSet is encrypted. The expected format is
+  // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.
+  string kms_key_version_name = 8 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
+
+  // Output only. System-assigned unique identifier for the PhraseSet.
+  // This field is not used.
+  string uid = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. User-settable, human-readable name for the PhraseSet. Must be
+  // 63 characters or less. This field is not used.
+  string display_name = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The CustomClass lifecycle state.
+  // This field is not used.
+  State state = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time at which this resource was requested for deletion.
+  // This field is not used.
+  google.protobuf.Timestamp delete_time = 12
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time at which this resource will be purged.
+  // This field is not used.
+  google.protobuf.Timestamp expire_time = 13
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Allows users to store small amounts of arbitrary data.
+  // Both the key and the value must be 63 characters or less each.
+  // At most 100 annotations.
+  // This field is not used.
+  map<string, string> annotations = 14
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. This checksum is computed by the server based on the value of
+  // other fields. This may be sent on update, undelete, and delete requests to
+  // ensure the client has an up-to-date value before proceeding. This field is
+  // not used.
+  string etag = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Whether or not this PhraseSet is in the process of being
+  // updated. This field is not used.
+  bool reconciling = 16 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Speech adaptation configuration.