feat: [speech] add transcript normalization + m4a audio format support (

#10009)

* feat: add transcript normalization + m4a audio format support

docs: clarify alternatives for deprecated fields

feat: deprecate `BatchRecognizeFileResult.uri` in favor of `cloud_storage_result.native_format_uri`

feat: deprecate `BatchRecognizeFileResult.transcript` in favor of `inline_result.transcript`
PiperOrigin-RevId: 577926708

Source-Link: googleapis/googleapis@37e816b

Source-Link: https://github.com/googleapis/googleapis-gen/commit/e12bd7bdbbb9d2e418a922075d23f77a8c1e7485
Copy-Tag: eyJwIjoiamF2YS1zcGVlY2gvLk93bEJvdC55YW1sIiwiaCI6ImUxMmJkN2JkYmJiOWQyZTQxOGE5MjIwNzVkMjNmNzdhOGMxZTc0ODUifQ==

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

java-speech/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.23.0</version>
+      <version>26.26.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -231,7 +231,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-speech.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-speech/4.19.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-speech/4.24.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-speech/google-cloud-speech/src/main/resources/META-INF/native-image/com.google.cloud.speech.v2/reflect-config.json

@@ -602,6 +602,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.cloud.speech.v2.CloudStorageResult",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.cloud.speech.v2.CloudStorageResult$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.cloud.speech.v2.Config",
     "queryAllDeclaredConstructors": true,
@@ -908,6 +926,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.cloud.speech.v2.InlineResult",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.cloud.speech.v2.InlineResult$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.cloud.speech.v2.ListCustomClassesRequest",
     "queryAllDeclaredConstructors": true,
@@ -1430,6 +1466,42 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.cloud.speech.v2.TranscriptNormalization",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.cloud.speech.v2.TranscriptNormalization$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.cloud.speech.v2.TranscriptNormalization$Entry",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.cloud.speech.v2.TranscriptNormalization$Entry$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.cloud.speech.v2.UndeleteCustomClassRequest",
     "queryAllDeclaredConstructors": true,

java-speech/proto-google-cloud-speech-v2/src/main/java/com/google/cloud/speech/v2/AutoDetectDecodingConfig.java

@@ -42,6 +42,8 @@
  * * OGG_OPUS: Opus audio frames in an Ogg container.
  *
  * * WEBM_OPUS: Opus audio frames in a WebM container.
+ *
+ * * M4A: M4A audio format.
  * </pre>
  *
  * Protobuf type {@code google.cloud.speech.v2.AutoDetectDecodingConfig}
@@ -253,6 +255,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    * * OGG_OPUS: Opus audio frames in an Ogg container.
    *
    * * WEBM_OPUS: Opus audio frames in a WebM container.
+   *
+   * * M4A: M4A audio format.
    * </pre>
    *
    * Protobuf type {@code google.cloud.speech.v2.AutoDetectDecodingConfig}