google-cloud-language-v1beta2 0.1.4 → 0.2.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (13) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +6 -6
  3. data/README.md +5 -1
  4. data/lib/google/cloud/language/v1beta2.rb +1 -1
  5. data/lib/google/cloud/language/v1beta2/language_service.rb +1 -1
  6. data/lib/google/cloud/language/v1beta2/language_service/client.rb +148 -143
  7. data/lib/google/cloud/language/v1beta2/language_service/credentials.rb +1 -1
  8. data/lib/google/cloud/language/v1beta2/version.rb +1 -1
  9. data/proto_docs/google/api/resource.rb +12 -12
  10. data/proto_docs/google/cloud/language/v1beta2/language_service.rb +136 -136
  11. data/proto_docs/google/protobuf/timestamp.rb +4 -4
  12. metadata +33 -6
  13. data/lib/google/cloud/common_resources_pb.rb +0 -15
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a848d58616ce066da01b52b73d9c0e7f37247bf09f263d307b1d3f614bd496e4
4
- data.tar.gz: 752d80c52b6d62f0610cf0c6426fa6a276ee14525a30aef35eb6ffe524dcbcbb
3
+ metadata.gz: 0a9c2bfd759d4ac38a7b382379b5140ae4d757b35ce5f7d3d75bbb1d9eb48af2
4
+ data.tar.gz: e58f07419dfa72e33c4feda9eacda72b60da2aa9f71215c4894ec36ab18a7385
5
5
  SHA512:
6
- metadata.gz: 244ea95e05934f7c2e322d4ef1c3b4f6c58325b849915f0dbf1fa153da94fac01e1b5b8d768baea9a14a797076831327656fe557722d422ccce051c9104f6d5c
7
- data.tar.gz: 5dc79decc6e60beff2478da0fca241f6f6140e65f992847b9b76db9b7376c074280622ea997d2df9ed24de2e36a58a9e9259f21a8d8fd17b9ac4d8b158a59f89
6
+ metadata.gz: e53f670d27953ec98d9c2ac3e95fa77709003f309c3d2db824900ab0d1462803c7f55afedf07388b8c6776b3ed04a0289d5dee1ae72ae79e33bab902ac5f6c63
7
+ data.tar.gz: fdfa65b4043ab0b34980a13073c8ee2fd2a219428759c7509b4c64650beb84f917a1aaaac753ded061767f868fb97525fb87b60a79b849158b1e9bcc582fab21
data/AUTHENTICATION.md CHANGED
@@ -27,7 +27,7 @@ export LANGUAGE_CREDENTIALS=path/to/keyfile.json
27
27
  ```ruby
28
28
  require "google/cloud/language/v1beta2"
29
29
 
30
- client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
30
+ client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new
31
31
  ```
32
32
 
33
33
  ## Credential Lookup
@@ -64,7 +64,7 @@ containers where writing files is difficult or not encouraged.
64
64
 
65
65
  The environment variables that google-cloud-language-v1beta2
66
66
  checks for credentials are configured on the service Credentials class (such as
67
- {Google::Cloud::Language::V1beta2::LanguageService::Credentials}):
67
+ {::Google::Cloud::Language::V1beta2::LanguageService::Credentials}):
68
68
 
69
69
  1. `LANGUAGE_CREDENTIALS` - Path to JSON file, or JSON contents
70
70
  2. `LANGUAGE_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/language/v1beta2"
77
77
 
78
78
  ENV["LANGUAGE_CREDENTIALS"] = "path/to/keyfile.json"
79
79
 
80
- client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
80
+ client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new
81
81
  ```
82
82
 
83
83
  ### Configuration
@@ -88,7 +88,7 @@ environment variables. Either on an individual client initialization:
88
88
  ```ruby
89
89
  require "google/cloud/language/v1beta2"
90
90
 
91
- client = Google::Cloud::Language::V1beta2::LanguageService::Client.new do |config|
91
+ client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new do |config|
92
92
  config.credentials = "path/to/keyfile.json"
93
93
  end
94
94
  ```
@@ -98,11 +98,11 @@ Or configured globally for all clients:
98
98
  ```ruby
99
99
  require "google/cloud/language/v1beta2"
100
100
 
101
- Google::Cloud::Language::V1beta2::LanguageService::Client.configure do |config|
101
+ ::Google::Cloud::Language::V1beta2::LanguageService::Client.configure do |config|
102
102
  config.credentials = "path/to/keyfile.json"
103
103
  end
104
104
 
105
- client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
105
+ client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new
106
106
  ```
107
107
 
108
108
  ### Cloud SDK
data/README.md CHANGED
@@ -18,6 +18,7 @@ In order to use this library, you first need to go through the following steps:
18
18
 
19
19
  1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
20
20
  1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
21
+ 1. [Enable the API.](https://console.cloud.google.com/apis/library/language.googleapis.com)
21
22
  1. {file:AUTHENTICATION.md Set up authentication.}
22
23
 
23
24
  ## Quick Start
@@ -25,7 +26,7 @@ In order to use this library, you first need to go through the following steps:
25
26
  ```ruby
26
27
  require "google/cloud/language/v1beta2"
27
28
 
28
- client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
29
+ client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new
29
30
  request = my_create_request
30
31
  response = client.analyze_sentiment request
31
32
  ```
@@ -33,6 +34,9 @@ response = client.analyze_sentiment request
33
34
  View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-language-v1beta2/latest)
34
35
  for class and method documentation.
35
36
 
37
+ See also the [Product Documentation](https://cloud.google.com/natural-language)
38
+ for general usage information.
39
+
36
40
  ## Enabling Logging
37
41
 
38
42
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
data/lib/google/cloud/language/v1beta2.rb CHANGED
@@ -26,7 +26,7 @@ module Google
26
26
  # To load this package, including all its services, and instantiate a client:
27
27
  #
28
28
  # require "google/cloud/language/v1beta2"
29
- # client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
29
+ # client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new
30
30
  #
31
31
  module V1beta2
32
32
  end
data/lib/google/cloud/language/v1beta2/language_service.rb CHANGED
@@ -36,7 +36,7 @@ module Google
36
36
  # To load this service and instantiate a client:
37
37
  #
38
38
  # require "google/cloud/language/v1beta2/language_service"
39
- # client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
39
+ # client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new
40
40
  #
41
41
  module LanguageService
42
42
  end
data/lib/google/cloud/language/v1beta2/language_service/client.rb CHANGED
@@ -37,15 +37,15 @@ module Google
37
37
  ##
38
38
  # Configure the LanguageService Client class.
39
39
  #
40
- # See {Google::Cloud::Language::V1beta2::LanguageService::Client::Configuration}
40
+ # See {::Google::Cloud::Language::V1beta2::LanguageService::Client::Configuration}
41
41
  # for a description of the configuration fields.
42
42
  #
43
43
  # ## Example
44
44
  #
45
45
  # To modify the configuration for all LanguageService clients:
46
46
  #
47
- # Google::Cloud::Language::V1beta2::LanguageService::Client.configure do |config|
48
- # config.timeout = 10_000
47
+ # ::Google::Cloud::Language::V1beta2::LanguageService::Client.configure do |config|
48
+ # config.timeout = 10.0
49
49
  # end
50
50
  #
51
51
  # @yield [config] Configure the Client client.
@@ -125,7 +125,7 @@ module Google
125
125
  # but structural changes (adding new fields, etc.) are not allowed. Structural changes
126
126
  # should be made on {Client.configure}.
127
127
  #
128
- # See {Google::Cloud::Language::V1beta2::LanguageService::Client::Configuration}
128
+ # See {::Google::Cloud::Language::V1beta2::LanguageService::Client::Configuration}
129
129
  # for a description of the configuration fields.
130
130
  #
131
131
  # @yield [config] Configure the Client client.
@@ -146,13 +146,13 @@ module Google
146
146
  # To create a new LanguageService client with the default
147
147
  # configuration:
148
148
  #
149
- # client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
149
+ # client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new
150
150
  #
151
151
  # To create a new LanguageService client with a custom
152
152
  # configuration:
153
153
  #
154
- # client = Google::Cloud::Language::V1beta2::LanguageService::Client.new do |config|
155
- # config.timeout = 10_000
154
+ # client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new do |config|
155
+ # config.timeout = 10.0
156
156
  # end
157
157
  #
158
158
  # @yield [config] Configure the LanguageService client.
@@ -177,10 +177,11 @@ module Google
177
177
  if credentials.is_a?(String) || credentials.is_a?(Hash)
178
178
  credentials = Credentials.new credentials, scope: @config.scope
179
179
  end
180
- @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
180
+ @quota_project_id = @config.quota_project
181
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
181
182
 
182
- @language_service_stub = Gapic::ServiceStub.new(
183
- Google::Cloud::Language::V1beta2::LanguageService::Stub,
183
+ @language_service_stub = ::Gapic::ServiceStub.new(
184
+ ::Google::Cloud::Language::V1beta2::LanguageService::Stub,
184
185
  credentials: credentials,
185
186
  endpoint: @config.endpoint,
186
187
  channel_args: @config.channel_args,
@@ -195,12 +196,12 @@ module Google
195
196
  #
196
197
  # @overload analyze_sentiment(request, options = nil)
197
198
  # Pass arguments to `analyze_sentiment` via a request object, either of type
198
- # {Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest} or an equivalent Hash.
199
+ # {::Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest} or an equivalent Hash.
199
200
  #
200
- # @param request [Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest, Hash]
201
+ # @param request [::Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest, ::Hash]
201
202
  # A request object representing the call parameters. Required. To specify no
202
203
  # parameters, or to keep all the default parameter values, pass an empty Hash.
203
- # @param options [Gapic::CallOptions, Hash]
204
+ # @param options [::Gapic::CallOptions, ::Hash]
204
205
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
205
206
  #
206
207
  # @overload analyze_sentiment(document: nil, encoding_type: nil)
@@ -208,33 +209,33 @@ module Google
208
209
  # least one keyword argument is required. To specify no parameters, or to keep all
209
210
  # the default parameter values, pass an empty Hash as a request object (see above).
210
211
  #
211
- # @param document [Google::Cloud::Language::V1beta2::Document, Hash]
212
+ # @param document [::Google::Cloud::Language::V1beta2::Document, ::Hash]
212
213
  # Required. Input document.
213
- # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
214
+ # @param encoding_type [::Google::Cloud::Language::V1beta2::EncodingType]
214
215
  # The encoding type used by the API to calculate sentence offsets for the
215
216
  # sentence sentiment.
216
217
  #
217
218
  # @yield [response, operation] Access the result along with the RPC operation
218
- # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeSentimentResponse]
219
- # @yieldparam operation [GRPC::ActiveCall::Operation]
219
+ # @yieldparam response [::Google::Cloud::Language::V1beta2::AnalyzeSentimentResponse]
220
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
220
221
  #
221
- # @return [Google::Cloud::Language::V1beta2::AnalyzeSentimentResponse]
222
+ # @return [::Google::Cloud::Language::V1beta2::AnalyzeSentimentResponse]
222
223
  #
223
- # @raise [Google::Cloud::Error] if the RPC is aborted.
224
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
224
225
  #
225
226
  def analyze_sentiment request, options = nil
226
- raise ArgumentError, "request must be provided" if request.nil?
227
+ raise ::ArgumentError, "request must be provided" if request.nil?
227
228
 
228
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest
229
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest
229
230
 
230
231
  # Converts hash and nil to an options object
231
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
232
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
232
233
 
233
234
  # Customize the options with defaults
234
235
  metadata = @config.rpcs.analyze_sentiment.metadata.to_h
235
236
 
236
237
  # Set x-goog-api-client and x-goog-user-project headers
237
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
238
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
238
239
  lib_name: @config.lib_name, lib_version: @config.lib_version,
239
240
  gapic_version: ::Google::Cloud::Language::V1beta2::VERSION
240
241
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -249,8 +250,8 @@ module Google
249
250
  yield response, operation if block_given?
250
251
  return response
251
252
  end
252
- rescue GRPC::BadStatus => e
253
- raise Google::Cloud::Error.from_error(e)
253
+ rescue ::GRPC::BadStatus => e
254
+ raise ::Google::Cloud::Error.from_error(e)
254
255
  end
255
256
 
256
257
  ##
@@ -260,12 +261,12 @@ module Google
260
261
  #
261
262
  # @overload analyze_entities(request, options = nil)
262
263
  # Pass arguments to `analyze_entities` via a request object, either of type
263
- # {Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest} or an equivalent Hash.
264
+ # {::Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest} or an equivalent Hash.
264
265
  #
265
- # @param request [Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest, Hash]
266
+ # @param request [::Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest, ::Hash]
266
267
  # A request object representing the call parameters. Required. To specify no
267
268
  # parameters, or to keep all the default parameter values, pass an empty Hash.
268
- # @param options [Gapic::CallOptions, Hash]
269
+ # @param options [::Gapic::CallOptions, ::Hash]
269
270
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
270
271
  #
271
272
  # @overload analyze_entities(document: nil, encoding_type: nil)
@@ -273,32 +274,32 @@ module Google
273
274
  # least one keyword argument is required. To specify no parameters, or to keep all
274
275
  # the default parameter values, pass an empty Hash as a request object (see above).
275
276
  #
276
- # @param document [Google::Cloud::Language::V1beta2::Document, Hash]
277
+ # @param document [::Google::Cloud::Language::V1beta2::Document, ::Hash]
277
278
  # Required. Input document.
278
- # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
279
+ # @param encoding_type [::Google::Cloud::Language::V1beta2::EncodingType]
279
280
  # The encoding type used by the API to calculate offsets.
280
281
  #
281
282
  # @yield [response, operation] Access the result along with the RPC operation
282
- # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeEntitiesResponse]
283
- # @yieldparam operation [GRPC::ActiveCall::Operation]
283
+ # @yieldparam response [::Google::Cloud::Language::V1beta2::AnalyzeEntitiesResponse]
284
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
284
285
  #
285
- # @return [Google::Cloud::Language::V1beta2::AnalyzeEntitiesResponse]
286
+ # @return [::Google::Cloud::Language::V1beta2::AnalyzeEntitiesResponse]
286
287
  #
287
- # @raise [Google::Cloud::Error] if the RPC is aborted.
288
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
288
289
  #
289
290
  def analyze_entities request, options = nil
290
- raise ArgumentError, "request must be provided" if request.nil?
291
+ raise ::ArgumentError, "request must be provided" if request.nil?
291
292
 
292
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest
293
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest
293
294
 
294
295
  # Converts hash and nil to an options object
295
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
296
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
296
297
 
297
298
  # Customize the options with defaults
298
299
  metadata = @config.rpcs.analyze_entities.metadata.to_h
299
300
 
300
301
  # Set x-goog-api-client and x-goog-user-project headers
301
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
302
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
302
303
  lib_name: @config.lib_name, lib_version: @config.lib_version,
303
304
  gapic_version: ::Google::Cloud::Language::V1beta2::VERSION
304
305
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -313,22 +314,22 @@ module Google
313
314
  yield response, operation if block_given?
314
315
  return response
315
316
  end
316
- rescue GRPC::BadStatus => e
317
- raise Google::Cloud::Error.from_error(e)
317
+ rescue ::GRPC::BadStatus => e
318
+ raise ::Google::Cloud::Error.from_error(e)
318
319
  end
319
320
 
320
321
  ##
321
- # Finds entities, similar to {Google::Cloud::Language::V1beta2::LanguageService::Client#analyze_entities AnalyzeEntities} in the text and analyzes
322
+ # Finds entities, similar to {::Google::Cloud::Language::V1beta2::LanguageService::Client#analyze_entities AnalyzeEntities} in the text and analyzes
322
323
  # sentiment associated with each entity and its mentions.
323
324
  #
324
325
  # @overload analyze_entity_sentiment(request, options = nil)
325
326
  # Pass arguments to `analyze_entity_sentiment` via a request object, either of type
326
- # {Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest} or an equivalent Hash.
327
+ # {::Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest} or an equivalent Hash.
327
328
  #
328
- # @param request [Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest, Hash]
329
+ # @param request [::Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest, ::Hash]
329
330
  # A request object representing the call parameters. Required. To specify no
330
331
  # parameters, or to keep all the default parameter values, pass an empty Hash.
331
- # @param options [Gapic::CallOptions, Hash]
332
+ # @param options [::Gapic::CallOptions, ::Hash]
332
333
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
333
334
  #
334
335
  # @overload analyze_entity_sentiment(document: nil, encoding_type: nil)
@@ -336,32 +337,32 @@ module Google
336
337
  # least one keyword argument is required. To specify no parameters, or to keep all
337
338
  # the default parameter values, pass an empty Hash as a request object (see above).
338
339
  #
339
- # @param document [Google::Cloud::Language::V1beta2::Document, Hash]
340
+ # @param document [::Google::Cloud::Language::V1beta2::Document, ::Hash]
340
341
  # Required. Input document.
341
- # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
342
+ # @param encoding_type [::Google::Cloud::Language::V1beta2::EncodingType]
342
343
  # The encoding type used by the API to calculate offsets.
343
344
  #
344
345
  # @yield [response, operation] Access the result along with the RPC operation
345
- # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentResponse]
346
- # @yieldparam operation [GRPC::ActiveCall::Operation]
346
+ # @yieldparam response [::Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentResponse]
347
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
347
348
  #
348
- # @return [Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentResponse]
349
+ # @return [::Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentResponse]
349
350
  #
350
- # @raise [Google::Cloud::Error] if the RPC is aborted.
351
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
351
352
  #
352
353
  def analyze_entity_sentiment request, options = nil
353
- raise ArgumentError, "request must be provided" if request.nil?
354
+ raise ::ArgumentError, "request must be provided" if request.nil?
354
355
 
355
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest
356
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest
356
357
 
357
358
  # Converts hash and nil to an options object
358
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
359
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
359
360
 
360
361
  # Customize the options with defaults
361
362
  metadata = @config.rpcs.analyze_entity_sentiment.metadata.to_h
362
363
 
363
364
  # Set x-goog-api-client and x-goog-user-project headers
364
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
365
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
365
366
  lib_name: @config.lib_name, lib_version: @config.lib_version,
366
367
  gapic_version: ::Google::Cloud::Language::V1beta2::VERSION
367
368
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -376,8 +377,8 @@ module Google
376
377
  yield response, operation if block_given?
377
378
  return response
378
379
  end
379
- rescue GRPC::BadStatus => e
380
- raise Google::Cloud::Error.from_error(e)
380
+ rescue ::GRPC::BadStatus => e
381
+ raise ::Google::Cloud::Error.from_error(e)
381
382
  end
382
383
 
383
384
  ##
@@ -387,12 +388,12 @@ module Google
387
388
  #
388
389
  # @overload analyze_syntax(request, options = nil)
389
390
  # Pass arguments to `analyze_syntax` via a request object, either of type
390
- # {Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest} or an equivalent Hash.
391
+ # {::Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest} or an equivalent Hash.
391
392
  #
392
- # @param request [Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest, Hash]
393
+ # @param request [::Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest, ::Hash]
393
394
  # A request object representing the call parameters. Required. To specify no
394
395
  # parameters, or to keep all the default parameter values, pass an empty Hash.
395
- # @param options [Gapic::CallOptions, Hash]
396
+ # @param options [::Gapic::CallOptions, ::Hash]
396
397
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
397
398
  #
398
399
  # @overload analyze_syntax(document: nil, encoding_type: nil)
@@ -400,32 +401,32 @@ module Google
400
401
  # least one keyword argument is required. To specify no parameters, or to keep all
401
402
  # the default parameter values, pass an empty Hash as a request object (see above).
402
403
  #
403
- # @param document [Google::Cloud::Language::V1beta2::Document, Hash]
404
+ # @param document [::Google::Cloud::Language::V1beta2::Document, ::Hash]
404
405
  # Required. Input document.
405
- # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
406
+ # @param encoding_type [::Google::Cloud::Language::V1beta2::EncodingType]
406
407
  # The encoding type used by the API to calculate offsets.
407
408
  #
408
409
  # @yield [response, operation] Access the result along with the RPC operation
409
- # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeSyntaxResponse]
410
- # @yieldparam operation [GRPC::ActiveCall::Operation]
410
+ # @yieldparam response [::Google::Cloud::Language::V1beta2::AnalyzeSyntaxResponse]
411
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
411
412
  #
412
- # @return [Google::Cloud::Language::V1beta2::AnalyzeSyntaxResponse]
413
+ # @return [::Google::Cloud::Language::V1beta2::AnalyzeSyntaxResponse]
413
414
  #
414
- # @raise [Google::Cloud::Error] if the RPC is aborted.
415
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
415
416
  #
416
417
  def analyze_syntax request, options = nil
417
- raise ArgumentError, "request must be provided" if request.nil?
418
+ raise ::ArgumentError, "request must be provided" if request.nil?
418
419
 
419
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest
420
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest
420
421
 
421
422
  # Converts hash and nil to an options object
422
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
423
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
423
424
 
424
425
  # Customize the options with defaults
425
426
  metadata = @config.rpcs.analyze_syntax.metadata.to_h
426
427
 
427
428
  # Set x-goog-api-client and x-goog-user-project headers
428
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
429
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
429
430
  lib_name: @config.lib_name, lib_version: @config.lib_version,
430
431
  gapic_version: ::Google::Cloud::Language::V1beta2::VERSION
431
432
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -440,8 +441,8 @@ module Google
440
441
  yield response, operation if block_given?
441
442
  return response
442
443
  end
443
- rescue GRPC::BadStatus => e
444
- raise Google::Cloud::Error.from_error(e)
444
+ rescue ::GRPC::BadStatus => e
445
+ raise ::Google::Cloud::Error.from_error(e)
445
446
  end
446
447
 
447
448
  ##
@@ -449,12 +450,12 @@ module Google
449
450
  #
450
451
  # @overload classify_text(request, options = nil)
451
452
  # Pass arguments to `classify_text` via a request object, either of type
452
- # {Google::Cloud::Language::V1beta2::ClassifyTextRequest} or an equivalent Hash.
453
+ # {::Google::Cloud::Language::V1beta2::ClassifyTextRequest} or an equivalent Hash.
453
454
  #
454
- # @param request [Google::Cloud::Language::V1beta2::ClassifyTextRequest, Hash]
455
+ # @param request [::Google::Cloud::Language::V1beta2::ClassifyTextRequest, ::Hash]
455
456
  # A request object representing the call parameters. Required. To specify no
456
457
  # parameters, or to keep all the default parameter values, pass an empty Hash.
457
- # @param options [Gapic::CallOptions, Hash]
458
+ # @param options [::Gapic::CallOptions, ::Hash]
458
459
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
459
460
  #
460
461
  # @overload classify_text(document: nil)
@@ -462,30 +463,30 @@ module Google
462
463
  # least one keyword argument is required. To specify no parameters, or to keep all
463
464
  # the default parameter values, pass an empty Hash as a request object (see above).
464
465
  #
465
- # @param document [Google::Cloud::Language::V1beta2::Document, Hash]
466
+ # @param document [::Google::Cloud::Language::V1beta2::Document, ::Hash]
466
467
  # Required. Input document.
467
468
  #
468
469
  # @yield [response, operation] Access the result along with the RPC operation
469
- # @yieldparam response [Google::Cloud::Language::V1beta2::ClassifyTextResponse]
470
- # @yieldparam operation [GRPC::ActiveCall::Operation]
470
+ # @yieldparam response [::Google::Cloud::Language::V1beta2::ClassifyTextResponse]
471
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
471
472
  #
472
- # @return [Google::Cloud::Language::V1beta2::ClassifyTextResponse]
473
+ # @return [::Google::Cloud::Language::V1beta2::ClassifyTextResponse]
473
474
  #
474
- # @raise [Google::Cloud::Error] if the RPC is aborted.
475
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
475
476
  #
476
477
  def classify_text request, options = nil
477
- raise ArgumentError, "request must be provided" if request.nil?
478
+ raise ::ArgumentError, "request must be provided" if request.nil?
478
479
 
479
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1beta2::ClassifyTextRequest
480
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1beta2::ClassifyTextRequest
480
481
 
481
482
  # Converts hash and nil to an options object
482
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
483
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
483
484
 
484
485
  # Customize the options with defaults
485
486
  metadata = @config.rpcs.classify_text.metadata.to_h
486
487
 
487
488
  # Set x-goog-api-client and x-goog-user-project headers
488
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
489
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
489
490
  lib_name: @config.lib_name, lib_version: @config.lib_version,
490
491
  gapic_version: ::Google::Cloud::Language::V1beta2::VERSION
491
492
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -500,8 +501,8 @@ module Google
500
501
  yield response, operation if block_given?
501
502
  return response
502
503
  end
503
- rescue GRPC::BadStatus => e
504
- raise Google::Cloud::Error.from_error(e)
504
+ rescue ::GRPC::BadStatus => e
505
+ raise ::Google::Cloud::Error.from_error(e)
505
506
  end
506
507
 
507
508
  ##
@@ -510,12 +511,12 @@ module Google
510
511
  #
511
512
  # @overload annotate_text(request, options = nil)
512
513
  # Pass arguments to `annotate_text` via a request object, either of type
513
- # {Google::Cloud::Language::V1beta2::AnnotateTextRequest} or an equivalent Hash.
514
+ # {::Google::Cloud::Language::V1beta2::AnnotateTextRequest} or an equivalent Hash.
514
515
  #
515
- # @param request [Google::Cloud::Language::V1beta2::AnnotateTextRequest, Hash]
516
+ # @param request [::Google::Cloud::Language::V1beta2::AnnotateTextRequest, ::Hash]
516
517
  # A request object representing the call parameters. Required. To specify no
517
518
  # parameters, or to keep all the default parameter values, pass an empty Hash.
518
- # @param options [Gapic::CallOptions, Hash]
519
+ # @param options [::Gapic::CallOptions, ::Hash]
519
520
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
520
521
  #
521
522
  # @overload annotate_text(document: nil, features: nil, encoding_type: nil)
@@ -523,34 +524,34 @@ module Google
523
524
  # least one keyword argument is required. To specify no parameters, or to keep all
524
525
  # the default parameter values, pass an empty Hash as a request object (see above).
525
526
  #
526
- # @param document [Google::Cloud::Language::V1beta2::Document, Hash]
527
+ # @param document [::Google::Cloud::Language::V1beta2::Document, ::Hash]
527
528
  # Required. Input document.
528
- # @param features [Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features, Hash]
529
+ # @param features [::Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features, ::Hash]
529
530
  # Required. The enabled features.
530
- # @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
531
+ # @param encoding_type [::Google::Cloud::Language::V1beta2::EncodingType]
531
532
  # The encoding type used by the API to calculate offsets.
532
533
  #
533
534
  # @yield [response, operation] Access the result along with the RPC operation
534
- # @yieldparam response [Google::Cloud::Language::V1beta2::AnnotateTextResponse]
535
- # @yieldparam operation [GRPC::ActiveCall::Operation]
535
+ # @yieldparam response [::Google::Cloud::Language::V1beta2::AnnotateTextResponse]
536
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
536
537
  #
537
- # @return [Google::Cloud::Language::V1beta2::AnnotateTextResponse]
538
+ # @return [::Google::Cloud::Language::V1beta2::AnnotateTextResponse]
538
539
  #
539
- # @raise [Google::Cloud::Error] if the RPC is aborted.
540
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
540
541
  #
541
542
  def annotate_text request, options = nil
542
- raise ArgumentError, "request must be provided" if request.nil?
543
+ raise ::ArgumentError, "request must be provided" if request.nil?
543
544
 
544
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Language::V1beta2::AnnotateTextRequest
545
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Language::V1beta2::AnnotateTextRequest
545
546
 
546
547
  # Converts hash and nil to an options object
547
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
548
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
548
549
 
549
550
  # Customize the options with defaults
550
551
  metadata = @config.rpcs.annotate_text.metadata.to_h
551
552
 
552
553
  # Set x-goog-api-client and x-goog-user-project headers
553
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
554
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
554
555
  lib_name: @config.lib_name, lib_version: @config.lib_version,
555
556
  gapic_version: ::Google::Cloud::Language::V1beta2::VERSION
556
557
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -565,8 +566,8 @@ module Google
565
566
  yield response, operation if block_given?
566
567
  return response
567
568
  end
568
- rescue GRPC::BadStatus => e
569
- raise Google::Cloud::Error.from_error(e)
569
+ rescue ::GRPC::BadStatus => e
570
+ raise ::Google::Cloud::Error.from_error(e)
570
571
  end
571
572
 
572
573
  ##
@@ -576,7 +577,7 @@ module Google
576
577
  # providing control over timeouts, retry behavior, logging, transport
577
578
  # parameters, and other low-level controls. Certain parameters can also be
578
579
  # applied individually to specific RPCs. See
579
- # {Google::Cloud::Language::V1beta2::LanguageService::Client::Configuration::Rpcs}
580
+ # {::Google::Cloud::Language::V1beta2::LanguageService::Client::Configuration::Rpcs}
580
581
  # for a list of RPCs that can be configured independently.
581
582
  #
582
583
  # Configuration can be applied globally to all clients, or to a single client
@@ -587,22 +588,22 @@ module Google
587
588
  # To modify the global config, setting the timeout for analyze_sentiment
588
589
  # to 20 seconds, and all remaining timeouts to 10 seconds:
589
590
  #
590
- # Google::Cloud::Language::V1beta2::LanguageService::Client.configure do |config|
591
- # config.timeout = 10_000
592
- # config.rpcs.analyze_sentiment.timeout = 20_000
591
+ # ::Google::Cloud::Language::V1beta2::LanguageService::Client.configure do |config|
592
+ # config.timeout = 10.0
593
+ # config.rpcs.analyze_sentiment.timeout = 20.0
593
594
  # end
594
595
  #
595
596
  # To apply the above configuration only to a new client:
596
597
  #
597
- # client = Google::Cloud::Language::V1beta2::LanguageService::Client.new do |config|
598
- # config.timeout = 10_000
599
- # config.rpcs.analyze_sentiment.timeout = 20_000
598
+ # client = ::Google::Cloud::Language::V1beta2::LanguageService::Client.new do |config|
599
+ # config.timeout = 10.0
600
+ # config.rpcs.analyze_sentiment.timeout = 20.0
600
601
  # end
601
602
  #
602
603
  # @!attribute [rw] endpoint
603
604
  # The hostname or hostname:port of the service endpoint.
604
605
  # Defaults to `"language.googleapis.com"`.
605
- # @return [String]
606
+ # @return [::String]
606
607
  # @!attribute [rw] credentials
607
608
  # Credentials to send with calls. You may provide any of the following types:
608
609
  # * (`String`) The path to a service account key file in JSON format
@@ -614,29 +615,29 @@ module Google
614
615
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
615
616
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
616
617
  # * (`nil`) indicating no credentials
617
- # @return [Object]
618
+ # @return [::Object]
618
619
  # @!attribute [rw] scope
619
620
  # The OAuth scopes
620
- # @return [Array<String>]
621
+ # @return [::Array<::String>]
621
622
  # @!attribute [rw] lib_name
622
623
  # The library name as recorded in instrumentation and logging
623
- # @return [String]
624
+ # @return [::String]
624
625
  # @!attribute [rw] lib_version
625
626
  # The library version as recorded in instrumentation and logging
626
- # @return [String]
627
+ # @return [::String]
627
628
  # @!attribute [rw] channel_args
628
629
  # Extra parameters passed to the gRPC channel. Note: this is ignored if a
629
630
  # `GRPC::Core::Channel` object is provided as the credential.
630
- # @return [Hash]
631
+ # @return [::Hash]
631
632
  # @!attribute [rw] interceptors
632
633
  # An array of interceptors that are run before calls are executed.
633
- # @return [Array<GRPC::ClientInterceptor>]
634
+ # @return [::Array<::GRPC::ClientInterceptor>]
634
635
  # @!attribute [rw] timeout
635
- # The call timeout in milliseconds.
636
- # @return [Numeric]
636
+ # The call timeout in seconds.
637
+ # @return [::Numeric]
637
638
  # @!attribute [rw] metadata
638
639
  # Additional gRPC headers to be sent with the call.
639
- # @return [Hash{Symbol=>String}]
640
+ # @return [::Hash{::Symbol=>::String}]
640
641
  # @!attribute [rw] retry_policy
641
642
  # The retry policy. The value is a hash with the following keys:
642
643
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
@@ -644,25 +645,29 @@ module Google
644
645
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
645
646
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
646
647
  # trigger a retry.
647
- # @return [Hash]
648
+ # @return [::Hash]
649
+ # @!attribute [rw] quota_project
650
+ # A separate project against which to charge quota.
651
+ # @return [::String]
648
652
  #
649
653
  class Configuration
650
- extend Gapic::Config
654
+ extend ::Gapic::Config
651
655
 
652
- config_attr :endpoint, "language.googleapis.com", String
653
- config_attr :credentials, nil do |value|
656
+ config_attr :endpoint, "language.googleapis.com", ::String
657
+ config_attr :credentials, nil do |value|
654
658
  allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
655
659
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
656
660
  allowed.any? { |klass| klass === value }
657
661
  end
658
- config_attr :scope, nil, String, Array, nil
659
- config_attr :lib_name, nil, String, nil
660
- config_attr :lib_version, nil, String, nil
661
- config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
662
- config_attr :interceptors, nil, Array, nil
663
- config_attr :timeout, nil, Numeric, nil
664
- config_attr :metadata, nil, Hash, nil
665
- config_attr :retry_policy, nil, Hash, Proc, nil
662
+ config_attr :scope, nil, ::String, ::Array, nil
663
+ config_attr :lib_name, nil, ::String, nil
664
+ config_attr :lib_version, nil, ::String, nil
665
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
666
+ config_attr :interceptors, nil, ::Array, nil
667
+ config_attr :timeout, nil, ::Numeric, nil
668
+ config_attr :metadata, nil, ::Hash, nil
669
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
670
+ config_attr :quota_project, nil, ::String, nil
666
671
 
667
672
  # @private
668
673
  def initialize parent_config = nil
@@ -678,7 +683,7 @@ module Google
678
683
  def rpcs
679
684
  @rpcs ||= begin
680
685
  parent_rpcs = nil
681
- parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
686
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
682
687
  Rpcs.new parent_rpcs
683
688
  end
684
689
  end
@@ -703,49 +708,49 @@ module Google
703
708
  class Rpcs
704
709
  ##
705
710
  # RPC-specific configuration for `analyze_sentiment`
706
- # @return [Gapic::Config::Method]
711
+ # @return [::Gapic::Config::Method]
707
712
  #
708
713
  attr_reader :analyze_sentiment
709
714
  ##
710
715
  # RPC-specific configuration for `analyze_entities`
711
- # @return [Gapic::Config::Method]
716
+ # @return [::Gapic::Config::Method]
712
717
  #
713
718
  attr_reader :analyze_entities
714
719
  ##
715
720
  # RPC-specific configuration for `analyze_entity_sentiment`
716
- # @return [Gapic::Config::Method]
721
+ # @return [::Gapic::Config::Method]
717
722
  #
718
723
  attr_reader :analyze_entity_sentiment
719
724
  ##
720
725
  # RPC-specific configuration for `analyze_syntax`
721
- # @return [Gapic::Config::Method]
726
+ # @return [::Gapic::Config::Method]
722
727
  #
723
728
  attr_reader :analyze_syntax
724
729
  ##
725
730
  # RPC-specific configuration for `classify_text`
726
- # @return [Gapic::Config::Method]
731
+ # @return [::Gapic::Config::Method]
727
732
  #
728
733
  attr_reader :classify_text
729
734
  ##
730
735
  # RPC-specific configuration for `annotate_text`
731
- # @return [Gapic::Config::Method]
736
+ # @return [::Gapic::Config::Method]
732
737
  #
733
738
  attr_reader :annotate_text
734
739
 
735
740
  # @private
736
741
  def initialize parent_rpcs = nil
737
742
  analyze_sentiment_config = parent_rpcs&.analyze_sentiment if parent_rpcs&.respond_to? :analyze_sentiment
738
- @analyze_sentiment = Gapic::Config::Method.new analyze_sentiment_config
743
+ @analyze_sentiment = ::Gapic::Config::Method.new analyze_sentiment_config
739
744
  analyze_entities_config = parent_rpcs&.analyze_entities if parent_rpcs&.respond_to? :analyze_entities
740
- @analyze_entities = Gapic::Config::Method.new analyze_entities_config
745
+ @analyze_entities = ::Gapic::Config::Method.new analyze_entities_config
741
746
  analyze_entity_sentiment_config = parent_rpcs&.analyze_entity_sentiment if parent_rpcs&.respond_to? :analyze_entity_sentiment
742
- @analyze_entity_sentiment = Gapic::Config::Method.new analyze_entity_sentiment_config
747
+ @analyze_entity_sentiment = ::Gapic::Config::Method.new analyze_entity_sentiment_config
743
748
  analyze_syntax_config = parent_rpcs&.analyze_syntax if parent_rpcs&.respond_to? :analyze_syntax
744
- @analyze_syntax = Gapic::Config::Method.new analyze_syntax_config
749
+ @analyze_syntax = ::Gapic::Config::Method.new analyze_syntax_config
745
750
  classify_text_config = parent_rpcs&.classify_text if parent_rpcs&.respond_to? :classify_text
746
- @classify_text = Gapic::Config::Method.new classify_text_config
751
+ @classify_text = ::Gapic::Config::Method.new classify_text_config
747
752
  annotate_text_config = parent_rpcs&.annotate_text if parent_rpcs&.respond_to? :annotate_text
748
- @annotate_text = Gapic::Config::Method.new annotate_text_config
753
+ @annotate_text = ::Gapic::Config::Method.new annotate_text_config
749
754
 
750
755
  yield self if block_given?
751
756
  end