google-cloud-vision-v1p3beta1 0.1.2 → 0.2.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +6 -6
  3. data/README.md +48 -1
  4. data/lib/google-cloud-vision-v1p3beta1.rb +21 -1
  5. data/lib/google/cloud/vision/v1p3beta1.rb +16 -0
  6. data/lib/google/cloud/vision/v1p3beta1/image_annotator.rb +33 -2
  7. data/lib/google/cloud/vision/v1p3beta1/image_annotator/client.rb +101 -97
  8. data/lib/google/cloud/vision/v1p3beta1/image_annotator/credentials.rb +1 -1
  9. data/lib/google/cloud/vision/v1p3beta1/image_annotator/operations.rb +139 -127
  10. data/lib/google/cloud/vision/v1p3beta1/image_annotator/paths.rb +3 -3
  11. data/lib/google/cloud/vision/v1p3beta1/product_search.rb +44 -2
  12. data/lib/google/cloud/vision/v1p3beta1/product_search/client.rb +500 -508
  13. data/lib/google/cloud/vision/v1p3beta1/product_search/credentials.rb +1 -1
  14. data/lib/google/cloud/vision/v1p3beta1/product_search/operations.rb +139 -127
  15. data/lib/google/cloud/vision/v1p3beta1/product_search/paths.rb +12 -12
  16. data/lib/google/cloud/vision/v1p3beta1/version.rb +1 -1
  17. data/proto_docs/google/api/resource.rb +12 -12
  18. data/proto_docs/google/cloud/vision/v1p3beta1/geometry.rb +20 -20
  19. data/proto_docs/google/cloud/vision/v1p3beta1/image_annotator.rb +172 -172
  20. data/proto_docs/google/cloud/vision/v1p3beta1/product_search.rb +29 -29
  21. data/proto_docs/google/cloud/vision/v1p3beta1/product_search_service.rb +133 -133
  22. data/proto_docs/google/cloud/vision/v1p3beta1/text_annotation.rb +49 -49
  23. data/proto_docs/google/cloud/vision/v1p3beta1/web_detection.rb +28 -28
  24. data/proto_docs/google/longrunning/operations.rb +30 -30
  25. data/proto_docs/google/protobuf/any.rb +4 -4
  26. data/proto_docs/google/protobuf/empty.rb +2 -2
  27. data/proto_docs/google/protobuf/field_mask.rb +3 -3
  28. data/proto_docs/google/protobuf/timestamp.rb +4 -4
  29. data/proto_docs/google/protobuf/wrappers.rb +27 -27
  30. data/proto_docs/google/rpc/status.rb +6 -6
  31. data/proto_docs/google/type/color.rb +6 -6
  32. data/proto_docs/google/type/latlng.rb +4 -4
  33. metadata +32 -5
  34. 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: 25118e68e965d6aebbca33c568d3fc84ed0efb2a6e0a3e8c4a549a8807187234
4
- data.tar.gz: 9b577372473b092181d1f98df6b39ea0056a0c28079762cf01855ab8c80393f7
3
+ metadata.gz: bed8eb28908c3841ce50dfe2d626b437d214adddea0b2ccda921f6fe817f0d38
4
+ data.tar.gz: cf1ca2243e106768e301d541eacb922e28a660376eae64da343c5e666b990577
5
5
  SHA512:
6
- metadata.gz: d809982791134291d7ac7be1f5872766a81a5acf649040d4909eb6300f3d3712065cddfad19944e6af4e218d550f5bbb4463dda289776a4f3df18dc384c94794
7
- data.tar.gz: d17281f9a9cad8f027a65241d855bc70cb4db3fa6b570c27462eeda9a3d40d5663d9c2d851c82808f04f67865c0a83877340380c52fd16e9cf27c0e11150f753
6
+ metadata.gz: 32649728fca3d917fb6b91f0e19df61856fe109639e012052e09a5faa6464e2596a17ec2ba9a82fd99705d1c5589eeef0f7ea2906323e57081357b508365b506
7
+ data.tar.gz: 6b6f718c41497a9d56a97c032889f6bc185a609db794aa180212aec71a31e9ceb77eeaf3d225e826919f74b13f6caef857807acf4e678f116aefcf04174c46e3
@@ -27,7 +27,7 @@ export VISION_CREDENTIALS=path/to/keyfile.json
27
27
  ```ruby
28
28
  require "google/cloud/vision/v1p3beta1"
29
29
 
30
- client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
30
+ client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::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-vision-v1p3beta1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
- {Google::Cloud::Vision::V1p3beta1::ProductSearch::Credentials}):
67
+ {::Google::Cloud::Vision::V1p3beta1::ProductSearch::Credentials}):
68
68
 
69
69
  1. `VISION_CREDENTIALS` - Path to JSON file, or JSON contents
70
70
  2. `VISION_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/vision/v1p3beta1"
77
77
 
78
78
  ENV["VISION_CREDENTIALS"] = "path/to/keyfile.json"
79
79
 
80
- client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
80
+ client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::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/vision/v1p3beta1"
90
90
 
91
- client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new do |config|
91
+ client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::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/vision/v1p3beta1"
100
100
 
101
- Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.configure do |config|
101
+ ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.configure do |config|
102
102
  config.credentials = "path/to/keyfile.json"
103
103
  end
104
104
 
105
- client = Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
105
+ client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
106
106
  ```
107
107
 
108
108
  ### Cloud SDK
data/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # Cloud Vision V1p3beta1
1
+ # Ruby Client for the Cloud Vision V1p3beta1 API
2
2
 
3
3
  API Client library for the Cloud Vision V1p3beta1 API
4
4
 
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
12
12
  $ gem install google-cloud-vision-v1p3beta1
13
13
  ```
14
14
 
15
+ ## Before You Begin
16
+
17
+ In order to use this library, you first need to go through the following steps:
18
+
19
+ 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
20
+ 1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
21
+ 1. {file:AUTHENTICATION.md Set up authentication.}
22
+
23
+ ## Quick Start
24
+
25
+ ```ruby
26
+ require "google/cloud/vision/v1p3beta1"
27
+
28
+ client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
29
+ request = my_create_request
30
+ response = client.create_product_set request
31
+ ```
32
+
33
+ View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-vision-v1p3beta1/latest)
34
+ for class and method documentation.
35
+
36
+ ## Enabling Logging
37
+
38
+ To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
39
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
40
+ or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
41
+ 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)
42
+ and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
43
+
44
+ Configuring a Ruby stdlib logger:
45
+
46
+ ```ruby
47
+ require "logger"
48
+
49
+ module MyLogger
50
+ LOGGER = Logger.new $stderr, level: Logger::WARN
51
+ def logger
52
+ LOGGER
53
+ end
54
+ end
55
+
56
+ # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
57
+ module GRPC
58
+ extend MyLogger
59
+ end
60
+ ```
61
+
15
62
  ## Supported Ruby Versions
16
63
 
17
64
  This library is supported on Ruby 2.4+.
@@ -1 +1,21 @@
1
- require "google/cloud/vision/v1p3beta1/version"
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ # This gem does not autoload during Bundler.require. To load this gem,
20
+ # issue explicit require statements for the packages desired, e.g.:
21
+ # require "google/cloud/vision/v1p3beta1"
@@ -18,3 +18,19 @@
18
18
 
19
19
  require "google/cloud/vision/v1p3beta1/product_search"
20
20
  require "google/cloud/vision/v1p3beta1/image_annotator"
21
+ require "google/cloud/vision/v1p3beta1/version"
22
+
23
+ module Google
24
+ module Cloud
25
+ module Vision
26
+ ##
27
+ # To load this package, including all its services, and instantiate a client:
28
+ #
29
+ # require "google/cloud/vision/v1p3beta1"
30
+ # client = ::Google::Cloud::Vision::V1p3beta1::ProductSearch::Client.new
31
+ #
32
+ module V1p3beta1
33
+ end
34
+ end
35
+ end
36
+ end
@@ -16,6 +16,37 @@
16
16
 
17
17
  # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
18
 
19
- require "google/cloud/vision/v1p3beta1/image_annotator/client"
20
- require "google/cloud/vision/v1p3beta1/image_annotator/operations"
19
+ require "gapic/common"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/vision/v1p3beta1/version"
24
+
21
25
  require "google/cloud/vision/v1p3beta1/image_annotator/credentials"
26
+ require "google/cloud/vision/v1p3beta1/image_annotator/paths"
27
+ require "google/cloud/vision/v1p3beta1/image_annotator/operations"
28
+ require "google/cloud/vision/v1p3beta1/image_annotator/client"
29
+
30
+ module Google
31
+ module Cloud
32
+ module Vision
33
+ module V1p3beta1
34
+ ##
35
+ # Service that performs Google Cloud Vision API detection tasks over client
36
+ # images, such as face, landmark, logo, label, and text detection. The
37
+ # ImageAnnotator service returns detected entities from the images.
38
+ #
39
+ # To load this service and instantiate a client:
40
+ #
41
+ # require "google/cloud/vision/v1p3beta1/image_annotator"
42
+ # client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new
43
+ #
44
+ module ImageAnnotator
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
50
+
51
+ helper_path = ::File.join __dir__, "image_annotator", "helpers.rb"
52
+ require "google/cloud/vision/v1p3beta1/image_annotator/helpers" if ::File.file? helper_path
@@ -16,16 +16,8 @@
16
16
 
17
17
  # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
18
 
19
- require "gapic/common"
20
- require "gapic/config"
21
- require "gapic/config/method"
22
-
23
19
  require "google/cloud/errors"
24
- require "google/cloud/vision/v1p3beta1/version"
25
20
  require "google/cloud/vision/v1p3beta1/image_annotator_pb"
26
- require "google/cloud/vision/v1p3beta1/image_annotator/credentials"
27
- require "google/cloud/vision/v1p3beta1/image_annotator/paths"
28
- require "google/cloud/vision/v1p3beta1/image_annotator/operations"
29
21
 
30
22
  module Google
31
23
  module Cloud
@@ -48,15 +40,15 @@ module Google
48
40
  ##
49
41
  # Configure the ImageAnnotator Client class.
50
42
  #
51
- # See {Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
43
+ # See {::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
52
44
  # for a description of the configuration fields.
53
45
  #
54
46
  # ## Example
55
47
  #
56
48
  # To modify the configuration for all ImageAnnotator clients:
57
49
  #
58
- # Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
59
- # config.timeout = 10_000
50
+ # ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
51
+ # config.timeout = 10.0
60
52
  # end
61
53
  #
62
54
  # @yield [config] Configure the Client client.
@@ -104,7 +96,7 @@ module Google
104
96
  # but structural changes (adding new fields, etc.) are not allowed. Structural changes
105
97
  # should be made on {Client.configure}.
106
98
  #
107
- # See {Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
99
+ # See {::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration}
108
100
  # for a description of the configuration fields.
109
101
  #
110
102
  # @yield [config] Configure the Client client.
@@ -125,13 +117,13 @@ module Google
125
117
  # To create a new ImageAnnotator client with the default
126
118
  # configuration:
127
119
  #
128
- # client = Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new
120
+ # client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new
129
121
  #
130
122
  # To create a new ImageAnnotator client with a custom
131
123
  # configuration:
132
124
  #
133
- # client = Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
134
- # config.timeout = 10_000
125
+ # client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
126
+ # config.timeout = 10.0
135
127
  # end
136
128
  #
137
129
  # @yield [config] Configure the ImageAnnotator client.
@@ -156,14 +148,16 @@ module Google
156
148
  if credentials.is_a?(String) || credentials.is_a?(Hash)
157
149
  credentials = Credentials.new credentials, scope: @config.scope
158
150
  end
159
- @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
151
+ @quota_project_id = @config.quota_project
152
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
160
153
 
161
154
  @operations_client = Operations.new do |config|
162
155
  config.credentials = credentials
156
+ config.endpoint = @config.endpoint
163
157
  end
164
158
 
165
- @image_annotator_stub = Gapic::ServiceStub.new(
166
- Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Stub,
159
+ @image_annotator_stub = ::Gapic::ServiceStub.new(
160
+ ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Stub,
167
161
  credentials: credentials,
168
162
  endpoint: @config.endpoint,
169
163
  channel_args: @config.channel_args,
@@ -171,43 +165,57 @@ module Google
171
165
  )
172
166
  end
173
167
 
168
+ ##
169
+ # Get the associated client for long-running operations.
170
+ #
171
+ # @return [::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Operations]
172
+ #
173
+ attr_reader :operations_client
174
+
174
175
  # Service calls
175
176
 
176
177
  ##
177
178
  # Run image detection and annotation for a batch of images.
178
179
  #
179
180
  # @overload batch_annotate_images(request, options = nil)
180
- # @param request [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest | Hash]
181
- # Run image detection and annotation for a batch of images.
182
- # @param options [Gapic::CallOptions, Hash]
181
+ # Pass arguments to `batch_annotate_images` via a request object, either of type
182
+ # {::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest} or an equivalent Hash.
183
+ #
184
+ # @param request [::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest, ::Hash]
185
+ # A request object representing the call parameters. Required. To specify no
186
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
187
+ # @param options [::Gapic::CallOptions, ::Hash]
183
188
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
184
189
  #
185
190
  # @overload batch_annotate_images(requests: nil)
186
- # @param requests [Array<Google::Cloud::Vision::V1p3beta1::AnnotateImageRequest | Hash>]
187
- # Individual image annotation requests for this batch.
191
+ # Pass arguments to `batch_annotate_images` via keyword arguments. Note that at
192
+ # least one keyword argument is required. To specify no parameters, or to keep all
193
+ # the default parameter values, pass an empty Hash as a request object (see above).
188
194
  #
195
+ # @param requests [::Array<::Google::Cloud::Vision::V1p3beta1::AnnotateImageRequest, ::Hash>]
196
+ # Individual image annotation requests for this batch.
189
197
  #
190
198
  # @yield [response, operation] Access the result along with the RPC operation
191
- # @yieldparam response [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
192
- # @yieldparam operation [GRPC::ActiveCall::Operation]
199
+ # @yieldparam response [::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
200
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
193
201
  #
194
- # @return [Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
202
+ # @return [::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesResponse]
195
203
  #
196
- # @raise [Google::Cloud::Error] if the RPC is aborted.
204
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
197
205
  #
198
206
  def batch_annotate_images request, options = nil
199
- raise ArgumentError, "request must be provided" if request.nil?
207
+ raise ::ArgumentError, "request must be provided" if request.nil?
200
208
 
201
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest
209
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Vision::V1p3beta1::BatchAnnotateImagesRequest
202
210
 
203
211
  # Converts hash and nil to an options object
204
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
212
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
205
213
 
206
214
  # Customize the options with defaults
207
215
  metadata = @config.rpcs.batch_annotate_images.metadata.to_h
208
216
 
209
217
  # Set x-goog-api-client and x-goog-user-project headers
210
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
218
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
211
219
  lib_name: @config.lib_name, lib_version: @config.lib_version,
212
220
  gapic_version: ::Google::Cloud::Vision::V1p3beta1::VERSION
213
221
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -222,8 +230,8 @@ module Google
222
230
  yield response, operation if block_given?
223
231
  return response
224
232
  end
225
- rescue GRPC::BadStatus => e
226
- raise Google::Cloud::Error.from_error(e)
233
+ rescue ::GRPC::BadStatus => e
234
+ raise ::Google::Cloud::Error.from_error(e)
227
235
  end
228
236
 
229
237
  ##
@@ -235,42 +243,44 @@ module Google
235
243
  # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
236
244
  #
237
245
  # @overload async_batch_annotate_files(request, options = nil)
238
- # @param request [Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest | Hash]
239
- # Run asynchronous image detection and annotation for a list of generic
240
- # files, such as PDF files, which may contain multiple pages and multiple
241
- # images per page. Progress and results can be retrieved through the
242
- # `google.longrunning.Operations` interface.
243
- # `Operation.metadata` contains `OperationMetadata` (metadata).
244
- # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
245
- # @param options [Gapic::CallOptions, Hash]
246
+ # Pass arguments to `async_batch_annotate_files` via a request object, either of type
247
+ # {::Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest} or an equivalent Hash.
248
+ #
249
+ # @param request [::Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest, ::Hash]
250
+ # A request object representing the call parameters. Required. To specify no
251
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
252
+ # @param options [::Gapic::CallOptions, ::Hash]
246
253
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
247
254
  #
248
255
  # @overload async_batch_annotate_files(requests: nil)
249
- # @param requests [Array<Google::Cloud::Vision::V1p3beta1::AsyncAnnotateFileRequest | Hash>]
250
- # Required. Individual async file annotation requests for this batch.
256
+ # Pass arguments to `async_batch_annotate_files` via keyword arguments. Note that at
257
+ # least one keyword argument is required. To specify no parameters, or to keep all
258
+ # the default parameter values, pass an empty Hash as a request object (see above).
251
259
  #
260
+ # @param requests [::Array<::Google::Cloud::Vision::V1p3beta1::AsyncAnnotateFileRequest, ::Hash>]
261
+ # Required. Individual async file annotation requests for this batch.
252
262
  #
253
263
  # @yield [response, operation] Access the result along with the RPC operation
254
- # @yieldparam response [Gapic::Operation]
255
- # @yieldparam operation [GRPC::ActiveCall::Operation]
264
+ # @yieldparam response [::Gapic::Operation]
265
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
256
266
  #
257
- # @return [Gapic::Operation]
267
+ # @return [::Gapic::Operation]
258
268
  #
259
- # @raise [Google::Cloud::Error] if the RPC is aborted.
269
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
260
270
  #
261
271
  def async_batch_annotate_files request, options = nil
262
- raise ArgumentError, "request must be provided" if request.nil?
272
+ raise ::ArgumentError, "request must be provided" if request.nil?
263
273
 
264
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest
274
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Vision::V1p3beta1::AsyncBatchAnnotateFilesRequest
265
275
 
266
276
  # Converts hash and nil to an options object
267
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
277
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
268
278
 
269
279
  # Customize the options with defaults
270
280
  metadata = @config.rpcs.async_batch_annotate_files.metadata.to_h
271
281
 
272
282
  # Set x-goog-api-client and x-goog-user-project headers
273
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
283
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
274
284
  lib_name: @config.lib_name, lib_version: @config.lib_version,
275
285
  gapic_version: ::Google::Cloud::Vision::V1p3beta1::VERSION
276
286
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -282,12 +292,12 @@ module Google
282
292
  retry_policy: @config.retry_policy
283
293
 
284
294
  @image_annotator_stub.call_rpc :async_batch_annotate_files, request, options: options do |response, operation|
285
- response = Gapic::Operation.new response, @operations_client, options: options
295
+ response = ::Gapic::Operation.new response, @operations_client, options: options
286
296
  yield response, operation if block_given?
287
297
  return response
288
298
  end
289
- rescue GRPC::BadStatus => e
290
- raise Google::Cloud::Error.from_error(e)
299
+ rescue ::GRPC::BadStatus => e
300
+ raise ::Google::Cloud::Error.from_error(e)
291
301
  end
292
302
 
293
303
  ##
@@ -297,7 +307,7 @@ module Google
297
307
  # providing control over timeouts, retry behavior, logging, transport
298
308
  # parameters, and other low-level controls. Certain parameters can also be
299
309
  # applied individually to specific RPCs. See
300
- # {Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration::Rpcs}
310
+ # {::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client::Configuration::Rpcs}
301
311
  # for a list of RPCs that can be configured independently.
302
312
  #
303
313
  # Configuration can be applied globally to all clients, or to a single client
@@ -308,22 +318,22 @@ module Google
308
318
  # To modify the global config, setting the timeout for batch_annotate_images
309
319
  # to 20 seconds, and all remaining timeouts to 10 seconds:
310
320
  #
311
- # Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
312
- # config.timeout = 10_000
313
- # config.rpcs.batch_annotate_images.timeout = 20_000
321
+ # ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.configure do |config|
322
+ # config.timeout = 10.0
323
+ # config.rpcs.batch_annotate_images.timeout = 20.0
314
324
  # end
315
325
  #
316
326
  # To apply the above configuration only to a new client:
317
327
  #
318
- # client = Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
319
- # config.timeout = 10_000
320
- # config.rpcs.batch_annotate_images.timeout = 20_000
328
+ # client = ::Google::Cloud::Vision::V1p3beta1::ImageAnnotator::Client.new do |config|
329
+ # config.timeout = 10.0
330
+ # config.rpcs.batch_annotate_images.timeout = 20.0
321
331
  # end
322
332
  #
323
333
  # @!attribute [rw] endpoint
324
334
  # The hostname or hostname:port of the service endpoint.
325
335
  # Defaults to `"vision.googleapis.com"`.
326
- # @return [String]
336
+ # @return [::String]
327
337
  # @!attribute [rw] credentials
328
338
  # Credentials to send with calls. You may provide any of the following types:
329
339
  # * (`String`) The path to a service account key file in JSON format
@@ -335,29 +345,29 @@ module Google
335
345
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
336
346
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
337
347
  # * (`nil`) indicating no credentials
338
- # @return [Object]
348
+ # @return [::Object]
339
349
  # @!attribute [rw] scope
340
350
  # The OAuth scopes
341
- # @return [Array<String>]
351
+ # @return [::Array<::String>]
342
352
  # @!attribute [rw] lib_name
343
353
  # The library name as recorded in instrumentation and logging
344
- # @return [String]
354
+ # @return [::String]
345
355
  # @!attribute [rw] lib_version
346
356
  # The library version as recorded in instrumentation and logging
347
- # @return [String]
357
+ # @return [::String]
348
358
  # @!attribute [rw] channel_args
349
359
  # Extra parameters passed to the gRPC channel. Note: this is ignored if a
350
360
  # `GRPC::Core::Channel` object is provided as the credential.
351
- # @return [Hash]
361
+ # @return [::Hash]
352
362
  # @!attribute [rw] interceptors
353
363
  # An array of interceptors that are run before calls are executed.
354
- # @return [Array<GRPC::ClientInterceptor>]
364
+ # @return [::Array<::GRPC::ClientInterceptor>]
355
365
  # @!attribute [rw] timeout
356
- # The call timeout in milliseconds.
357
- # @return [Numeric]
366
+ # The call timeout in seconds.
367
+ # @return [::Numeric]
358
368
  # @!attribute [rw] metadata
359
369
  # Additional gRPC headers to be sent with the call.
360
- # @return [Hash{Symbol=>String}]
370
+ # @return [::Hash{::Symbol=>::String}]
361
371
  # @!attribute [rw] retry_policy
362
372
  # The retry policy. The value is a hash with the following keys:
363
373
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
@@ -365,25 +375,29 @@ module Google
365
375
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
366
376
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
367
377
  # trigger a retry.
368
- # @return [Hash]
378
+ # @return [::Hash]
379
+ # @!attribute [rw] quota_project
380
+ # A separate project against which to charge quota.
381
+ # @return [::String]
369
382
  #
370
383
  class Configuration
371
- extend Gapic::Config
384
+ extend ::Gapic::Config
372
385
 
373
- config_attr :endpoint, "vision.googleapis.com", String
374
- config_attr :credentials, nil do |value|
386
+ config_attr :endpoint, "vision.googleapis.com", ::String
387
+ config_attr :credentials, nil do |value|
375
388
  allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
376
389
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
377
390
  allowed.any? { |klass| klass === value }
378
391
  end
379
- config_attr :scope, nil, String, Array, nil
380
- config_attr :lib_name, nil, String, nil
381
- config_attr :lib_version, nil, String, nil
382
- config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
383
- config_attr :interceptors, nil, Array, nil
384
- config_attr :timeout, nil, Numeric, nil
385
- config_attr :metadata, nil, Hash, nil
386
- config_attr :retry_policy, nil, Hash, Proc, nil
392
+ config_attr :scope, nil, ::String, ::Array, nil
393
+ config_attr :lib_name, nil, ::String, nil
394
+ config_attr :lib_version, nil, ::String, nil
395
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
396
+ config_attr :interceptors, nil, ::Array, nil
397
+ config_attr :timeout, nil, ::Numeric, nil
398
+ config_attr :metadata, nil, ::Hash, nil
399
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
400
+ config_attr :quota_project, nil, ::String, nil
387
401
 
388
402
  # @private
389
403
  def initialize parent_config = nil
@@ -424,21 +438,21 @@ module Google
424
438
  class Rpcs
425
439
  ##
426
440
  # RPC-specific configuration for `batch_annotate_images`
427
- # @return [Gapic::Config::Method]
441
+ # @return [::Gapic::Config::Method]
428
442
  #
429
443
  attr_reader :batch_annotate_images
430
444
  ##
431
445
  # RPC-specific configuration for `async_batch_annotate_files`
432
- # @return [Gapic::Config::Method]
446
+ # @return [::Gapic::Config::Method]
433
447
  #
434
448
  attr_reader :async_batch_annotate_files
435
449
 
436
450
  # @private
437
451
  def initialize parent_rpcs = nil
438
452
  batch_annotate_images_config = parent_rpcs&.batch_annotate_images if parent_rpcs&.respond_to? :batch_annotate_images
439
- @batch_annotate_images = Gapic::Config::Method.new batch_annotate_images_config
453
+ @batch_annotate_images = ::Gapic::Config::Method.new batch_annotate_images_config
440
454
  async_batch_annotate_files_config = parent_rpcs&.async_batch_annotate_files if parent_rpcs&.respond_to? :async_batch_annotate_files
441
- @async_batch_annotate_files = Gapic::Config::Method.new async_batch_annotate_files_config
455
+ @async_batch_annotate_files = ::Gapic::Config::Method.new async_batch_annotate_files_config
442
456
 
443
457
  yield self if block_given?
444
458
  end
@@ -450,13 +464,3 @@ module Google
450
464
  end
451
465
  end
452
466
  end
453
-
454
- # rubocop:disable Lint/HandleExceptions
455
-
456
- # Once client is loaded, load helpers.rb if it exists.
457
- begin
458
- require "google/cloud/vision/v1p3beta1/image_annotator/helpers"
459
- rescue LoadError
460
- end
461
-
462
- # rubocop:enable Lint/HandleExceptions