google-cloud-speech-v1 0.7.3 → 0.8.0

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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!
+
+require "googleauth"
+
+module Google
+  module Cloud
+    module Speech
+      module V1
+        module Adaptation
+          # Credentials for the Adaptation API.
+          class Credentials < ::Google::Auth::Credentials
+            self.scope = [
+              "https://www.googleapis.com/auth/cloud-platform"
+            ]
+            self.env_vars = [
+              "SPEECH_CREDENTIALS",
+              "SPEECH_KEYFILE",
+              "GOOGLE_CLOUD_CREDENTIALS",
+              "GOOGLE_CLOUD_KEYFILE",
+              "GCLOUD_KEYFILE",
+              "SPEECH_CREDENTIALS_JSON",
+              "SPEECH_KEYFILE_JSON",
+              "GOOGLE_CLOUD_CREDENTIALS_JSON",
+              "GOOGLE_CLOUD_KEYFILE_JSON",
+              "GCLOUD_KEYFILE_JSON"
+            ]
+            self.paths = [
+              "~/.config/google_cloud/application_default_credentials.json"
+            ]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 Adaptation
+          # Path helper methods for the Adaptation 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 Location resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}`
+            #
+            # @param project [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def location_path project:, location:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}"
+            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/adaptation.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/speech/v1/version"
+
+require "google/cloud/speech/v1/adaptation/credentials"
+require "google/cloud/speech/v1/adaptation/paths"
+require "google/cloud/speech/v1/adaptation/client"
+
+module Google
+  module Cloud
+    module Speech
+      module V1
+        ##
+        # Service that implements Google Cloud Speech Adaptation API.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/speech/v1/adaptation"
+        #     client = ::Google::Cloud::Speech::V1::Adaptation::Client.new
+        #
+        module Adaptation
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "adaptation", "helpers.rb"
+require "google/cloud/speech/v1/adaptation/helpers" if ::File.file? helper_path

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

@@ -0,0 +1,86 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/speech/v1/cloud_speech_adaptation.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/speech/v1/resource_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/field_mask_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/speech/v1/cloud_speech_adaptation.proto", :syntax => :proto3) do
+    add_message "google.cloud.speech.v1.CreatePhraseSetRequest" do
+      optional :parent, :string, 1
+      optional :phrase_set_id, :string, 2
+      optional :phrase_set, :message, 3, "google.cloud.speech.v1.PhraseSet"
+    end
+    add_message "google.cloud.speech.v1.UpdatePhraseSetRequest" do
+      optional :phrase_set, :message, 1, "google.cloud.speech.v1.PhraseSet"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+    end
+    add_message "google.cloud.speech.v1.GetPhraseSetRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.speech.v1.ListPhraseSetRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.speech.v1.ListPhraseSetResponse" do
+      repeated :phrase_sets, :message, 1, "google.cloud.speech.v1.PhraseSet"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.cloud.speech.v1.DeletePhraseSetRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.speech.v1.CreateCustomClassRequest" do
+      optional :parent, :string, 1
+      optional :custom_class_id, :string, 2
+      optional :custom_class, :message, 3, "google.cloud.speech.v1.CustomClass"
+    end
+    add_message "google.cloud.speech.v1.UpdateCustomClassRequest" do
+      optional :custom_class, :message, 1, "google.cloud.speech.v1.CustomClass"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+    end
+    add_message "google.cloud.speech.v1.GetCustomClassRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.speech.v1.ListCustomClassesRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.speech.v1.ListCustomClassesResponse" do
+      repeated :custom_classes, :message, 1, "google.cloud.speech.v1.CustomClass"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.cloud.speech.v1.DeleteCustomClassRequest" do
+      optional :name, :string, 1
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Speech
+      module V1
+        CreatePhraseSetRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.CreatePhraseSetRequest").msgclass
+        UpdatePhraseSetRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.UpdatePhraseSetRequest").msgclass
+        GetPhraseSetRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.GetPhraseSetRequest").msgclass
+        ListPhraseSetRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.ListPhraseSetRequest").msgclass
+        ListPhraseSetResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.ListPhraseSetResponse").msgclass
+        DeletePhraseSetRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.DeletePhraseSetRequest").msgclass
+        CreateCustomClassRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.CreateCustomClassRequest").msgclass
+        UpdateCustomClassRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.UpdateCustomClassRequest").msgclass
+        GetCustomClassRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.GetCustomClassRequest").msgclass
+        ListCustomClassesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.ListCustomClassesRequest").msgclass
+        ListCustomClassesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.ListCustomClassesResponse").msgclass
+        DeleteCustomClassRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.speech.v1.DeleteCustomClassRequest").msgclass
+      end
+    end
+  end
+end

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

@@ -0,0 +1,65 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/speech/v1/cloud_speech_adaptation.proto for package 'google.cloud.speech.v1'
+# Original file comments:
+# Copyright 2022 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
+#
+#     http://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.
+#
+
+require 'grpc'
+require 'google/cloud/speech/v1/cloud_speech_adaptation_pb'
+
+module Google
+  module Cloud
+    module Speech
+      module V1
+        module Adaptation
+          # Service that implements Google Cloud Speech Adaptation API.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.speech.v1.Adaptation'
+
+            # 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
+            # recognition model when you send a call that includes the PhraseSet.
+            rpc :CreatePhraseSet, ::Google::Cloud::Speech::V1::CreatePhraseSetRequest, ::Google::Cloud::Speech::V1::PhraseSet
+            # Get a phrase set.
+            rpc :GetPhraseSet, ::Google::Cloud::Speech::V1::GetPhraseSetRequest, ::Google::Cloud::Speech::V1::PhraseSet
+            # List phrase sets.
+            rpc :ListPhraseSet, ::Google::Cloud::Speech::V1::ListPhraseSetRequest, ::Google::Cloud::Speech::V1::ListPhraseSetResponse
+            # Update a phrase set.
+            rpc :UpdatePhraseSet, ::Google::Cloud::Speech::V1::UpdatePhraseSetRequest, ::Google::Cloud::Speech::V1::PhraseSet
+            # Delete a phrase set.
+            rpc :DeletePhraseSet, ::Google::Cloud::Speech::V1::DeletePhraseSetRequest, ::Google::Protobuf::Empty
+            # Create a custom class.
+            rpc :CreateCustomClass, ::Google::Cloud::Speech::V1::CreateCustomClassRequest, ::Google::Cloud::Speech::V1::CustomClass
+            # Get a custom class.
+            rpc :GetCustomClass, ::Google::Cloud::Speech::V1::GetCustomClassRequest, ::Google::Cloud::Speech::V1::CustomClass
+            # List custom classes.
+            rpc :ListCustomClasses, ::Google::Cloud::Speech::V1::ListCustomClassesRequest, ::Google::Cloud::Speech::V1::ListCustomClassesResponse
+            # Update a custom class.
+            rpc :UpdateCustomClass, ::Google::Cloud::Speech::V1::UpdateCustomClassRequest, ::Google::Cloud::Speech::V1::CustomClass
+            # Delete a custom class.
+            rpc :DeleteCustomClass, ::Google::Cloud::Speech::V1::DeleteCustomClassRequest, ::Google::Protobuf::Empty
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Speech
       module V1
-        VERSION = "0.7.3"
+        VERSION = "0.8.0"
       end
     end
   end

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

@@ -17,6 +17,7 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/speech/v1/speech"
+require "google/cloud/speech/v1/adaptation"
 require "google/cloud/speech/v1/version"
 
 module Google

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

@@ -133,8 +133,7 @@ module Google
         #   @return [::Google::Cloud::Speech::V1::RecognitionConfig::AudioEncoding]
         #     Encoding of audio data sent in all `RecognitionAudio` messages.
         #     This field is optional for `FLAC` and `WAV` audio files and required
-        #     for all other audio formats. For details, see
-        #     {::Google::Cloud::Speech::V1::RecognitionConfig::AudioEncoding AudioEncoding}.
+        #     for all other audio formats. For details, see {::Google::Cloud::Speech::V1::RecognitionConfig::AudioEncoding AudioEncoding}.
         # @!attribute [rw] sample_rate_hertz
         #   @return [::Integer]
         #     Sample rate in Hertz of the audio data sent in all
@@ -143,8 +142,7 @@ module Google
         #     source to 16000 Hz. If that's not possible, use the native sample rate of
         #     the audio source (instead of re-sampling).
         #     This field is optional for FLAC and WAV audio files, but is
-        #     required for all other audio formats. For details, see
-        #     {::Google::Cloud::Speech::V1::RecognitionConfig::AudioEncoding AudioEncoding}.
+        #     required for all other audio formats. For details, see {::Google::Cloud::Speech::V1::RecognitionConfig::AudioEncoding AudioEncoding}.
         # @!attribute [rw] audio_channel_count
         #   @return [::Integer]
         #     The number of channels in the input audio data.
@@ -285,10 +283,6 @@ module Google
         #         <td>Best for short queries such as voice commands or voice search.</td>
         #       </tr>
         #       <tr>
-        #         <td><code>command_and_search</code></td>
-        #         <td>Best for short queries such as voice commands or voice search.</td>
-        #       </tr>
-        #       <tr>
         #         <td><code>phone_call</code></td>
         #         <td>Best for audio that originated from a phone call (typically
         #         recorded at an 8khz sampling rate).</td>
@@ -306,6 +300,16 @@ module Google
         #             For example, long-form audio. Ideally the audio is high-fidelity,
         #             recorded at a 16khz or greater sampling rate.</td>
         #       </tr>
+        #       <tr>
+        #         <td><code>medical_conversation</code></td>
+        #         <td>Best for audio that originated from a conversation between a
+        #             medical provider and patient.</td>
+        #       </tr>
+        #       <tr>
+        #         <td><code>medical_dictation</code></td>
+        #         <td>Best for audio that originated from dictation notes by a medical
+        #             provider.</td>
+        #       </tr>
         #     </table>
         # @!attribute [rw] use_enhanced
         #   @return [::Boolean]
@@ -343,8 +347,7 @@ module Google
           # an `AudioEncoding` when you send  send `FLAC` or `WAV` audio, the
           # encoding configuration must match the encoding described in the audio
           # header; otherwise the request returns an
-          # [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT] error
-          # code.
+          # [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT] error code.
           module AudioEncoding
             # Not specified.
             ENCODING_UNSPECIFIED = 0
@@ -583,8 +586,8 @@ module Google
 
         # Contains audio data in the encoding specified in the `RecognitionConfig`.
         # Either `content` or `uri` must be supplied. Supplying both or neither
-        # returns [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT].
-        # See [content limits](https://cloud.google.com/speech-to-text/quotas#content).
+        # returns [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]. See
+        # [content limits](https://cloud.google.com/speech-to-text/quotas#content).
         # @!attribute [rw] content
         #   @return [::String]
         #     The audio data bytes encoded as specified in
@@ -597,9 +600,8 @@ module Google
         #     Currently, only Google Cloud Storage URIs are
         #     supported, which must be specified in the following format:
         #     `gs://bucket_name/object_name` (other URI formats return
-        #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]).
-        #     For more information, see [Request
-        #     URIs](https://cloud.google.com/storage/docs/reference-uris).
+        #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+        #     [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
         class RecognitionAudio
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -658,8 +660,8 @@ module Google
         #     Time of the most recent processing update.
         # @!attribute [r] uri
         #   @return [::String]
-        #     Output only. The URI of the audio file being transcribed. Empty if the
-        #     audio was sent as byte content.
+        #     Output only. The URI of the audio file being transcribed. Empty if the audio was sent
+        #     as byte content.
         class LongRunningRecognizeMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -784,9 +786,9 @@ module Google
         #     For audio_channel_count = N, its output values can range from '1' to 'N'.
         # @!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.
+        #     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
@@ -810,9 +812,9 @@ module Google
         #     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.
+        #     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
@@ -822,6 +824,9 @@ module Google
         # @!attribute [rw] transcript
         #   @return [::String]
         #     Transcript text representing the words that the user spoke.
+        #     In languages that use spaces to separate words, the transcript might have a
+        #     leading space if it isn't the first result. You can concatenate each result
+        #     to obtain the full transcript without using a separator.
         # @!attribute [rw] confidence
         #   @return [::Float]
         #     The confidence estimate between 0.0 and 1.0. A higher number