google-cloud-speech 0.30.0 → 0.30.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 763195f0925921b082ea312d0287d4ca43e57bcdba2348379b2a47df410be135
-  data.tar.gz: 30d926a0eecbe5a1a6aa70391d4b83db808425c96e69290171e1c1080ae6b533
+  metadata.gz: 8972d84300ec92b1d15550149a9ef0e6a5c22dbea4fc7f5acd5671cb46423c0b
+  data.tar.gz: 4626226bd0faaa8f814db8e2bf85ac4d2a2990a28c9fda0f38077f3b5e128e28
 SHA512:
-  metadata.gz: 7c32bacca6be56b87b96176b1b6dd9afde7910e5958ab7c264206cd34224889ceb6a2b708566eb1b409ef7c17b5a2f7ee23dac6b9d7f56db40ffc92db83a5ecc
-  data.tar.gz: 36157d4b83b244f712dfcecbab3a3ce13d7522e7175736c6b50c6234e2e8922d7569f521e71496a054544fcd8bbc0c9686059ba0086b0ab0576bab4a6da6b231
+  metadata.gz: 5e95686eaf7e849eceeff434d087733015e565cdf19d1ee7bfafc721549b648f6b0edd03544c5851a7c1760fe63926c8a2a73d4bbc977270d1ba849129a20db7
+  data.tar.gz: 3ef81a3b9e99bd463d3afb0902830ca083a6b7916fe70bd50d630e1fbee419ad10d3aaf588982d39fcba90227126941fefe2a184b969da8c33370d24cba060e8

data/.yardopts

@@ -1,7 +1,8 @@
 --no-private
---title=Cloud Speech API
+--title=Google Cloud Speech API
 --exclude _pb\.rb$
 --markup markdown
+--markup-provider redcarpet
 
 ./lib/**/*.rb
 -

data/README.md

@@ -1,7 +1,7 @@
-# Ruby Client for Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+# Ruby Client for Google Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
 
-[Cloud Speech API][Product Documentation]:
-Converts audio to text by applying powerful neural network models.
+[Google Cloud Speech API][Product Documentation]:
+Google Cloud Speech API.
 - [Client Library Documentation][]
 - [Product Documentation][]
 
@@ -11,7 +11,7 @@ steps:
 
 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-3. [Enable the Cloud Speech API.](https://console.cloud.google.com/apis/api/speech)
+3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
 
 ### Installation
@@ -46,16 +46,23 @@ response = speech_client.recognize(config, audio)
 ```
 
 ### Next Steps
-- Read the [Client Library Documentation][] for Cloud Speech API
+- Read the [Client Library Documentation][] for Google Cloud Speech API
   to see other available methods on the client.
-- Read the [Cloud Speech API Product documentation][Product Documentation]
+- Read the [Google Cloud Speech API Product documentation][Product Documentation]
   to learn more about the product and see How-to Guides.
 - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
   to see the full list of Cloud APIs that we cover.
 
+[Client Library Documentation]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-speech/latest/google/cloud/speech/v1
+[Product Documentation]: https://cloud.google.com/speech
+
 ## Enabling Logging
 
-To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below, or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb) and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 
 Configuring a Ruby stdlib logger:
 
@@ -77,14 +84,11 @@ end
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.0+.
+This library is supported on Ruby 2.3+.
 
-However, Ruby 2.3 or later is strongly recommended, as earlier releases have
-reached or are nearing end-of-life. After June 1, 2018, Google will provide
-official support only for Ruby versions that are considered current and
-supported by Ruby Core (that is, Ruby versions that are either in normal
-maintenance or in security maintenance).
-See https://www.ruby-lang.org/en/downloads/branches/ for further details.
-
-[Client Library Documentation]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-speech/latest/google/cloud/speech
-[Product Documentation]: https://cloud.google.com/speech
+Google provides official support for Ruby versions that are actively supported
+by Ruby Core—that is, Ruby versions that are either in normal maintenance or
+in security maintenance, and not end of life. Currently, this means Ruby 2.3
+and later. Older versions of Ruby _may_ still work, but are unsupported and not
+recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
+about the Ruby support schedule.

data/lib/google/cloud/speech.rb

@@ -32,7 +32,7 @@ module Google
     #
     # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
     # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-    # 3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/api/speech)
+    # 3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
     # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
     #
     # ### Migration Guide
@@ -56,7 +56,7 @@ module Google
     #   sample_rate_hertz: sample_rate_hertz,
     #   encoding: encoding
     # }
-    # uri = "gs://gapic-toolkit/hello.flac"
+    # uri = "gs://bucket-name/hello.flac"
     # audio = { uri: uri }
     # response = speech_client.recognize(config, audio)
     # ```
@@ -69,6 +69,31 @@ module Google
     #
     # [Product Documentation]: https://cloud.google.com/speech
     #
+    # ## Enabling Logging
+    #
+    # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+    # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+    # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+    # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+    #
+    # Configuring a Ruby stdlib logger:
+    #
+    # ```ruby
+    # require "logger"
+    #
+    # module MyLogger
+    #   LOGGER = Logger.new $stderr, level: Logger::WARN
+    #   def logger
+    #     LOGGER
+    #   end
+    # end
+    #
+    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+    # module GRPC
+    #   extend MyLogger
+    # end
+    # ```
     #
     module Speech
       # rubocop:enable LineLength

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

@@ -17,53 +17,78 @@ require "google/cloud/speech/v1/helpers"
 
 module Google
   module Cloud
-    # rubocop:disable LineLength
-
-    ##
-    # # Ruby Client for Google Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
-    #
-    # [Google Cloud Speech API][Product Documentation]:
-    # Google Cloud Speech API.
-    # - [Product Documentation][]
-    #
-    # ## Quick Start
-    # In order to use this library, you first need to go through the following
-    # steps:
-    #
-    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-    # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-    # 3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/api/speech)
-    # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-    #
-    # ### Preview
-    # #### SpeechClient
-    # ```rb
-    # require "google/cloud/speech/v1"
-    #
-    # speech_client = Google::Cloud::Speech::V1.new
-    # language_code = "en-US"
-    # sample_rate_hertz = 44100
-    # encoding = :FLAC
-    # config = {
-    #   language_code: language_code,
-    #   sample_rate_hertz: sample_rate_hertz,
-    #   encoding: encoding
-    # }
-    # uri = "gs://gapic-toolkit/hello.flac"
-    # audio = { uri: uri }
-    # response = speech_client.recognize(config, audio)
-    # ```
-    #
-    # ### Next Steps
-    # - Read the [Google Cloud Speech API Product documentation][Product Documentation]
-    #   to learn more about the product and see How-to Guides.
-    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
-    #   to see the full list of Cloud APIs that we cover.
-    #
-    # [Product Documentation]: https://cloud.google.com/speech
-    #
-    #
     module Speech
+      # rubocop:disable LineLength
+
+      ##
+      # # Ruby Client for Google Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+      #
+      # [Google Cloud Speech API][Product Documentation]:
+      # Google Cloud Speech API.
+      # - [Product Documentation][]
+      #
+      # ## Quick Start
+      # In order to use this library, you first need to go through the following
+      # steps:
+      #
+      # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+      # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+      # 3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
+      # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+      #
+      # ### Preview
+      # #### SpeechClient
+      # ```rb
+      # require "google/cloud/speech"
+      #
+      # speech_client = Google::Cloud::Speech.new(version: :v1)
+      # language_code = "en-US"
+      # sample_rate_hertz = 44100
+      # encoding = :FLAC
+      # config = {
+      #   language_code: language_code,
+      #   sample_rate_hertz: sample_rate_hertz,
+      #   encoding: encoding
+      # }
+      # uri = "gs://bucket-name/hello.flac"
+      # audio = { uri: uri }
+      # response = speech_client.recognize(config, audio)
+      # ```
+      #
+      # ### Next Steps
+      # - Read the [Google Cloud Speech API Product documentation][Product Documentation]
+      #   to learn more about the product and see How-to Guides.
+      # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+      #   to see the full list of Cloud APIs that we cover.
+      #
+      # [Product Documentation]: https://cloud.google.com/speech
+      #
+      # ## Enabling Logging
+      #
+      # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+      # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+      # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+      # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+      # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+      #
+      # Configuring a Ruby stdlib logger:
+      #
+      # ```ruby
+      # require "logger"
+      #
+      # module MyLogger
+      #   LOGGER = Logger.new $stderr, level: Logger::WARN
+      #   def logger
+      #     LOGGER
+      #   end
+      # end
+      #
+      # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+      # module GRPC
+      #   extend MyLogger
+      # end
+      # ```
+      #
       module V1
         # rubocop:enable LineLength
 

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

@@ -22,8 +22,16 @@ module Google
           SCOPE = [
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
-          PATH_ENV_VARS = %w(SPEECH_KEYFILE GOOGLE_CLOUD_KEYFILE GCLOUD_KEYFILE)
-          JSON_ENV_VARS = %w(SPEECH_KEYFILE_JSON GOOGLE_CLOUD_KEYFILE_JSON GCLOUD_KEYFILE_JSON)
+          PATH_ENV_VARS = %w(SPEECH_CREDENTIALS
+                             SPEECH_KEYFILE
+                             GOOGLE_CLOUD_CREDENTIALS
+                             GOOGLE_CLOUD_KEYFILE
+                             GCLOUD_KEYFILE)
+          JSON_ENV_VARS = %w(SPEECH_CREDENTIALS_JSON
+                             SPEECH_KEYFILE_JSON
+                             GOOGLE_CLOUD_CREDENTIALS_JSON
+                             GOOGLE_CLOUD_KEYFILE_JSON
+                             GCLOUD_KEYFILE_JSON)
           DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
         end
       end

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

@@ -15,17 +15,6 @@
 module Google
   module Cloud
     module Speech
-      ##
-      # # Google Cloud Speech API Contents
-      #
-      # | Class | Description |
-      # | ----- | ----------- |
-      # | [SpeechClient][] | Service that implements Google Cloud Speech API. |
-      # | [Data Types][] | Data types for Google::Cloud::Speech::V1 |
-      #
-      # [SpeechClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-speech/latest/google/cloud/speech/v1/speechclient
-      # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-speech/latest/google/cloud/speech/v1/datatypes
-      #
       module V1
         # The top-level message sent by the client for the +Recognize+ method.
         # @!attribute [rw] config

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

@@ -29,7 +29,7 @@ module Google
     #
     # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
     # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-    # 3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/api/speech)
+    # 3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
     # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
     #
     # ### Installation
@@ -64,6 +64,31 @@ module Google
     #
     # [Product Documentation]: https://cloud.google.com/speech
     #
+    # ## Enabling Logging
+    #
+    # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+    # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+    # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+    # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+    #
+    # Configuring a Ruby stdlib logger:
+    #
+    # ```ruby
+    # require "logger"
+    #
+    # module MyLogger
+    #   LOGGER = Logger.new $stderr, level: Logger::WARN
+    #   def logger
+    #     LOGGER
+    #   end
+    # end
+    #
+    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+    # module GRPC
+    #   extend MyLogger
+    # end
+    # ```
     #
     module Speech
       module V1

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

@@ -46,6 +46,9 @@ module Google
           # The default port of the service.
           DEFAULT_SERVICE_PORT = 443
 
+          # The default set of gRPC interceptors.
+          GRPC_INTERCEPTORS = []
+
           DEFAULT_TIMEOUT = 30
 
           # The scopes needed to make gRPC calls to all of the methods defined in
@@ -54,8 +57,10 @@ module Google
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
 
+          # @private
           class OperationsClient < Google::Longrunning::OperationsClient
             self::SERVICE_ADDRESS = SpeechClient::SERVICE_ADDRESS
+            self::GRPC_INTERCEPTORS = SpeechClient::GRPC_INTERCEPTORS
           end
 
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
@@ -157,6 +162,7 @@ module Google
             # Allow overriding the service path/port in subclasses.
             service_path = self.class::SERVICE_ADDRESS
             port = self.class::DEFAULT_SERVICE_PORT
+            interceptors = self.class::GRPC_INTERCEPTORS
             @speech_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
@@ -164,6 +170,7 @@ module Google
               channel: channel,
               updater_proc: updater_proc,
               scopes: scopes,
+              interceptors: interceptors,
               &Google::Cloud::Speech::V1::Speech::Stub.method(:new)
             )
 
@@ -207,9 +214,9 @@ module Google
           # @return [Google::Cloud::Speech::V1::RecognizeResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/speech/v1"
+          #   require "google/cloud/speech"
           #
-          #   speech_client = Google::Cloud::Speech::V1.new
+          #   speech_client = Google::Cloud::Speech.new(version: :v1)
           #   encoding = :FLAC
           #   sample_rate_hertz = 44100
           #   language_code = "en-US"
@@ -255,9 +262,9 @@ module Google
           # @return [Google::Gax::Operation]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/speech/v1"
+          #   require "google/cloud/speech"
           #
-          #   speech_client = Google::Cloud::Speech::V1.new
+          #   speech_client = Google::Cloud::Speech.new(version: :v1)
           #   encoding = :FLAC
           #   sample_rate_hertz = 44100
           #   language_code = "en-US"

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

@@ -17,53 +17,78 @@ require "google/cloud/speech/v1p1beta1/helpers"
 
 module Google
   module Cloud
-    # rubocop:disable LineLength
-
-    ##
-    # # Ruby Client for Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
-    #
-    # [Cloud Speech API][Product Documentation]:
-    # Converts audio to text by applying powerful neural network models.
-    # - [Product Documentation][]
-    #
-    # ## Quick Start
-    # In order to use this library, you first need to go through the following
-    # steps:
-    #
-    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-    # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-    # 3. [Enable the Cloud Speech API.](https://console.cloud.google.com/apis/api/speech)
-    # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
-    #
-    # ### Preview
-    # #### SpeechClient
-    # ```rb
-    # require "google/cloud/speech/v1p1beta1"
-    #
-    # speech_client = Google::Cloud::Speech::V1p1beta1.new
-    # language_code = "en-US"
-    # sample_rate_hertz = 44100
-    # encoding = :FLAC
-    # config = {
-    #   language_code: language_code,
-    #   sample_rate_hertz: sample_rate_hertz,
-    #   encoding: encoding
-    # }
-    # uri = "gs://gapic-toolkit/hello.flac"
-    # audio = { uri: uri }
-    # response = speech_client.recognize(config, audio)
-    # ```
-    #
-    # ### Next Steps
-    # - Read the [Cloud Speech API Product documentation][Product Documentation]
-    #   to learn more about the product and see How-to Guides.
-    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
-    #   to see the full list of Cloud APIs that we cover.
-    #
-    # [Product Documentation]: https://cloud.google.com/speech
-    #
-    #
     module Speech
+      # rubocop:disable LineLength
+
+      ##
+      # # Ruby Client for Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+      #
+      # [Cloud Speech API][Product Documentation]:
+      # Converts audio to text by applying powerful neural network models.
+      # - [Product Documentation][]
+      #
+      # ## Quick Start
+      # In order to use this library, you first need to go through the following
+      # steps:
+      #
+      # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+      # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+      # 3. [Enable the Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
+      # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+      #
+      # ### Preview
+      # #### SpeechClient
+      # ```rb
+      # require "google/cloud/speech"
+      #
+      # speech_client = Google::Cloud::Speech.new(version: :v1p1beta1)
+      # language_code = "en-US"
+      # sample_rate_hertz = 44100
+      # encoding = :FLAC
+      # config = {
+      #   language_code: language_code,
+      #   sample_rate_hertz: sample_rate_hertz,
+      #   encoding: encoding
+      # }
+      # uri = "gs://bucket-name/hello.flac"
+      # audio = { uri: uri }
+      # response = speech_client.recognize(config, audio)
+      # ```
+      #
+      # ### Next Steps
+      # - Read the [Cloud Speech API Product documentation][Product Documentation]
+      #   to learn more about the product and see How-to Guides.
+      # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+      #   to see the full list of Cloud APIs that we cover.
+      #
+      # [Product Documentation]: https://cloud.google.com/speech
+      #
+      # ## Enabling Logging
+      #
+      # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+      # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+      # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+      # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+      # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+      #
+      # Configuring a Ruby stdlib logger:
+      #
+      # ```ruby
+      # require "logger"
+      #
+      # module MyLogger
+      #   LOGGER = Logger.new $stderr, level: Logger::WARN
+      #   def logger
+      #     LOGGER
+      #   end
+      # end
+      #
+      # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+      # module GRPC
+      #   extend MyLogger
+      # end
+      # ```
+      #
       module V1p1beta1
         # rubocop:enable LineLength
 

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

@@ -32,12 +32,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.speech.v1p1beta1.RecognitionConfig" do
     optional :encoding, :enum, 1, "google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding"
     optional :sample_rate_hertz, :int32, 2
+    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
     repeated :speech_contexts, :message, 6, "google.cloud.speech.v1p1beta1.SpeechContext"
     optional :enable_word_time_offsets, :bool, 8
+    optional :enable_word_confidence, :bool, 15
     optional :enable_automatic_punctuation, :bool, 11
+    optional :enable_speaker_diarization, :bool, 16
+    optional :diarization_speaker_count, :int32, 17
     optional :metadata, :message, 9, "google.cloud.speech.v1p1beta1.RecognitionMetadata"
     optional :model, :string, 13
     optional :use_enhanced, :bool, 14
@@ -127,9 +133,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     repeated :alternatives, :message, 1, "google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative"
     optional :is_final, :bool, 2
     optional :stability, :float, 3
+    optional :channel_tag, :int32, 5
+    optional :language_code, :string, 6
   end
   add_message "google.cloud.speech.v1p1beta1.SpeechRecognitionResult" do
     repeated :alternatives, :message, 1, "google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative"
+    optional :channel_tag, :int32, 2
+    optional :language_code, :string, 5
   end
   add_message "google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative" do
     optional :transcript, :string, 1
@@ -140,6 +150,8 @@ 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/v1p1beta1/credentials.rb

@@ -22,8 +22,16 @@ module Google
           SCOPE = [
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
-          PATH_ENV_VARS = %w(SPEECH_KEYFILE GOOGLE_CLOUD_KEYFILE GCLOUD_KEYFILE)
-          JSON_ENV_VARS = %w(SPEECH_KEYFILE_JSON GOOGLE_CLOUD_KEYFILE_JSON GCLOUD_KEYFILE_JSON)
+          PATH_ENV_VARS = %w(SPEECH_CREDENTIALS
+                             SPEECH_KEYFILE
+                             GOOGLE_CLOUD_CREDENTIALS
+                             GOOGLE_CLOUD_KEYFILE
+                             GCLOUD_KEYFILE)
+          JSON_ENV_VARS = %w(SPEECH_CREDENTIALS_JSON
+                             SPEECH_KEYFILE_JSON
+                             GOOGLE_CLOUD_CREDENTIALS_JSON
+                             GOOGLE_CLOUD_KEYFILE_JSON
+                             GCLOUD_KEYFILE_JSON)
           DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
         end
       end

data/lib/google/cloud/speech/v1p1beta1/doc/google/cloud/speech/v1p1beta1/cloud_speech.rb

@@ -15,17 +15,6 @@
 module Google
   module Cloud
     module Speech
-      ##
-      # # Cloud Speech API Contents
-      #
-      # | Class | Description |
-      # | ----- | ----------- |
-      # | [SpeechClient][] | Service that implements Google Cloud Speech API. |
-      # | [Data Types][] | Data types for Google::Cloud::Speech::V1p1beta1 |
-      #
-      # [SpeechClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-speech/latest/google/cloud/speech/v1p1beta1/speechclient
-      # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-speech/latest/google/cloud/speech/v1p1beta1/datatypes
-      #
       module V1p1beta1
         # The top-level message sent by the client for the +Recognize+ method.
         # @!attribute [rw] config
@@ -113,6 +102,25 @@ module Google
         #     the audio source (instead of re-sampling).
         #     This field is optional for +FLAC+ and +WAV+ audio files and required
         #     for all other audio formats. For details, see {Google::Cloud::Speech::V1p1beta1::RecognitionConfig::AudioEncoding AudioEncoding}.
+        # @!attribute [rw] audio_channel_count
+        #   @return [Integer]
+        #     *Optional* The number of channels in the input audio data.
+        #     ONLY set this for MULTI-CHANNEL recognition.
+        #     Valid values for LINEAR16 and FLAC are +1+-+8+.
+        #     Valid values for OGG_OPUS are '1'-'254'.
+        #     Valid value for MULAW, AMR, AMR_WB and SPEEX_WITH_HEADER_BYTE is only +1+.
+        #     If +0+ or omitted, defaults to one channel (mono).
+        #     NOTE: We only recognize the first channel by default.
+        #     To perform independent recognition on each channel set
+        #     enable_separate_recognition_per_channel to 'true'.
+        # @!attribute [rw] enable_separate_recognition_per_channel
+        #   @return [true, false]
+        #     This needs to be set to ‘true’ explicitly and audio_channel_count > 1
+        #     to get each channel recognized separately. The recognition result will
+        #     contain a channel_tag field to state which channel that result belongs to.
+        #     If this is not ‘true’, we will only recognize the first channel.
+        #     NOTE: The request is also billed cumulatively for all channels recognized:
+        #         (audio_channel_count times the audio length)
         # @!attribute [rw] language_code
         #   @return [String]
         #     *Required* The language of the supplied audio as a
@@ -120,6 +128,20 @@ module Google
         #     Example: "en-US".
         #     See [Language Support](https://cloud.google.com/speech/docs/languages)
         #     for a list of the currently supported language codes.
+        # @!attribute [rw] alternative_language_codes
+        #   @return [Array<String>]
+        #     *Optional* 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/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]
         #     *Optional* Maximum number of recognition hypotheses to be returned.
@@ -143,6 +165,11 @@ 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 [true, false]
+        #     *Optional* 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 [true, false]
         #     *Optional* If 'true', adds punctuation to recognition result hypotheses.
@@ -152,6 +179,21 @@ module Google
         #     NOTE: "This is currently offered as an experimental service, complimentary
         #     to all users. In the future this may be exclusively available as a
         #     premium feature."
+        # @!attribute [rw] enable_speaker_diarization
+        #   @return [true, false]
+        #     *Optional* 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.
+        #     Note: When this is true, we send all the words from the beginning of the
+        #     audio for the top alternative in every consecutive responses.
+        #     This is done in order to improve our speaker tags as our models learn to
+        #     identify the speakers in the conversation over time.
+        # @!attribute [rw] diarization_speaker_count
+        #   @return [Integer]
+        #     *Optional*
+        #     If set, specifies the estimated number of speakers in the conversation.
+        #     If not set, defaults to '2'.
+        #     Ignored unless enable_speaker_diarization is set to true."
         # @!attribute [rw] metadata
         #   @return [Google::Cloud::Speech::V1p1beta1::RecognitionMetadata]
         #     *Optional* Metadata regarding this request.
@@ -567,6 +609,17 @@ module Google
         #     (completely unstable) to 1.0 (completely stable).
         #     This field is only provided for interim results (+is_final=false+).
         #     The default of 0.0 is a sentinel value indicating +stability+ was not set.
+        # @!attribute [rw] channel_tag
+        #   @return [Integer]
+        #     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] 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 StreamingRecognitionResult; end
 
         # A speech recognition result corresponding to a portion of the audio.
@@ -576,6 +629,17 @@ module Google
         #     maximum specified in +max_alternatives+).
         #     These alternatives are ordered in terms of accuracy, with the top (first)
         #     alternative being the most probable, as ranked by the recognizer.
+        # @!attribute [rw] channel_tag
+        #   @return [Integer]
+        #     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] 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; end
 
         # Alternative hypotheses (a.k.a. n-best list).
@@ -618,6 +682,22 @@ module Google
         # @!attribute [rw] word
         #   @return [String]
         #     Output only. The word corresponding to this set of information.
+        # @!attribute [rw] confidence
+        #   @return [Float]
+        #     Output only. 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 [rw] speaker_tag
+        #   @return [Integer]
+        #     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
+        #     top alternative.
         class WordInfo; end
       end
     end

data/lib/google/cloud/speech/v1p1beta1/doc/overview.rb

@@ -29,7 +29,7 @@ module Google
     #
     # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
     # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-    # 3. [Enable the Cloud Speech API.](https://console.cloud.google.com/apis/api/speech)
+    # 3. [Enable the Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
     # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
     #
     # ### Installation
@@ -42,7 +42,7 @@ module Google
     # ```rb
     # require "google/cloud/speech"
     #
-    # speech_client = Google::Cloud::Speech::V1p1beta1.new
+    # speech_client = Google::Cloud::Speech.new
     # language_code = "en-US"
     # sample_rate_hertz = 44100
     # encoding = :FLAC
@@ -64,6 +64,31 @@ module Google
     #
     # [Product Documentation]: https://cloud.google.com/speech
     #
+    # ## Enabling Logging
+    #
+    # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+    # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+    # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+    # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+    #
+    # Configuring a Ruby stdlib logger:
+    #
+    # ```ruby
+    # require "logger"
+    #
+    # module MyLogger
+    #   LOGGER = Logger.new $stderr, level: Logger::WARN
+    #   def logger
+    #     LOGGER
+    #   end
+    # end
+    #
+    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+    # module GRPC
+    #   extend MyLogger
+    # end
+    # ```
     #
     module Speech
       module V1p1beta1

data/lib/google/cloud/speech/v1p1beta1/speech_client.rb

@@ -46,6 +46,9 @@ module Google
           # The default port of the service.
           DEFAULT_SERVICE_PORT = 443
 
+          # The default set of gRPC interceptors.
+          GRPC_INTERCEPTORS = []
+
           DEFAULT_TIMEOUT = 30
 
           # The scopes needed to make gRPC calls to all of the methods defined in
@@ -54,8 +57,10 @@ module Google
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
 
+          # @private
           class OperationsClient < Google::Longrunning::OperationsClient
             self::SERVICE_ADDRESS = SpeechClient::SERVICE_ADDRESS
+            self::GRPC_INTERCEPTORS = SpeechClient::GRPC_INTERCEPTORS
           end
 
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
@@ -157,6 +162,7 @@ module Google
             # Allow overriding the service path/port in subclasses.
             service_path = self.class::SERVICE_ADDRESS
             port = self.class::DEFAULT_SERVICE_PORT
+            interceptors = self.class::GRPC_INTERCEPTORS
             @speech_stub = Google::Gax::Grpc.create_stub(
               service_path,
               port,
@@ -164,6 +170,7 @@ module Google
               channel: channel,
               updater_proc: updater_proc,
               scopes: scopes,
+              interceptors: interceptors,
               &Google::Cloud::Speech::V1p1beta1::Speech::Stub.method(:new)
             )
 
@@ -207,9 +214,9 @@ module Google
           # @return [Google::Cloud::Speech::V1p1beta1::RecognizeResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/speech/v1p1beta1"
+          #   require "google/cloud/speech"
           #
-          #   speech_client = Google::Cloud::Speech::V1p1beta1.new
+          #   speech_client = Google::Cloud::Speech.new(version: :v1p1beta1)
           #   encoding = :FLAC
           #   sample_rate_hertz = 44100
           #   language_code = "en-US"
@@ -255,9 +262,9 @@ module Google
           # @return [Google::Gax::Operation]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/speech/v1p1beta1"
+          #   require "google/cloud/speech"
           #
-          #   speech_client = Google::Cloud::Speech::V1p1beta1.new
+          #   speech_client = Google::Cloud::Speech.new(version: :v1p1beta1)
           #   encoding = :FLAC
           #   sample_rate_hertz = 44100
           #   language_code = "en-US"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-speech
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.30.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-21 00:00:00.000000000 Z
+date: 2018-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.10'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -66,7 +80,21 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-description: google-cloud-speech is the official library for Cloud Speech API.
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: google-cloud-speech is the official library for Google Cloud Speech API.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
@@ -129,5 +157,5 @@ rubyforge_project:
 rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
-summary: API Client library for Cloud Speech API
+summary: API Client library for Google Cloud Speech API
 test_files: []