google-cloud-language-v1 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d33a1aeb6b6f86ceeb82649af7e46ddcba66fd5227283474802469e804670b28
-  data.tar.gz: 0c30135c4a045eadd16884af845e334b3c359f8867e23dd7977200b51cfad4bf
+  metadata.gz: 519c05e3f636bb9f965a94cf19f3bf51e256d40875b3c5aef0ad95bb19c2a79b
+  data.tar.gz: 342ce186013244bc539e51c4814b8d5467e872a6c5b76e44180fa61809e268c8
 SHA512:
-  metadata.gz: '092ded8dea14b727db95704b4ebaa9274fb56e166e1827c73a632ea334b36c7331d88c36ea3be8c3c797195d7f444eca29979eaa7610d426ae682915ad45aebe'
-  data.tar.gz: 2a3cf7c1336d627780a3d187048370ab900c2a8f1a3b0acbb98d26a22daf138322af182f64048b27cd777b6e69045abebea6d89e471cb171af1a590a47079c7a
+  metadata.gz: 95133a7d3ff00cb673e3c4705d324453d29cda1c988007146115a08a9e435c629d3abe52fed94ed912a2c72f3f873bd09ba14a468ff0fae9363d29a7ccb2f540
+  data.tar.gz: 271b5d39324ee820890a3be1f60f611f602c91a5aa6ff5356b9d70f1d61c27de4d8a6bce4b19ad7bfc72a9dd9361b68d9ce41d5f32a4c3a1c99bee7739314d8e

data/AUTHENTICATION.md

@@ -27,7 +27,7 @@ export LANGUAGE_CREDENTIALS=path/to/keyfile.json
 ```ruby
 require "google/cloud/language/v1"
 
-client = Google::Cloud::Language::V1::LanguageService::Client.new
+client = ::Google::Cloud::Language::V1::LanguageService::Client.new
 ```
 
 ## Credential Lookup
@@ -64,7 +64,7 @@ containers where writing files is difficult or not encouraged.
 
 The environment variables that google-cloud-language-v1
 checks for credentials are configured on the service Credentials class (such as
-{Google::Cloud::Language::V1::LanguageService::Credentials}):
+{::Google::Cloud::Language::V1::LanguageService::Credentials}):
 
 1. `LANGUAGE_CREDENTIALS` - Path to JSON file, or JSON contents
 2. `LANGUAGE_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/language/v1"
 
 ENV["LANGUAGE_CREDENTIALS"] = "path/to/keyfile.json"
 
-client = Google::Cloud::Language::V1::LanguageService::Client.new
+client = ::Google::Cloud::Language::V1::LanguageService::Client.new
 ```
 
 ### Configuration
@@ -88,7 +88,7 @@ environment variables. Either on an individual client initialization:
 ```ruby
 require "google/cloud/language/v1"
 
-client = Google::Cloud::Language::V1::LanguageService::Client.new do |config|
+client = ::Google::Cloud::Language::V1::LanguageService::Client.new do |config|
   config.credentials = "path/to/keyfile.json"
 end
 ```
@@ -98,11 +98,11 @@ Or configured globally for all clients:
 ```ruby
 require "google/cloud/language/v1"
 
-Google::Cloud::Language::V1::LanguageService::Client.configure do |config|
+::Google::Cloud::Language::V1::LanguageService::Client.configure do |config|
   config.credentials = "path/to/keyfile.json"
 end
 
-client = Google::Cloud::Language::V1::LanguageService::Client.new
+client = ::Google::Cloud::Language::V1::LanguageService::Client.new
 ```
 
 ### Cloud SDK

data/README.md

@@ -1,4 +1,4 @@
-# Natural Language V1
+# Ruby Client for the Natural Language V1 API
 
 API Client library for the Natural Language V1 API
 
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
 $ gem install google-cloud-language-v1
 ```
 
+## Before You Begin
+
+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)
+1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. {file:AUTHENTICATION.md Set up authentication.}
+
+## Quick Start
+
+```ruby
+require "google/cloud/language/v1"
+
+client = ::Google::Cloud::Language::V1::LanguageService::Client.new
+request = my_create_request
+response = client.analyze_sentiment request
+```
+
+View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-language-v1/latest)
+for class and method documentation.
+
+## 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/libdoc/logger/rdoc/Logger.html) as shown below,
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+that will write logs to [Cloud 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
+```
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.4+.

data/lib/google-cloud-language-v1.rb

@@ -1 +1,21 @@
-require "google/cloud/language/v1/version"
+# frozen_string_literal: true
+
+# Copyright 2020 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!
+
+# This gem does not autoload during Bundler.require. To load this gem,
+# issue explicit require statements for the packages desired, e.g.:
+# require "google/cloud/language/v1"

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

@@ -17,3 +17,19 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/language/v1/language_service"
+require "google/cloud/language/v1/version"
+
+module Google
+  module Cloud
+    module Language
+      ##
+      # To load this package, including all its services, and instantiate a client:
+      #
+      #     require "google/cloud/language/v1"
+      #     client = ::Google::Cloud::Language::V1::LanguageService::Client.new
+      #
+      module V1
+      end
+    end
+  end
+end

data/lib/google/cloud/language/v1/language_service.rb

@@ -16,5 +16,34 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "google/cloud/language/v1/language_service/client"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/language/v1/version"
+
 require "google/cloud/language/v1/language_service/credentials"
+require "google/cloud/language/v1/language_service/client"
+
+module Google
+  module Cloud
+    module Language
+      module V1
+        ##
+        # Provides text analysis operations such as sentiment analysis and entity
+        # recognition.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/language/v1/language_service"
+        #     client = ::Google::Cloud::Language::V1::LanguageService::Client.new
+        #
+        module LanguageService
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "language_service", "helpers.rb"
+require "google/cloud/language/v1/language_service/helpers" if ::File.file? helper_path

data/lib/google/cloud/language/v1/language_service/client.rb

@@ -16,14 +16,8 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
-require "gapic/config"
-require "gapic/config/method"
-
 require "google/cloud/errors"
-require "google/cloud/language/v1/version"
 require "google/cloud/language/v1/language_service_pb"
-require "google/cloud/language/v1/language_service/credentials"
 
 module Google
   module Cloud
@@ -43,15 +37,15 @@ module Google
             ##
             # Configure the LanguageService Client class.
             #
-            # See {Google::Cloud::Language::V1::LanguageService::Client::Configuration}
+            # See {::Google::Cloud::Language::V1::LanguageService::Client::Configuration}
             # for a description of the configuration fields.
             #
             # ## Example
             #
             # To modify the configuration for all LanguageService clients:
             #
-            #     Google::Cloud::Language::V1::LanguageService::Client.configure do |config|
-            #       config.timeout = 10_000
+            #     ::Google::Cloud::Language::V1::LanguageService::Client.configure do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the Client client.
@@ -131,7 +125,7 @@ module Google
             # but structural changes (adding new fields, etc.) are not allowed. Structural changes
             # should be made on {Client.configure}.
             #
-            # See {Google::Cloud::Language::V1::LanguageService::Client::Configuration}
+            # See {::Google::Cloud::Language::V1::LanguageService::Client::Configuration}
             # for a description of the configuration fields.
             #
             # @yield [config] Configure the Client client.
@@ -152,13 +146,13 @@ module Google
             # To create a new LanguageService client with the default
             # configuration:
             #
-            #     client = Google::Cloud::Language::V1::LanguageService::Client.new
+            #     client = ::Google::Cloud::Language::V1::LanguageService::Client.new
             #
             # To create a new LanguageService client with a custom
             # configuration:
             #
-            #     client = Google::Cloud::Language::V1::LanguageService::Client.new do |config|
-            #       config.timeout = 10_000
+            #     client = ::Google::Cloud::Language::V1::LanguageService::Client.new do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the LanguageService client.
@@ -183,10 +177,11 @@ module Google
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
-              @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
+              @quota_project_id = @config.quota_project
+              @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
-              @language_service_stub = Gapic::ServiceStub.new(
-                Google::Cloud::Language::V1::LanguageService::Stub,
+              @language_service_stub = ::Gapic::ServiceStub.new(
+                ::Google::Cloud::Language::V1::LanguageService::Stub,
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
@@ -200,39 +195,46 @@ module Google
             # Analyzes the sentiment of the provided text.
             #
             # @overload analyze_sentiment(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1::AnalyzeSentimentRequest | Hash]
-            #     Analyzes the sentiment of the provided text.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `analyze_sentiment` via a request object, either of type
+            #   {::Google::Cloud::Language::V1::AnalyzeSentimentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Language::V1::AnalyzeSentimentRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_sentiment(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1::Document | Hash]
+            #   Pass arguments to `analyze_sentiment` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
             #     Input document.
-            #   @param encoding_type [Google::Cloud::Language::V1::EncodingType]
+            #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate sentence offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Language::V1::AnalyzeSentimentResponse]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Language::V1::AnalyzeSentimentResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Language::V1::AnalyzeSentimentResponse]
+            # @return [::Google::Cloud::Language::V1::AnalyzeSentimentResponse]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def analyze_sentiment request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1::AnalyzeSentimentRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1::AnalyzeSentimentRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.analyze_sentiment.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Language::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -247,8 +249,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -257,41 +259,46 @@ module Google
             # other properties.
             #
             # @overload analyze_entities(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1::AnalyzeEntitiesRequest | Hash]
-            #     Finds named entities (currently proper names and common nouns) in the text
-            #     along with entity types, salience, mentions for each entity, and
-            #     other properties.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `analyze_entities` via a request object, either of type
+            #   {::Google::Cloud::Language::V1::AnalyzeEntitiesRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Language::V1::AnalyzeEntitiesRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_entities(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1::Document | Hash]
+            #   Pass arguments to `analyze_entities` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
             #     Input document.
-            #   @param encoding_type [Google::Cloud::Language::V1::EncodingType]
+            #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Language::V1::AnalyzeEntitiesResponse]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Language::V1::AnalyzeEntitiesResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Language::V1::AnalyzeEntitiesResponse]
+            # @return [::Google::Cloud::Language::V1::AnalyzeEntitiesResponse]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def analyze_entities request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1::AnalyzeEntitiesRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1::AnalyzeEntitiesRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.analyze_entities.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Language::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -306,49 +313,55 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
-            # Finds entities, similar to {Google::Cloud::Language::V1::LanguageService::Client#analyze_entities AnalyzeEntities} in the text and analyzes
+            # Finds entities, similar to {::Google::Cloud::Language::V1::LanguageService::Client#analyze_entities AnalyzeEntities} in the text and analyzes
             # sentiment associated with each entity and its mentions.
             #
             # @overload analyze_entity_sentiment(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1::AnalyzeEntitySentimentRequest | Hash]
-            #     Finds entities, similar to {Google::Cloud::Language::V1::LanguageService::Client#analyze_entities AnalyzeEntities} in the text and analyzes
-            #     sentiment associated with each entity and its mentions.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `analyze_entity_sentiment` via a request object, either of type
+            #   {::Google::Cloud::Language::V1::AnalyzeEntitySentimentRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Language::V1::AnalyzeEntitySentimentRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_entity_sentiment(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1::Document | Hash]
+            #   Pass arguments to `analyze_entity_sentiment` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
             #     Input document.
-            #   @param encoding_type [Google::Cloud::Language::V1::EncodingType]
+            #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Language::V1::AnalyzeEntitySentimentResponse]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Language::V1::AnalyzeEntitySentimentResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Language::V1::AnalyzeEntitySentimentResponse]
+            # @return [::Google::Cloud::Language::V1::AnalyzeEntitySentimentResponse]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def analyze_entity_sentiment request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1::AnalyzeEntitySentimentRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1::AnalyzeEntitySentimentRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.analyze_entity_sentiment.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Language::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -363,8 +376,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -373,41 +386,46 @@ module Google
             # properties.
             #
             # @overload analyze_syntax(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1::AnalyzeSyntaxRequest | Hash]
-            #     Analyzes the syntax of the text and provides sentence boundaries and
-            #     tokenization along with part of speech tags, dependency trees, and other
-            #     properties.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `analyze_syntax` via a request object, either of type
+            #   {::Google::Cloud::Language::V1::AnalyzeSyntaxRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Language::V1::AnalyzeSyntaxRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_syntax(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1::Document | Hash]
+            #   Pass arguments to `analyze_syntax` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
             #     Input document.
-            #   @param encoding_type [Google::Cloud::Language::V1::EncodingType]
+            #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Language::V1::AnalyzeSyntaxResponse]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Language::V1::AnalyzeSyntaxResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Language::V1::AnalyzeSyntaxResponse]
+            # @return [::Google::Cloud::Language::V1::AnalyzeSyntaxResponse]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def analyze_syntax request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1::AnalyzeSyntaxRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1::AnalyzeSyntaxRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.analyze_syntax.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Language::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -422,45 +440,52 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
             # Classifies a document into categories.
             #
             # @overload classify_text(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1::ClassifyTextRequest | Hash]
-            #     Classifies a document into categories.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `classify_text` via a request object, either of type
+            #   {::Google::Cloud::Language::V1::ClassifyTextRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Language::V1::ClassifyTextRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload classify_text(document: nil)
-            #   @param document [Google::Cloud::Language::V1::Document | Hash]
-            #     Input document.
+            #   Pass arguments to `classify_text` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
             #
+            #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
+            #     Input document.
             #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Language::V1::ClassifyTextResponse]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Language::V1::ClassifyTextResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Language::V1::ClassifyTextResponse]
+            # @return [::Google::Cloud::Language::V1::ClassifyTextResponse]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def classify_text request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1::ClassifyTextRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1::ClassifyTextRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.classify_text.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Language::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -475,8 +500,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -484,42 +509,48 @@ module Google
             # analyzeEntities, and analyzeSyntax provide in one call.
             #
             # @overload annotate_text(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1::AnnotateTextRequest | Hash]
-            #     A convenience method that provides all the features that analyzeSentiment,
-            #     analyzeEntities, and analyzeSyntax provide in one call.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `annotate_text` via a request object, either of type
+            #   {::Google::Cloud::Language::V1::AnnotateTextRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Language::V1::AnnotateTextRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload annotate_text(document: nil, features: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1::Document | Hash]
+            #   Pass arguments to `annotate_text` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [::Google::Cloud::Language::V1::Document, ::Hash]
             #     Input document.
-            #   @param features [Google::Cloud::Language::V1::AnnotateTextRequest::Features | Hash]
+            #   @param features [::Google::Cloud::Language::V1::AnnotateTextRequest::Features, ::Hash]
             #     The enabled features.
-            #   @param encoding_type [Google::Cloud::Language::V1::EncodingType]
+            #   @param encoding_type [::Google::Cloud::Language::V1::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Google::Cloud::Language::V1::AnnotateTextResponse]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Google::Cloud::Language::V1::AnnotateTextResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Google::Cloud::Language::V1::AnnotateTextResponse]
+            # @return [::Google::Cloud::Language::V1::AnnotateTextResponse]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def annotate_text request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1::AnnotateTextRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1::AnnotateTextRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.annotate_text.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Language::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -534,8 +565,8 @@ module Google
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -545,7 +576,7 @@ module Google
             # providing control over timeouts, retry behavior, logging, transport
             # parameters, and other low-level controls. Certain parameters can also be
             # applied individually to specific RPCs. See
-            # {Google::Cloud::Language::V1::LanguageService::Client::Configuration::Rpcs}
+            # {::Google::Cloud::Language::V1::LanguageService::Client::Configuration::Rpcs}
             # for a list of RPCs that can be configured independently.
             #
             # Configuration can be applied globally to all clients, or to a single client
@@ -556,22 +587,22 @@ module Google
             # To modify the global config, setting the timeout for analyze_sentiment
             # to 20 seconds, and all remaining timeouts to 10 seconds:
             #
-            #     Google::Cloud::Language::V1::LanguageService::Client.configure do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.analyze_sentiment.timeout = 20_000
+            #     ::Google::Cloud::Language::V1::LanguageService::Client.configure do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.analyze_sentiment.timeout = 20.0
             #     end
             #
             # To apply the above configuration only to a new client:
             #
-            #     client = Google::Cloud::Language::V1::LanguageService::Client.new do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.analyze_sentiment.timeout = 20_000
+            #     client = ::Google::Cloud::Language::V1::LanguageService::Client.new do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.analyze_sentiment.timeout = 20.0
             #     end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
             #   Defaults to `"language.googleapis.com"`.
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] credentials
             #   Credentials to send with calls. You may provide any of the following types:
             #    *  (`String`) The path to a service account key file in JSON format
@@ -583,29 +614,29 @@ module Google
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
-            #   @return [Object]
+            #   @return [::Object]
             # @!attribute [rw] scope
             #   The OAuth scopes
-            #   @return [Array<String>]
+            #   @return [::Array<::String>]
             # @!attribute [rw] lib_name
             #   The library name as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] lib_version
             #   The library version as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] channel_args
             #   Extra parameters passed to the gRPC channel. Note: this is ignored if a
             #   `GRPC::Core::Channel` object is provided as the credential.
-            #   @return [Hash]
+            #   @return [::Hash]
             # @!attribute [rw] interceptors
             #   An array of interceptors that are run before calls are executed.
-            #   @return [Array<GRPC::ClientInterceptor>]
+            #   @return [::Array<::GRPC::ClientInterceptor>]
             # @!attribute [rw] timeout
-            #   The call timeout in milliseconds.
-            #   @return [Numeric]
+            #   The call timeout in seconds.
+            #   @return [::Numeric]
             # @!attribute [rw] metadata
             #   Additional gRPC headers to be sent with the call.
-            #   @return [Hash{Symbol=>String}]
+            #   @return [::Hash{::Symbol=>::String}]
             # @!attribute [rw] retry_policy
             #   The retry policy. The value is a hash with the following keys:
             #    *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
@@ -613,25 +644,29 @@ module Google
             #    *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
             #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
             #       trigger a retry.
-            #   @return [Hash]
+            #   @return [::Hash]
+            # @!attribute [rw] quota_project
+            #   A separate project against which to charge quota.
+            #   @return [::String]
             #
             class Configuration
-              extend Gapic::Config
+              extend ::Gapic::Config
 
-              config_attr :endpoint,     "language.googleapis.com", String
-              config_attr :credentials,  nil do |value|
+              config_attr :endpoint,      "language.googleapis.com", ::String
+              config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
-              config_attr :scope,        nil, String, Array, nil
-              config_attr :lib_name,     nil, String, nil
-              config_attr :lib_version,  nil, String, nil
-              config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
-              config_attr :interceptors, nil, Array, nil
-              config_attr :timeout,      nil, Numeric, nil
-              config_attr :metadata,     nil, Hash, nil
-              config_attr :retry_policy, nil, Hash, Proc, nil
+              config_attr :scope,         nil, ::String, ::Array, nil
+              config_attr :lib_name,      nil, ::String, nil
+              config_attr :lib_version,   nil, ::String, nil
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr :interceptors,  nil, ::Array, nil
+              config_attr :timeout,       nil, ::Numeric, nil
+              config_attr :metadata,      nil, ::Hash, nil
+              config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
+              config_attr :quota_project, nil, ::String, nil
 
               # @private
               def initialize parent_config = nil
@@ -672,49 +707,49 @@ module Google
               class Rpcs
                 ##
                 # RPC-specific configuration for `analyze_sentiment`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :analyze_sentiment
                 ##
                 # RPC-specific configuration for `analyze_entities`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :analyze_entities
                 ##
                 # RPC-specific configuration for `analyze_entity_sentiment`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :analyze_entity_sentiment
                 ##
                 # RPC-specific configuration for `analyze_syntax`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :analyze_syntax
                 ##
                 # RPC-specific configuration for `classify_text`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :classify_text
                 ##
                 # RPC-specific configuration for `annotate_text`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :annotate_text
 
                 # @private
                 def initialize parent_rpcs = nil
                   analyze_sentiment_config = parent_rpcs&.analyze_sentiment if parent_rpcs&.respond_to? :analyze_sentiment
-                  @analyze_sentiment = Gapic::Config::Method.new analyze_sentiment_config
+                  @analyze_sentiment = ::Gapic::Config::Method.new analyze_sentiment_config
                   analyze_entities_config = parent_rpcs&.analyze_entities if parent_rpcs&.respond_to? :analyze_entities
-                  @analyze_entities = Gapic::Config::Method.new analyze_entities_config
+                  @analyze_entities = ::Gapic::Config::Method.new analyze_entities_config
                   analyze_entity_sentiment_config = parent_rpcs&.analyze_entity_sentiment if parent_rpcs&.respond_to? :analyze_entity_sentiment
-                  @analyze_entity_sentiment = Gapic::Config::Method.new analyze_entity_sentiment_config
+                  @analyze_entity_sentiment = ::Gapic::Config::Method.new analyze_entity_sentiment_config
                   analyze_syntax_config = parent_rpcs&.analyze_syntax if parent_rpcs&.respond_to? :analyze_syntax
-                  @analyze_syntax = Gapic::Config::Method.new analyze_syntax_config
+                  @analyze_syntax = ::Gapic::Config::Method.new analyze_syntax_config
                   classify_text_config = parent_rpcs&.classify_text if parent_rpcs&.respond_to? :classify_text
-                  @classify_text = Gapic::Config::Method.new classify_text_config
+                  @classify_text = ::Gapic::Config::Method.new classify_text_config
                   annotate_text_config = parent_rpcs&.annotate_text if parent_rpcs&.respond_to? :annotate_text
-                  @annotate_text = Gapic::Config::Method.new annotate_text_config
+                  @annotate_text = ::Gapic::Config::Method.new annotate_text_config
 
                   yield self if block_given?
                 end
@@ -726,13 +761,3 @@ module Google
     end
   end
 end
-
-# rubocop:disable Lint/HandleExceptions
-
-# Once client is loaded, load helpers.rb if it exists.
-begin
-  require "google/cloud/language/v1/language_service/helpers"
-rescue LoadError
-end
-
-# rubocop:enable Lint/HandleExceptions