google-cloud-vision 0.32.3 → 0.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3e9260f0687fddb06b98ef2fe53379c06b0a3698c0c9f822c058371a63883a0
-  data.tar.gz: 22eb45350bd0589357f5d60f6282733f6acd844b56d683da727d4b4d4fc138c0
+  metadata.gz: e31522f0adb0650f2c73109c462977801780eedd5f3dd7edfa9ee79f92cb0763
+  data.tar.gz: f24cbb9a8dad4cdf92369eac010fbd6078521ef0e7aa972ac224d9b7bb6f2bd2
 SHA512:
-  metadata.gz: 62cd25a84e43db4b7fa3faa122400fd1d22f4e8782562cae2950c3e75dcaae73bd6f604259364cfe58d57a7f81ca317fe4434059fad89eaf384ee5777fcd1dd4
-  data.tar.gz: 8f8318a452e72f504726e4e7b1c9cf5fb41f98a2f582e89f32c65c5371117cd97b87a2de0e38d48c8ac214ea6e8a778ceba75415ac06598e6a8e0e471cc4197d
+  metadata.gz: 30ee67610b93fb9934ae28e233940882305a8ed366985c61aa1d994b20ab45597cc02931c842f6c8aa3ccb88d522915c97ff2ab79fa5ec300c2822003e990054
+  data.tar.gz: 1f007dd051c4aab4414e9790f16238eee6fffced7029b8bd0d1aafb34e004d2b257b42e29d97044d9cb2c105df3fadb3c85fb134acc8c06b8a9ed4b59424552f

data/README.md

@@ -1,9 +1,9 @@
 # Ruby Client for Cloud Vision API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
 
 [Cloud Vision API][Product Documentation]:
-Integrates Google Vision features, including image labeling, face, logo, and
-landmark detection, optical character recognition (OCR), and detection of
-explicit content, into applications.
+Integrates Google Vision features, including image labeling, face, logo,
+and landmark detection, optical character recognition (OCR), and detection
+of explicit content, into applications.
 - [Client Library Documentation][]
 - [Product Documentation][]
 

data/lib/google/cloud/vision.rb

@@ -24,9 +24,9 @@ module Google
     # # Ruby Client for Cloud Vision API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
     #
     # [Cloud Vision API][Product Documentation]:
-    # Integrates Google Vision features, including image labeling, face, logo, and
-    # landmark detection, optical character recognition (OCR), and detection of
-    # explicit content, into applications.
+    # Integrates Google Vision features, including image labeling, face, logo,
+    # and landmark detection, optical character recognition (OCR), and detection
+    # of explicit content, into applications.
     # - [Product Documentation][]
     #
     # ## Quick Start
@@ -112,24 +112,11 @@ module Google
         .select { |dir| File.exist?(dir + ".rb") }
         .map { |dir| File.basename(dir) }
 
-      module ProductSearch
+      module ImageAnnotator
         ##
-        # Manages Products and ProductSets of reference images for use in product
-        # search. It uses the following resource model:
-        #
-        # * The API has a collection of {Google::Cloud::Vision::V1::ProductSet ProductSet}
-        #   resources, named `projects/*/locations/*/productSets/*`, which acts as a way
-        #   to put different products into groups to limit identification.
-        #
-        # In parallel,
-        #
-        # * The API has a collection of {Google::Cloud::Vision::V1::Product Product}
-        #   resources, named
-        #   `projects/*/locations/*/products/*`
-        #
-        # * Each {Google::Cloud::Vision::V1::Product Product} has a collection of
-        #   {Google::Cloud::Vision::V1::ReferenceImage ReferenceImage} resources, named
-        #   `projects/*/locations/*/products/*/referenceImages/*`
+        # Service that performs Google Cloud Vision API detection tasks over client
+        # images, such as face, landmark, logo, label, and text detection. The
+        # ImageAnnotator service returns detected entities from the images.
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v1
@@ -175,15 +162,28 @@ module Google
             .constants
             .select {|sym| sym.to_s.downcase == version.to_s.downcase}
             .first
-          Google::Cloud::Vision.const_get(version_module)::ProductSearch.new(*args, **kwargs)
+          Google::Cloud::Vision.const_get(version_module)::ImageAnnotator.new(*args, **kwargs)
         end
       end
 
-      module ImageAnnotator
+      module ProductSearch
         ##
-        # Service that performs Google Cloud Vision API detection tasks over client
-        # images, such as face, landmark, logo, label, and text detection. The
-        # ImageAnnotator service returns detected entities from the images.
+        # Manages Products and ProductSets of reference images for use in product
+        # search. It uses the following resource model:
+        #
+        # * The API has a collection of {Google::Cloud::Vision::V1::ProductSet ProductSet}
+        #   resources, named `projects/*/locations/*/productSets/*`, which acts as a way
+        #   to put different products into groups to limit identification.
+        #
+        # In parallel,
+        #
+        # * The API has a collection of {Google::Cloud::Vision::V1::Product Product}
+        #   resources, named
+        #   `projects/*/locations/*/products/*`
+        #
+        # * Each {Google::Cloud::Vision::V1::Product Product} has a collection of
+        #   {Google::Cloud::Vision::V1::ReferenceImage ReferenceImage} resources, named
+        #   `projects/*/locations/*/products/*/referenceImages/*`
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v1
@@ -229,7 +229,7 @@ module Google
             .constants
             .select {|sym| sym.to_s.downcase == version.to_s.downcase}
             .first
-          Google::Cloud::Vision.const_get(version_module)::ImageAnnotator.new(*args, **kwargs)
+          Google::Cloud::Vision.const_get(version_module)::ProductSearch.new(*args, **kwargs)
         end
       end
     end

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

@@ -13,9 +13,9 @@
 # limitations under the License.
 
 
-require "google/cloud/vision/v1/product_search_client"
 require "google/cloud/vision/v1/image_annotator_client"
 require "google/cloud/vision/v1/helpers"
+require "google/cloud/vision/v1/product_search_client"
 require "google/cloud/vision/v1/product_search_service_pb"
 require "google/cloud/vision/v1/image_annotator_pb"
 
@@ -28,9 +28,9 @@ module Google
       # # Ruby Client for Cloud Vision API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
       #
       # [Cloud Vision API][Product Documentation]:
-      # Integrates Google Vision features, including image labeling, face, logo, and
-      # landmark detection, optical character recognition (OCR), and detection of
-      # explicit content, into applications.
+      # Integrates Google Vision features, including image labeling, face, logo,
+      # and landmark detection, optical character recognition (OCR), and detection
+      # of explicit content, into applications.
       # - [Product Documentation][]
       #
       # ## Quick Start
@@ -101,24 +101,11 @@ module Google
       module V1
         # rubocop:enable LineLength
 
-        module ProductSearch
+        module ImageAnnotator
           ##
-          # Manages Products and ProductSets of reference images for use in product
-          # search. It uses the following resource model:
-          #
-          # * The API has a collection of {Google::Cloud::Vision::V1::ProductSet ProductSet}
-          #   resources, named `projects/*/locations/*/productSets/*`, which acts as a way
-          #   to put different products into groups to limit identification.
-          #
-          # In parallel,
-          #
-          # * The API has a collection of {Google::Cloud::Vision::V1::Product Product}
-          #   resources, named
-          #   `projects/*/locations/*/products/*`
-          #
-          # * Each {Google::Cloud::Vision::V1::Product Product} has a collection of
-          #   {Google::Cloud::Vision::V1::ReferenceImage ReferenceImage} resources, named
-          #   `projects/*/locations/*/products/*/referenceImages/*`
+          # Service that performs Google Cloud Vision API detection tasks over client
+          # images, such as face, landmark, logo, label, and text detection. The
+          # ImageAnnotator service returns detected entities from the images.
           #
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
@@ -168,15 +155,28 @@ module Google
               lib_name: lib_name,
               lib_version: lib_version
             }.select { |_, v| v != nil }
-            Google::Cloud::Vision::V1::ProductSearchClient.new(**kwargs)
+            Google::Cloud::Vision::V1::ImageAnnotatorClient.new(**kwargs)
           end
         end
 
-        module ImageAnnotator
+        module ProductSearch
           ##
-          # Service that performs Google Cloud Vision API detection tasks over client
-          # images, such as face, landmark, logo, label, and text detection. The
-          # ImageAnnotator service returns detected entities from the images.
+          # Manages Products and ProductSets of reference images for use in product
+          # search. It uses the following resource model:
+          #
+          # * The API has a collection of {Google::Cloud::Vision::V1::ProductSet ProductSet}
+          #   resources, named `projects/*/locations/*/productSets/*`, which acts as a way
+          #   to put different products into groups to limit identification.
+          #
+          # In parallel,
+          #
+          # * The API has a collection of {Google::Cloud::Vision::V1::Product Product}
+          #   resources, named
+          #   `projects/*/locations/*/products/*`
+          #
+          # * Each {Google::Cloud::Vision::V1::Product Product} has a collection of
+          #   {Google::Cloud::Vision::V1::ReferenceImage ReferenceImage} resources, named
+          #   `projects/*/locations/*/products/*/referenceImages/*`
           #
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
@@ -226,7 +226,7 @@ module Google
               lib_name: lib_name,
               lib_version: lib_version
             }.select { |_, v| v != nil }
-            Google::Cloud::Vision::V1::ImageAnnotatorClient.new(**kwargs)
+            Google::Cloud::Vision::V1::ProductSearchClient.new(**kwargs)
           end
         end
       end

data/lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb

@@ -128,7 +128,7 @@ module Google
         # @!attribute [rw] bounding_poly
         #   @return [Google::Cloud::Vision::V1::BoundingPoly]
         #     The bounding polygon around the face. The coordinates of the bounding box
-        #     are in the original image's scale, as returned in `ImageParams`.
+        #     are in the original image's scale.
         #     The bounding box is computed to "frame" the face in accordance with human
         #     expectations. It is based on the landmarker results.
         #     Note that one or more x and/or y coordinates may not be generated in the
@@ -459,7 +459,7 @@ module Google
         # @!attribute [rw] bounding_poly
         #   @return [Google::Cloud::Vision::V1::BoundingPoly]
         #     The bounding polygon for the crop region. The coordinates of the bounding
-        #     box are in the original image's scale, as returned in `ImageParams`.
+        #     box are in the original image's scale.
         # @!attribute [rw] confidence
         #   @return [Float]
         #     Confidence of this being a salient region.  Range [0, 1].
@@ -518,7 +518,7 @@ module Google
         class ImageContext; end
 
         # Request for performing Google Cloud Vision API tasks over a user-provided
-        # image, with user-requested features.
+        # image, with user-requested features, and with context information.
         # @!attribute [rw] image
         #   @return [Google::Cloud::Vision::V1::Image]
         #     The image to be processed.
@@ -601,6 +601,9 @@ module Google
         # @!attribute [rw] responses
         #   @return [Array<Google::Cloud::Vision::V1::AnnotateImageResponse>]
         #     Individual responses to images found within the file.
+        # @!attribute [rw] total_pages
+        #   @return [Integer]
+        #     This field gives the total number of pages in the file.
         class AnnotateFileResponse; end
 
         # Multiple image annotation requests are batched into a single service call.
@@ -615,6 +618,48 @@ module Google
         #     Individual responses to image annotation requests within the batch.
         class BatchAnnotateImagesResponse; end
 
+        # A request to annotate one single file, e.g. a PDF, TIFF or GIF file.
+        # @!attribute [rw] input_config
+        #   @return [Google::Cloud::Vision::V1::InputConfig]
+        #     Required. Information about the input file.
+        # @!attribute [rw] features
+        #   @return [Array<Google::Cloud::Vision::V1::Feature>]
+        #     Required. Requested features.
+        # @!attribute [rw] image_context
+        #   @return [Google::Cloud::Vision::V1::ImageContext]
+        #     Additional context that may accompany the image(s) in the file.
+        # @!attribute [rw] pages
+        #   @return [Array<Integer>]
+        #     Pages of the file to perform image annotation.
+        #
+        #     Pages starts from 1, we assume the first page of the file is page 1.
+        #     At most 5 pages are supported per request. Pages can be negative.
+        #
+        #     Page 1 means the first page.
+        #     Page 2 means the second page.
+        #     Page -1 means the last page.
+        #     Page -2 means the second to the last page.
+        #
+        #     If the file is GIF instead of PDF or TIFF, page refers to GIF frames.
+        #
+        #     If this field is empty, by default the service performs image annotation
+        #     for the first 5 pages of the file.
+        class AnnotateFileRequest; end
+
+        # A list of requests to annotate files using the BatchAnnotateFiles API.
+        # @!attribute [rw] requests
+        #   @return [Array<Google::Cloud::Vision::V1::AnnotateFileRequest>]
+        #     The list of file annotation requests. Right now we support only one
+        #     AnnotateFileRequest in BatchAnnotateFilesRequest.
+        class BatchAnnotateFilesRequest; end
+
+        # A list of file annotation responses.
+        # @!attribute [rw] responses
+        #   @return [Array<Google::Cloud::Vision::V1::AnnotateFileResponse>]
+        #     The list of file annotation responses, each response corresponding to each
+        #     AnnotateFileRequest in BatchAnnotateFilesRequest.
+        class BatchAnnotateFilesResponse; end
+
         # An offline file annotation request.
         # @!attribute [rw] input_config
         #   @return [Google::Cloud::Vision::V1::InputConfig]
@@ -636,6 +681,21 @@ module Google
         #     The output location and metadata from AsyncAnnotateFileRequest.
         class AsyncAnnotateFileResponse; end
 
+        # Request for async image annotation for a list of images.
+        # @!attribute [rw] requests
+        #   @return [Array<Google::Cloud::Vision::V1::AnnotateImageRequest>]
+        #     Individual image annotation requests for this batch.
+        # @!attribute [rw] output_config
+        #   @return [Google::Cloud::Vision::V1::OutputConfig]
+        #     Required. The desired output location and metadata (e.g. format).
+        class AsyncBatchAnnotateImagesRequest; end
+
+        # Response to an async batch image annotation request.
+        # @!attribute [rw] output_config
+        #   @return [Google::Cloud::Vision::V1::OutputConfig]
+        #     The output location and metadata from AsyncBatchAnnotateImagesRequest.
+        class AsyncBatchAnnotateImagesResponse; end
+
         # Multiple async file annotation requests are batched into a single service
         # call.
         # @!attribute [rw] requests
@@ -654,6 +714,14 @@ module Google
         # @!attribute [rw] gcs_source
         #   @return [Google::Cloud::Vision::V1::GcsSource]
         #     The Google Cloud Storage location to read the input from.
+        # @!attribute [rw] content
+        #   @return [String]
+        #     File content, represented as a stream of bytes.
+        #     Note: As with all `bytes` fields, protobuffers use a pure binary
+        #     representation, whereas JSON representations use base64.
+        #
+        #     Currently, this field only works for BatchAnnotateFiles requests. It does
+        #     not work for AsyncBatchAnnotateFiles requests.
         # @!attribute [rw] mime_type
         #   @return [String]
         #     The type of the file. Currently only "application/pdf" and "image/tiff"
@@ -689,16 +757,23 @@ module Google
         # The Google Cloud Storage location where the output will be written to.
         # @!attribute [rw] uri
         #   @return [String]
-        #     Google Cloud Storage URI where the results will be stored. Results will
-        #     be in JSON format and preceded by its corresponding input URI. This field
-        #     can either represent a single file, or a prefix for multiple outputs.
-        #     Prefixes must end in a `/`.
+        #     Google Cloud Storage URI prefix where the results will be stored. Results
+        #     will be in JSON format and preceded by its corresponding input URI prefix.
+        #     This field can either represent a gcs file prefix or gcs directory. In
+        #     either case, the uri should be unique because in order to get all of the
+        #     output files, you will need to do a wildcard gcs search on the uri prefix
+        #     you provide.
         #
         #     Examples:
         #
-        #     * File: gs://bucket-name/filename.json
-        #     * Prefix: gs://bucket-name/prefix/here/
-        #     * File: gs://bucket-name/prefix/here
+        #     * File Prefix: gs://bucket-name/here/filenameprefix   The output files
+        #       will be created in gs://bucket-name/here/ and the names of the
+        #       output files will begin with "filenameprefix".
+        #
+        #     * Directory Prefix: gs://bucket-name/some/location/   The output files
+        #       will be created in gs://bucket-name/some/location/ and the names of the
+        #       output files could be anything because there was no filename prefix
+        #       specified.
         #
         #     If multiple outputs, each response is still AnnotateFileResponse, each of
         #     which contains some subset of the full list of AnnotateImageResponse.

data/lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/product_search.rb

@@ -38,17 +38,20 @@ module Google
         #   @return [String]
         #     The filtering expression. This can be used to restrict search results based
         #     on Product labels. We currently support an AND of OR of key-value
-        #     expressions, where each expression within an OR must have the same key.
+        #     expressions, where each expression within an OR must have the same key. An
+        #     '=' should be used to connect the key and value.
         #
         #     For example, "(color = red OR color = blue) AND brand = Google" is
-        #     acceptable, but not "(color = red OR brand = Google)" or "color: red".
+        #     acceptable, but "(color = red OR brand = Google)" is not acceptable.
+        #     "color: red" is not acceptable because it uses a ':' instead of an '='.
         class ProductSearchParams; end
 
         # Results for a product search request.
         # @!attribute [rw] index_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Timestamp of the index which provided these results. Changes made after
-        #     this time are not reflected in the current results.
+        #     Timestamp of the index which provided these results. Products added to the
+        #     product set and products removed from the product set after this time are
+        #     not reflected in the current results.
         # @!attribute [rw] results
         #   @return [Array<Google::Cloud::Vision::V1::ProductSearchResults::Result>]
         #     List of results, one for each product match.

data/lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/product_search_service.rb

@@ -83,7 +83,8 @@ module Google
         #   @return [Google::Protobuf::Timestamp]
         #     Output only. The time at which this ProductSet was last indexed. Query
         #     results will reflect all updates before this time. If this ProductSet has
-        #     never been indexed, this field is 0.
+        #     never been indexed, this timestamp is the default value
+        #     "1970-01-01T00:00:00Z".
         #
         #     This field is ignored when creating a ProductSet.
         # @!attribute [rw] index_error

data/lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/web_detection.rb

@@ -63,6 +63,17 @@ module Google
           #     (Deprecated) Overall relevancy score for the image.
           class WebImage; end
 
+          # Label to provide extra metadata for the web detection.
+          # @!attribute [rw] label
+          #   @return [String]
+          #     Label for extra metadata.
+          # @!attribute [rw] language_code
+          #   @return [String]
+          #     The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
+          #     For more information, see
+          #     http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+          class WebLabel; end
+
           # Metadata for web pages.
           # @!attribute [rw] url
           #   @return [String]
@@ -84,17 +95,6 @@ module Google
           #     example an original image will likely have partial matching for its
           #     crops.
           class WebPage; end
-
-          # Label to provide extra metadata for the web detection.
-          # @!attribute [rw] label
-          #   @return [String]
-          #     Label for extra metadata.
-          # @!attribute [rw] language_code
-          #   @return [String]
-          #     The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
-          #     For more information, see
-          #     http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
-          class WebLabel; end
         end
       end
     end

data/lib/google/cloud/vision/v1/image_annotator_client.rb

@@ -184,6 +184,16 @@ module Google
               defaults["batch_annotate_images"],
               exception_transformer: exception_transformer
             )
+            @batch_annotate_files = Google::Gax.create_api_call(
+              @image_annotator_stub.method(:batch_annotate_files),
+              defaults["batch_annotate_files"],
+              exception_transformer: exception_transformer
+            )
+            @async_batch_annotate_images = Google::Gax.create_api_call(
+              @image_annotator_stub.method(:async_batch_annotate_images),
+              defaults["async_batch_annotate_images"],
+              exception_transformer: exception_transformer
+            )
             @async_batch_annotate_files = Google::Gax.create_api_call(
               @image_annotator_stub.method(:async_batch_annotate_files),
               defaults["async_batch_annotate_files"],
@@ -227,6 +237,128 @@ module Google
             @batch_annotate_images.call(req, options, &block)
           end
 
+          # Service that performs image detection and annotation for a batch of files.
+          # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+          #
+          # This service will extract at most 5 (customers can specify which 5 in
+          # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+          # file provided and perform detection and annotation for each image
+          # extracted.
+          #
+          # @param requests [Array<Google::Cloud::Vision::V1::AnnotateFileRequest | Hash>]
+          #   The list of file annotation requests. Right now we support only one
+          #   AnnotateFileRequest in BatchAnnotateFilesRequest.
+          #   A hash of the same form as `Google::Cloud::Vision::V1::AnnotateFileRequest`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Vision::V1::BatchAnnotateFilesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Vision::V1::BatchAnnotateFilesResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   # TODO: Initialize `requests`:
+          #   requests = []
+          #   response = image_annotator_client.batch_annotate_files(requests)
+
+          def batch_annotate_files \
+              requests,
+              options: nil,
+              &block
+            req = {
+              requests: requests
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Vision::V1::BatchAnnotateFilesRequest)
+            @batch_annotate_files.call(req, options, &block)
+          end
+
+          # Run asynchronous image detection and annotation for a list of images.
+          #
+          # Progress and results can be retrieved through the
+          # `google.longrunning.Operations` interface.
+          # `Operation.metadata` contains `OperationMetadata` (metadata).
+          # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+          #
+          # This service will write image annotation outputs to json files in customer
+          # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
+          #
+          # @param requests [Array<Google::Cloud::Vision::V1::AnnotateImageRequest | Hash>]
+          #   Individual image annotation requests for this batch.
+          #   A hash of the same form as `Google::Cloud::Vision::V1::AnnotateImageRequest`
+          #   can also be provided.
+          # @param output_config [Google::Cloud::Vision::V1::OutputConfig | Hash]
+          #   Required. The desired output location and metadata (e.g. format).
+          #   A hash of the same form as `Google::Cloud::Vision::V1::OutputConfig`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Gax::Operation]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new(version: :v1)
+          #
+          #   # TODO: Initialize `requests`:
+          #   requests = []
+          #
+          #   # TODO: Initialize `output_config`:
+          #   output_config = {}
+          #
+          #   # Register a callback during the method call.
+          #   operation = image_annotator_client.async_batch_annotate_images(requests, output_config) do |op|
+          #     raise op.results.message if op.error?
+          #     op_results = op.results
+          #     # Process the results.
+          #
+          #     metadata = op.metadata
+          #     # Process the metadata.
+          #   end
+          #
+          #   # Or use the return value to register a callback.
+          #   operation.on_done do |op|
+          #     raise op.results.message if op.error?
+          #     op_results = op.results
+          #     # Process the results.
+          #
+          #     metadata = op.metadata
+          #     # Process the metadata.
+          #   end
+          #
+          #   # Manually reload the operation.
+          #   operation.reload!
+          #
+          #   # Or block until the operation completes, triggering callbacks on
+          #   # completion.
+          #   operation.wait_until_done!
+
+          def async_batch_annotate_images \
+              requests,
+              output_config,
+              options: nil
+            req = {
+              requests: requests,
+              output_config: output_config
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Vision::V1::AsyncBatchAnnotateImagesRequest)
+            operation = Google::Gax::Operation.new(
+              @async_batch_annotate_images.call(req, options),
+              @operations_client,
+              Google::Cloud::Vision::V1::AsyncBatchAnnotateImagesResponse,
+              Google::Cloud::Vision::V1::OperationMetadata,
+              call_options: options
+            )
+            operation.on_done { |operation| yield(operation) } if block_given?
+            operation
+          end
+
           # Run asynchronous image detection and annotation for a list of generic
           # files, such as PDF files, which may contain multiple pages and multiple
           # images per page. Progress and results can be retrieved through the