google-cloud-speech-v1 0.6.1 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 379e92e549103dc1380fa9575fc75eedcf5f5fa30b91337ad0bea4da5776a69f
-  data.tar.gz: 8013de3bba51af43d6bccbc4cc2c83020774cefbac956fcd0836685071d2ba2e
+  metadata.gz: f4dc617ef8f2e3cbb8318ac386f238df5b5bf25808dfabfeb07cdbd441694d96
+  data.tar.gz: '051599f719634071202ee7362e2bf6fd79e201cefb4602f5df966375bf29243c'
 SHA512:
-  metadata.gz: 568ce91f8be48d7659f8bde1037ab2f598fea9d7f079e9d4424ebbdddb77dc334b26ef5f36cadbd249592b96fa3b3de0b429f35fc8ad8c1a169cda892864e2ad
-  data.tar.gz: e0258c9d483b3c4ea234c098ce216765548da66ee7154393864bee9119df0bd6633492b81f74dc895451ccf12aa1e10c16197a5879b55396daa40476e0489c80
+  metadata.gz: 6d69d7844bdd65019be76c5155c04099dc76f47c715f73d944eeb332e1a3dd3e5e89c198799f2a3893375ef83c57e1feed325307a2e36c9565911c746fdd6beb
+  data.tar.gz: f78d1af67fbe0a5579ba516605e5e58d2f10c665b36a34599682330a9a2bc5fdb2627fd26a8dd12e8f17a5026339e3925730efb866a76fb857abb7a5964b586b

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title=Cloud Speech-to-Text V1 API
+--title="Cloud Speech-to-Text V1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/AUTHENTICATION.md

@@ -120,15 +120,6 @@ To configure your system for this, simply:
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
 *should* only be used during development.
 
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
 ## Creating a Service Account
 
 Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
 [Google Cloud Platform environments](#google-cloud-platform-environments), you
 need a Google Developers service account.
 
-1. Visit the [Google Developers Console][dev-console].
+1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
 2. Create a new project or click on an existing project.
-3. Activate the slide-out navigation tray and select **API Manager**. From
+3. Activate the menu in the upper left and select **APIs & Services**. From
    here, you will enable the APIs that your application requires.
 
-   ![Enable the APIs that your application requires][enable-apis]
-
    *Note: You may need to enable billing in order to use these services.*
 
 4. Select **Credentials** from the side navigation.
 
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
+   Find the "Create credentials" drop down near the top of the page, and select
+   "Service account" to be guided through downloading a new JSON key file.
 
    If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
+   new key file. Just select the account you wish to re-use, click the pencil
+   tool on the right side to edit the service account, select the **Keys** tab,
+   and then select **Add Key**.
 
    The key file you download will be used by this library to authenticate API
    requests and should be stored in a secure location.

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::Speech::V1::RecognizeRequest.new # (request fields as
 response = client.recognize request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-speech-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-speech-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/speech-to-text)

data/lib/google/cloud/speech/v1/cloud_speech_pb.rb

@@ -4,8 +4,8 @@
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
+require 'google/cloud/speech/v1/resource_pb'
 require 'google/longrunning/operations_pb'
-require 'google/protobuf/any_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/protobuf/wrappers_pb'
@@ -45,11 +45,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :audio_channel_count, :int32, 7
       optional :enable_separate_recognition_per_channel, :bool, 12
       optional :language_code, :string, 3
+      repeated :alternative_language_codes, :string, 18
       optional :max_alternatives, :int32, 4
       optional :profanity_filter, :bool, 5
+      optional :adaptation, :message, 20, "google.cloud.speech.v1.SpeechAdaptation"
       repeated :speech_contexts, :message, 6, "google.cloud.speech.v1.SpeechContext"
       optional :enable_word_time_offsets, :bool, 8
+      optional :enable_word_confidence, :bool, 15
       optional :enable_automatic_punctuation, :bool, 11
+      optional :enable_spoken_punctuation, :message, 22, "google.protobuf.BoolValue"
+      optional :enable_spoken_emojis, :message, 23, "google.protobuf.BoolValue"
       optional :diarization_config, :message, 19, "google.cloud.speech.v1.SpeakerDiarizationConfig"
       optional :metadata, :message, 9, "google.cloud.speech.v1.RecognitionMetadata"
       optional :model, :string, 13
@@ -64,6 +69,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :AMR_WB, 5
       value :OGG_OPUS, 6
       value :SPEEX_WITH_HEADER_BYTE, 7
+      value :WEBM_OPUS, 9
     end
     add_message "google.cloud.speech.v1.SpeakerDiarizationConfig" do
       optional :enable_speaker_diarization, :bool, 1
@@ -114,6 +120,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.speech.v1.SpeechContext" do
       repeated :phrases, :string, 1
+      optional :boost, :float, 4
     end
     add_message "google.cloud.speech.v1.RecognitionAudio" do
       oneof :audio_source do
@@ -128,6 +135,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.speech.v1.LongRunningRecognizeResponse" do
       repeated :results, :message, 2, "google.cloud.speech.v1.SpeechRecognitionResult"
       optional :total_billed_time, :message, 3, "google.protobuf.Duration"
+      optional :output_config, :message, 6, "google.cloud.speech.v1.TranscriptOutputConfig"
+      optional :output_error, :message, 7, "google.rpc.Status"
     end
     add_message "google.cloud.speech.v1.LongRunningRecognizeMetadata" do
       optional :progress_percent, :int32, 1
@@ -156,6 +165,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.speech.v1.SpeechRecognitionResult" do
       repeated :alternatives, :message, 1, "google.cloud.speech.v1.SpeechRecognitionAlternative"
       optional :channel_tag, :int32, 2
+      optional :result_end_time, :message, 4, "google.protobuf.Duration"
+      optional :language_code, :string, 5
     end
     add_message "google.cloud.speech.v1.SpeechRecognitionAlternative" do
       optional :transcript, :string, 1
@@ -166,6 +177,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :start_time, :message, 1, "google.protobuf.Duration"
       optional :end_time, :message, 2, "google.protobuf.Duration"
       optional :word, :string, 3
+      optional :confidence, :float, 4
       optional :speaker_tag, :int32, 5
     end
   end

data/lib/google/cloud/speech/v1/resource_pb.rb

@@ -0,0 +1,46 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/speech/v1/resource.proto
+
+require 'google/api/resource_pb'
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/speech/v1/resource.proto", :syntax => :proto3) do
+    add_message "google.cloud.speech.v1.CustomClass" do
+      optional :name, :string, 1
+      optional :custom_class_id, :string, 2
+      repeated :items, :message, 3, "google.cloud.speech.v1.CustomClass.ClassItem"
+    end
+    add_message "google.cloud.speech.v1.CustomClass.ClassItem" do
+      optional :value, :string, 1
+    end
+    add_message "google.cloud.speech.v1.PhraseSet" do
+      optional :name, :string, 1
+      repeated :phrases, :message, 2, "google.cloud.speech.v1.PhraseSet.Phrase"
+      optional :boost, :float, 4
+    end
+    add_message "google.cloud.speech.v1.PhraseSet.Phrase" do
+      optional :value, :string, 1
+      optional :boost, :float, 2
+    end
+    add_message "google.cloud.speech.v1.SpeechAdaptation" do
+      repeated :phrase_sets, :message, 1, "google.cloud.speech.v1.PhraseSet"
+      repeated :phrase_set_references, :string, 2
+      repeated :custom_classes, :message, 3, "google.cloud.speech.v1.CustomClass"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Speech
+      module V1
+        CustomClass = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.CustomClass").msgclass
+        CustomClass::ClassItem = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.CustomClass.ClassItem").msgclass
+        PhraseSet = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.PhraseSet").msgclass
+        PhraseSet::Phrase = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.PhraseSet.Phrase").msgclass
+        SpeechAdaptation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.SpeechAdaptation").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/speech/v1/speech/client.rb

@@ -30,6 +30,8 @@ module Google
           # Service that implements Google Cloud Speech API.
           #
           class Client
+            include Paths
+
             # @private
             attr_reader :speech_stub
 
@@ -145,6 +147,7 @@ module Google
 
               @operations_client = Operations.new do |config|
                 config.credentials = credentials
+                config.quota_project = @quota_project_id
                 config.endpoint = @config.endpoint
               end
 

data/lib/google/cloud/speech/v1/speech/paths.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Speech
+      module V1
+        module Speech
+          # Path helper methods for the Speech API.
+          module Paths
+            ##
+            # Create a fully-qualified CustomClass resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/customClasses/{custom_class}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param custom_class [String]
+            #
+            # @return [::String]
+            def custom_class_path project:, location:, custom_class:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/customClasses/#{custom_class}"
+            end
+
+            ##
+            # Create a fully-qualified PhraseSet resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param phrase_set [String]
+            #
+            # @return [::String]
+            def phrase_set_path project:, location:, phrase_set:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/phraseSets/#{phrase_set}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/speech/v1/speech.rb

@@ -23,6 +23,7 @@ require "gapic/config/method"
 require "google/cloud/speech/v1/version"
 
 require "google/cloud/speech/v1/speech/credentials"
+require "google/cloud/speech/v1/speech/paths"
 require "google/cloud/speech/v1/speech/operations"
 require "google/cloud/speech/v1/speech/client"
 

data/lib/google/cloud/speech/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Speech
       module V1
-        VERSION = "0.6.1"
+        VERSION = "0.7.2"
       end
     end
   end

data/lib/google/cloud/speech/v1.rb

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/speech/v1"
       #     client = ::Google::Cloud::Speech::V1::Speech::Client.new
       #

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of

data/proto_docs/google/cloud/speech/v1/cloud_speech.rb

@@ -170,6 +170,20 @@ module Google
         #     See [Language
         #     Support](https://cloud.google.com/speech-to-text/docs/languages) for a list
         #     of the currently supported language codes.
+        # @!attribute [rw] alternative_language_codes
+        #   @return [::Array<::String>]
+        #     A list of up to 3 additional
+        #     [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags,
+        #     listing possible alternative languages of the supplied audio.
+        #     See [Language
+        #     Support](https://cloud.google.com/speech-to-text/docs/languages) for a list
+        #     of the currently supported language codes. If alternative languages are
+        #     listed, recognition result will contain recognition in the most likely
+        #     language detected including the main language_code. The recognition result
+        #     will include the language tag of the language detected in the audio. Note:
+        #     This feature is only supported for Voice Command and Voice Search use cases
+        #     and performance may vary for other use cases (e.g., phone call
+        #     transcription).
         # @!attribute [rw] max_alternatives
         #   @return [::Integer]
         #     Maximum number of recognition hypotheses to be returned.
@@ -184,6 +198,13 @@ module Google
         #     profanities, replacing all but the initial character in each filtered word
         #     with asterisks, e.g. "f***". If set to `false` or omitted, profanities
         #     won't be filtered out.
+        # @!attribute [rw] adaptation
+        #   @return [::Google::Cloud::Speech::V1::SpeechAdaptation]
+        #     Speech adaptation configuration improves the accuracy of speech
+        #     recognition. For more information, see the [speech
+        #     adaptation](https://cloud.google.com/speech-to-text/docs/adaptation)
+        #     documentation.
+        #     When speech adaptation is set it supersedes the `speech_contexts` field.
         # @!attribute [rw] speech_contexts
         #   @return [::Array<::Google::Cloud::Speech::V1::SpeechContext>]
         #     Array of {::Google::Cloud::Speech::V1::SpeechContext SpeechContext}.
@@ -197,12 +218,33 @@ module Google
         #     the start and end time offsets (timestamps) for those words. If
         #     `false`, no word-level time offset information is returned. The default is
         #     `false`.
+        # @!attribute [rw] enable_word_confidence
+        #   @return [::Boolean]
+        #     If `true`, the top result includes a list of words and the
+        #     confidence for those words. If `false`, no word-level confidence
+        #     information is returned. The default is `false`.
         # @!attribute [rw] enable_automatic_punctuation
         #   @return [::Boolean]
         #     If 'true', adds punctuation to recognition result hypotheses.
         #     This feature is only available in select languages. Setting this for
         #     requests in other languages has no effect at all.
         #     The default 'false' value does not add punctuation to result hypotheses.
+        # @!attribute [rw] enable_spoken_punctuation
+        #   @return [::Google::Protobuf::BoolValue]
+        #     The spoken punctuation behavior for the call
+        #     If not set, uses default behavior based on model of choice
+        #     e.g. command_and_search will enable spoken punctuation by default
+        #     If 'true', replaces spoken punctuation with the corresponding symbols in
+        #     the request. For example, "how are you question mark" becomes "how are
+        #     you?". See https://cloud.google.com/speech-to-text/docs/spoken-punctuation
+        #     for support. If 'false', spoken punctuation is not replaced.
+        # @!attribute [rw] enable_spoken_emojis
+        #   @return [::Google::Protobuf::BoolValue]
+        #     The spoken emoji behavior for the call
+        #     If not set, uses default behavior based on model of choice
+        #     If 'true', adds spoken emoji formatting for the request. This will replace
+        #     spoken emojis with the corresponding Unicode symbols in the final
+        #     transcript. If 'false', spoken emojis are not replaced.
         # @!attribute [rw] diarization_config
         #   @return [::Google::Cloud::Speech::V1::SpeakerDiarizationConfig]
         #     Config to enable speaker diarization and set additional
@@ -274,7 +316,8 @@ module Google
           # a lossless encoding (`FLAC` or `LINEAR16`). The accuracy of the speech
           # recognition can be reduced if lossy codecs are used to capture or transmit
           # audio, particularly if background noise is present. Lossy codecs include
-          # `MULAW`, `AMR`, `AMR_WB`, `OGG_OPUS`, `SPEEX_WITH_HEADER_BYTE`, `MP3`.
+          # `MULAW`, `AMR`, `AMR_WB`, `OGG_OPUS`, `SPEEX_WITH_HEADER_BYTE`, `MP3`,
+          # and `WEBM_OPUS`.
           #
           # The `FLAC` and `WAV` audio file formats include a header that describes the
           # included audio content. You can request recognition for `WAV` files that
@@ -329,6 +372,11 @@ module Google
             # is replaced with a single byte containing the block length. Only Speex
             # wideband is supported. `sample_rate_hertz` must be 16000.
             SPEEX_WITH_HEADER_BYTE = 7
+
+            # 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_OPUS = 9
           end
         end
 
@@ -502,6 +550,16 @@ module Google
         #     providing phrase hints for every month of the year, using the $MONTH class
         #     improves the likelihood of correctly transcribing audio that includes
         #     months.
+        # @!attribute [rw] boost
+        #   @return [::Float]
+        #     Hint Boost. Positive value will increase the probability that a specific
+        #     phrase will be recognized over other similar sounding phrases. The higher
+        #     the boost, the higher the chance of false positive recognition as well.
+        #     Negative boost values would correspond to anti-biasing. Anti-biasing is not
+        #     enabled, so negative boost will simply be ignored. Though `boost` can
+        #     accept a wide range of positive values, most use cases are best served with
+        #     values between 0 and 20. We recommend using a binary search approach to
+        #     finding the optimal value for your use case.
         class SpeechContext
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -557,6 +615,12 @@ module Google
         # @!attribute [rw] total_billed_time
         #   @return [::Google::Protobuf::Duration]
         #     When available, billed audio seconds for the corresponding request.
+        # @!attribute [rw] output_config
+        #   @return [::Google::Cloud::Speech::V1::TranscriptOutputConfig]
+        #     Original output config if present in the request.
+        # @!attribute [rw] output_error
+        #   @return [::Google::Rpc::Status]
+        #     If the transcript output fails this field contains the relevant error.
         class LongRunningRecognizeResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -703,9 +767,9 @@ module Google
         #     For audio_channel_count = N, its output values can range from '1' to 'N'.
         # @!attribute [r] language_code
         #   @return [::String]
-        #     The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of
-        #     the language in this result. This language code was detected to have the
-        #     most likelihood of being spoken in the audio.
+        #     Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag
+        #     of the language in this result. This language code was detected to have
+        #     the most likelihood of being spoken in the audio.
         class StreamingRecognitionResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -723,6 +787,15 @@ module Google
         #     For multi-channel audio, this is the channel number corresponding to the
         #     recognized result for the audio from that channel.
         #     For audio_channel_count = N, its output values can range from '1' to 'N'.
+        # @!attribute [rw] result_end_time
+        #   @return [::Google::Protobuf::Duration]
+        #     Time offset of the end of this result relative to the
+        #     beginning of the audio.
+        # @!attribute [r] language_code
+        #   @return [::String]
+        #     Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag
+        #     of the language in this result. This language code was detected to have
+        #     the most likelihood of being spoken in the audio.
         class SpeechRecognitionResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -771,6 +844,15 @@ module Google
         # @!attribute [rw] word
         #   @return [::String]
         #     The word corresponding to this set of information.
+        # @!attribute [rw] confidence
+        #   @return [::Float]
+        #     The confidence estimate between 0.0 and 1.0. A higher number
+        #     indicates an estimated greater likelihood that the recognized words are
+        #     correct. This field is set only for the top alternative of a non-streaming
+        #     result or, of a streaming result where `is_final=true`.
+        #     This field is not guaranteed to be accurate and users should not rely on it
+        #     to be always provided.
+        #     The default of 0.0 is a sentinel value indicating `confidence` was not set.
         # @!attribute [r] speaker_tag
         #   @return [::Integer]
         #     Output only. A distinct integer value is assigned for every speaker within

data/proto_docs/google/cloud/speech/v1/resource.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Speech
+      module V1
+        # 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
+        # can be substituted into placeholders that you set in PhraseSet phrases.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The resource name of the custom class.
+        # @!attribute [rw] custom_class_id
+        #   @return [::String]
+        #     If this custom class is a resource, the custom_class_id is the resource id
+        #     of the CustomClass. Case sensitive.
+        # @!attribute [rw] items
+        #   @return [::Array<::Google::Cloud::Speech::V1::CustomClass::ClassItem>]
+        #     A collection of class items.
+        class CustomClass
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # An item of the class.
+          # @!attribute [rw] value
+          #   @return [::String]
+          #     The class item's value.
+          class ClassItem
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Provides "hints" to the speech recognizer to favor specific words and phrases
+        # in the results.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The resource name of the phrase set.
+        # @!attribute [rw] phrases
+        #   @return [::Array<::Google::Cloud::Speech::V1::PhraseSet::Phrase>]
+        #     A list of word and phrases.
+        # @!attribute [rw] boost
+        #   @return [::Float]
+        #     Hint Boost. Positive value will increase the probability that a specific
+        #     phrase will be recognized over other similar sounding phrases. The higher
+        #     the boost, the higher the chance of false positive recognition as well.
+        #     Negative boost values would correspond to anti-biasing. Anti-biasing is not
+        #     enabled, so negative boost will simply be ignored. Though `boost` can
+        #     accept a wide range of positive values, most use cases are best served with
+        #     values between 0 (exclusive) and 20. We recommend using a binary search
+        #     approach to finding the optimal value for your use case. Speech recognition
+        #     will skip PhraseSets with a boost value of 0.
+        class PhraseSet
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A phrases containing words and phrase "hints" so that
+          # the speech recognition is more likely to recognize them. This can be used
+          # to improve the accuracy for specific words and phrases, for example, if
+          # specific commands are typically spoken by the user. This can also be used
+          # to add additional words to the vocabulary of the recognizer. See
+          # [usage limits](https://cloud.google.com/speech-to-text/quotas#content).
+          #
+          # List items can also include pre-built or custom classes containing groups
+          # of words that represent common concepts that occur in natural language. For
+          # example, rather than providing a phrase hint for every month of the
+          # year (e.g. "i was born in january", "i was born in febuary", ...), use the
+          # pre-built `$MONTH` class improves the likelihood of correctly transcribing
+          # audio that includes months (e.g. "i was born in $month").
+          # To refer to pre-built classes, use the class' symbol prepended with `$`
+          # e.g. `$MONTH`. To refer to custom classes that were defined inline in the
+          # request, set the class's `custom_class_id` to a string unique to all class
+          # resources and inline classes. Then use the class' id wrapped in $`{...}`
+          # e.g. "$\\{my-months}". To refer to custom classes resources, use the class'
+          # id wrapped in `${}` (e.g. `${my-months}`).
+          #
+          # 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.
+          # @!attribute [rw] value
+          #   @return [::String]
+          #     The phrase itself.
+          # @!attribute [rw] boost
+          #   @return [::Float]
+          #     Hint Boost. Overrides the boost set at the phrase set level.
+          #     Positive value will increase the probability that a specific phrase will
+          #     be recognized over other similar sounding phrases. The higher the boost,
+          #     the higher the chance of false positive recognition as well. Negative
+          #     boost will simply be ignored. Though `boost` can accept a wide range of
+          #     positive values, most use cases are best served
+          #     with values between 0 and 20. We recommend using a binary search approach
+          #     to finding the optimal value for your use case. Speech recognition
+          #     will skip PhraseSets with a boost value of 0.
+          class Phrase
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Speech adaptation configuration.
+        # @!attribute [rw] phrase_sets
+        #   @return [::Array<::Google::Cloud::Speech::V1::PhraseSet>]
+        #     A collection of phrase sets. To specify the hints inline, leave the
+        #     phrase set's `name` blank and fill in the rest of its fields. Any
+        #     phrase set can use any custom class.
+        # @!attribute [rw] phrase_set_references
+        #   @return [::Array<::String>]
+        #     A collection of phrase set resource names to use.
+        # @!attribute [rw] custom_classes
+        #   @return [::Array<::Google::Cloud::Speech::V1::CustomClass>]
+        #     A collection of custom classes. To specify the classes inline, leave the
+        #     class' `name` blank and fill in the rest of its fields, giving it a unique
+        #     `custom_class_id`. Refer to the inline defined class in phrase hints by its
+        #     `custom_class_id`.
+        class SpeechAdaptation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-speech-v1
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.2
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2022-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -177,15 +177,18 @@ files:
 - lib/google/cloud/speech/v1.rb
 - lib/google/cloud/speech/v1/cloud_speech_pb.rb
 - lib/google/cloud/speech/v1/cloud_speech_services_pb.rb
+- lib/google/cloud/speech/v1/resource_pb.rb
 - lib/google/cloud/speech/v1/speech.rb
 - lib/google/cloud/speech/v1/speech/client.rb
 - lib/google/cloud/speech/v1/speech/credentials.rb
 - lib/google/cloud/speech/v1/speech/operations.rb
+- lib/google/cloud/speech/v1/speech/paths.rb
 - lib/google/cloud/speech/v1/version.rb
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/cloud/speech/v1/cloud_speech.rb
+- proto_docs/google/cloud/speech/v1/resource.rb
 - proto_docs/google/longrunning/operations.rb
 - proto_docs/google/protobuf/any.rb
 - proto_docs/google/protobuf/duration.rb
@@ -212,7 +215,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Speech-to-Text V1 API