google-cloud-vision 0.28.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b81db07611ab1066ea2ee85b3e8ad26114526acd1b908cc81208419c00fb6d4
-  data.tar.gz: ba5bc2654acea5e24ea93b77000b9ffe7140e1a3ae23e242c45fa5df2cf6c7dd
+  metadata.gz: fc41171a8d422e7f64207e8dc1aca24666e227e849e9096886a18592c4899611
+  data.tar.gz: 8a9759d3870dbf1ef87f3a7c433f6bc731a8f2218393838d473a3c02f00733a6
 SHA512:
-  metadata.gz: 104e8b736e5e34d528ea4ca58c6705d1b8e8de4a0f641593746edb0388e05f3c53e9ada250271a7fdf1f8d6a54579769c98fcd025a6248333d597f227216455c
-  data.tar.gz: 5eca611c1e4291e9d6aaf38d5a0d0e34896b9d265ff5e57065752c0bb3797baa8b6213d16f0f9fd2d60c810885ece8768919a9d05a9e8c027415cd0f0f0ad604
+  metadata.gz: 71cda3f0d570c19f57f7cac596005ea6c99a9e7d59a296845a1749723a520d287dd4b609fee2e0bfb0a31bfa1f071a131d0b5ab3ccfc2162087fbe2854a47256
+  data.tar.gz: 9740457dd6ce47815fa5d6317543ad37ae6af95230a35749680a96f0dc44eec9a876f8a4cbb7efdc4ff1fc43f753bec449e465a62ea97e1935d0b0ca2272d365

data/README.md

@@ -31,10 +31,39 @@ landmark = image.landmark
 landmark.description #=> "Mount Rushmore"
 ```
 
+## Enabling Logging
+
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below, or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb) and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+
+Configuring a Ruby stdlib logger:
+
+```ruby
+require "logger"
+
+module MyLogger
+  LOGGER = Logger.new $stderr, level: Logger::WARN
+  def logger
+    LOGGER
+  end
+end
+
+# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+module GRPC
+  extend MyLogger
+end
+```
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.0+.
 
+However, Ruby 2.3 or later is strongly recommended, as earlier releases have
+reached or are nearing end-of-life. After June 1, 2018, Google will provide
+official support only for Ruby versions that are considered current and
+supported by Ruby Core (that is, Ruby versions that are either in normal
+maintenance or in security maintenance).
+See https://www.ruby-lang.org/en/downloads/branches/ for further details.
+
 ## Versioning
 
 This library follows [Semantic Versioning](http://semver.org/).

data/lib/google/cloud/vision.rb

@@ -40,6 +40,39 @@ module Google
     # [Authentication
     # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
     #
+    # ## Enabling Logging
+    #
+    # To enable logging for this library, set the logger for the underlying
+    # [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library. The
+    # logger that you set may be a Ruby stdlib
+    # [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html)
+    # as shown below, or a
+    # [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # that will write logs to [Stackdriver
+    # Logging](https://cloud.google.com/logging/). See
+    # [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+    # and the gRPC
+    # [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb)
+    # for additional information.
+    #
+    # Configuring a Ruby stdlib logger:
+    #
+    # ```ruby
+    # require "logger"
+    #
+    # module MyLogger
+    #   LOGGER = Logger.new $stderr, level: Logger::WARN
+    #   def logger
+    #     LOGGER
+    #   end
+    # end
+    #
+    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+    # module GRPC
+    #   extend MyLogger
+    # end
+    # ```
+    #
     # ## Creating images
     #
     # The Cloud Vision API supports UTF-8, UTF-16, and UTF-32 text encodings.

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

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -13,15 +13,16 @@
 # limitations under the License.
 
 require "google/cloud/vision/v1/image_annotator_client"
+require "google/cloud/vision/v1/image_annotator_pb"
 
 module Google
   module Cloud
     # rubocop:disable LineLength
 
     ##
-    # # Ruby Client for Google Cloud Vision API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+    # # Ruby Client for Cloud Vision API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
     #
-    # [Google Cloud Vision API][Product Documentation]:
+    # [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.
@@ -32,8 +33,9 @@ module Google
     # steps:
     #
     # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
-    # 2. [Enable the Google Cloud Vision API.](https://console.cloud.google.com/apis/api/vision)
-    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+    # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+    # 3. [Enable the Cloud Vision API.](https://console.cloud.google.com/apis/api/vision)
+    # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
     #
     # ### Preview
     # #### ImageAnnotatorClient
@@ -53,13 +55,38 @@ module Google
     # ```
     #
     # ### Next Steps
-    # - Read the [Google Cloud Vision API Product documentation][Product Documentation]
+    # - Read the [Cloud Vision API Product documentation][Product Documentation]
     #   to learn more about the product and see How-to Guides.
     # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
     #   to see the full list of Cloud APIs that we cover.
     #
     # [Product Documentation]: https://cloud.google.com/vision
     #
+    # ## Enabling Logging
+    #
+    # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+    # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+    # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+    # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+    #
+    # Configuring a Ruby stdlib logger:
+    #
+    # ```ruby
+    # require "logger"
+    #
+    # module MyLogger
+    #   LOGGER = Logger.new $stderr, level: Logger::WARN
+    #   def logger
+    #     LOGGER
+    #   end
+    # end
+    #
+    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+    # module GRPC
+    #   extend MyLogger
+    # end
+    # ```
     #
     module Vision
       module V1
@@ -94,28 +121,27 @@ module Google
         #   or the specified config is missing data points.
         # @param timeout [Numeric]
         #   The default timeout, in seconds, for calls made through this client.
+        # @param metadata [Hash]
+        #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+        # @param exception_transformer [Proc]
+        #   An optional proc that intercepts any exceptions raised during an API call to inject
+        #   custom error handling.
         def self.new \
-            service_path: nil,
-            port: nil,
-            channel: nil,
-            chan_creds: nil,
-            updater_proc: nil,
             credentials: nil,
             scopes: nil,
             client_config: nil,
             timeout: nil,
+            metadata: nil,
+            exception_transformer: nil,
             lib_name: nil,
             lib_version: nil
           kwargs = {
-            service_path: service_path,
-            port: port,
-            channel: channel,
-            chan_creds: chan_creds,
-            updater_proc: updater_proc,
             credentials: credentials,
             scopes: scopes,
             client_config: client_config,
             timeout: timeout,
+            metadata: metadata,
+            exception_transformer: exception_transformer,
             lib_name: lib_name,
             lib_version: lib_version
           }.select { |_, v| v != nil }

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

@@ -0,0 +1,33 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "googleauth"
+
+module Google
+  module Cloud
+    module Vision
+      module V1
+        class Credentials < Google::Auth::Credentials
+          SCOPE = [
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/cloud-vision"
+          ].freeze
+          PATH_ENV_VARS = %w(VISION_KEYFILE GOOGLE_CLOUD_KEYFILE GCLOUD_KEYFILE)
+          JSON_ENV_VARS = %w(VISION_KEYFILE_JSON GOOGLE_CLOUD_KEYFILE_JSON GCLOUD_KEYFILE_JSON)
+          DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
+        end
+      end
+    end
+  end
+end

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

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -26,10 +26,24 @@ module Google
         #     Y coordinate.
         class Vertex; end
 
+        # A vertex represents a 2D point in the image.
+        # NOTE: the normalized vertex coordinates are relative to the original image
+        # and range from 0 to 1.
+        # @!attribute [rw] x
+        #   @return [Float]
+        #     X coordinate.
+        # @!attribute [rw] y
+        #   @return [Float]
+        #     Y coordinate.
+        class NormalizedVertex; end
+
         # A bounding polygon for the detected image annotation.
         # @!attribute [rw] vertices
         #   @return [Array<Google::Cloud::Vision::V1::Vertex>]
         #     The bounding polygon vertices.
+        # @!attribute [rw] normalized_vertices
+        #   @return [Array<Google::Cloud::Vision::V1::NormalizedVertex>]
+        #     The bounding polygon normalized vertices.
         class BoundingPoly; end
 
         # A 3D position in the image, used primarily for Face detection landmarks.

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

@@ -1,4 +1,4 @@
-# Copyright 2017 Google LLC
+# Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,29 +16,34 @@ module Google
   module Cloud
     module Vision
       ##
-      # # Google Cloud Vision API Contents
+      # # Cloud Vision API Contents
       #
       # | Class | Description |
       # | ----- | ----------- |
-      # | [ImageAnnotatorClient][] | Integrates Google Vision features, including image labeling, face, logo, and landmark detection, optical character recognition (OCR), and detection of explicit content, into applications. |
+      # | [ImageAnnotatorClient][] | Service that performs Google Cloud Vision API detection tasks over client images, such as face, landmark, logo, label, and text detection. |
       # | [Data Types][] | Data types for Google::Cloud::Vision::V1 |
       #
       # [ImageAnnotatorClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-vision/latest/google/cloud/vision/v1/imageannotatorclient
       # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-vision/latest/google/cloud/vision/v1/datatypes
       #
       module V1
-        # Users describe the type of Google Cloud Vision API tasks to perform over
-        # images by using *Feature*s. Each Feature indicates a type of image
-        # detection task to perform. Features encode the Cloud Vision API
-        # vertical to operate on and the number of top-scoring results to return.
+        # The type of Google Cloud Vision API detection to perform, and the maximum
+        # number of results to return for that type. Multiple +Feature+ objects can
+        # be specified in the +features+ list.
         # @!attribute [rw] type
         #   @return [Google::Cloud::Vision::V1::Feature::Type]
         #     The feature type.
         # @!attribute [rw] max_results
         #   @return [Integer]
-        #     Maximum number of results of this type.
+        #     Maximum number of results of this type. Does not apply to
+        #     +TEXT_DETECTION+, +DOCUMENT_TEXT_DETECTION+, or +CROP_HINTS+.
+        # @!attribute [rw] model
+        #   @return [String]
+        #     Model to use for the feature.
+        #     Supported values: "builtin/stable" (the default if unset) and
+        #     "builtin/latest".
         class Feature
-          # Type of image feature.
+          # Type of Google Cloud Vision API feature to be extracted.
           module Type
             # Unspecified feature type.
             TYPE_UNSPECIFIED = 0
@@ -55,17 +60,21 @@ module Google
             # Run label detection.
             LABEL_DETECTION = 4
 
-            # Run OCR.
+            # Run text detection / optical character recognition (OCR). Text detection
+            # is optimized for areas of text within a larger image; if the image is
+            # a document, use +DOCUMENT_TEXT_DETECTION+ instead.
             TEXT_DETECTION = 5
 
             # Run dense text document OCR. Takes precedence when both
-            # DOCUMENT_TEXT_DETECTION and TEXT_DETECTION are present.
+            # +DOCUMENT_TEXT_DETECTION+ and +TEXT_DETECTION+ are present.
             DOCUMENT_TEXT_DETECTION = 11
 
-            # Run computer vision models to compute image safe-search properties.
+            # Run Safe Search to detect potentially unsafe
+            # or undesirable content.
             SAFE_SEARCH_DETECTION = 6
 
-            # Compute a set of image properties, such as the image's dominant colors.
+            # Compute a set of image properties, such as the
+            # image's dominant colors.
             IMAGE_PROPERTIES = 7
 
             # Run crop hints.
@@ -76,26 +85,33 @@ module Google
           end
         end
 
-        # External image source (Google Cloud Storage image location).
+        # External image source (Google Cloud Storage or web URL image location).
         # @!attribute [rw] gcs_image_uri
         #   @return [String]
-        #     NOTE: For new code +image_uri+ below is preferred.
-        #     Google Cloud Storage image URI, which must be in the following form:
-        #     +gs://bucket_name/object_name+ (for details, see
+        #     **Use +image_uri+ instead.**
+        #
+        #     The Google Cloud Storage  URI of the form
+        #     +gs://bucket_name/object_name+. Object versioning is not supported. See
         #     [Google Cloud Storage Request
-        #     URIs](https://cloud.google.com/storage/docs/reference-uris)).
-        #     NOTE: Cloud Storage object versioning is not supported.
+        #     URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.
         # @!attribute [rw] image_uri
         #   @return [String]
-        #     Image URI which supports:
-        #     1) Google Cloud Storage image URI, which must be in the following form:
-        #     +gs://bucket_name/object_name+ (for details, see
-        #     [Google Cloud Storage Request
-        #     URIs](https://cloud.google.com/storage/docs/reference-uris)).
-        #     NOTE: Cloud Storage object versioning is not supported.
-        #     2) Publicly accessible image HTTP/HTTPS URL.
-        #     This is preferred over the legacy +gcs_image_uri+ above. When both
-        #     +gcs_image_uri+ and +image_uri+ are specified, +image_uri+ takes
+        #     The URI of the source image. Can be either:
+        #
+        #     1. A Google Cloud Storage URI of the form
+        #        +gs://bucket_name/object_name+. Object versioning is not supported. See
+        #        [Google Cloud Storage Request
+        #        URIs](https://cloud.google.com/storage/docs/reference-uris) for more
+        #        info.
+        #
+        #     2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from
+        #        HTTP/HTTPS URLs, Google cannot guarantee that the request will be
+        #        completed. Your request may fail if the specified host denies the
+        #        request (e.g. due to request throttling or DOS prevention), or if Google
+        #        throttles requests to the site for abuse prevention. You should not
+        #        depend on externally-hosted images for production applications.
+        #
+        #     When both +gcs_image_uri+ and +image_uri+ are specified, +image_uri+ takes
         #     precedence.
         class ImageSource; end
 
@@ -103,13 +119,13 @@ module Google
         # @!attribute [rw] content
         #   @return [String]
         #     Image content, represented as a stream of bytes.
-        #     Note: as with all +bytes+ fields, protobuffers use a pure binary
+        #     Note: As with all +bytes+ fields, protobuffers use a pure binary
         #     representation, whereas JSON representations use base64.
         # @!attribute [rw] source
         #   @return [Google::Cloud::Vision::V1::ImageSource]
-        #     Google Cloud Storage image location. If both +content+ and +source+
-        #     are provided for an image, +content+ takes precedence and is
-        #     used to perform the image annotation request.
+        #     Google Cloud Storage image location, or publicly-accessible image
+        #     URL. If both +content+ and +source+ are provided for an image, +content+
+        #     takes precedence and is used to perform the image annotation request.
         class Image; end
 
         # A face annotation object contains the results of face detection.
@@ -176,10 +192,6 @@ module Google
         #     Headwear likelihood.
         class FaceAnnotation
           # A face-specific landmark (for example, a face feature).
-          # Landmark positions may fall outside the bounds of the image
-          # if the face is near one or more edges of the image.
-          # Therefore it is NOT guaranteed that +0 <= x < width+ or
-          # +0 <= y < height+.
           # @!attribute [rw] type
           #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
           #     Face landmark type.
@@ -313,13 +325,17 @@ module Google
         # @!attribute [rw] value
         #   @return [String]
         #     Value of the property.
+        # @!attribute [rw] uint64_value
+        #   @return [Integer]
+        #     Value of numeric properties.
         class Property; end
 
         # Set of detected entity features.
         # @!attribute [rw] mid
         #   @return [String]
         #     Opaque entity ID. Some IDs may be available in
-        #     [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/).
+        #     [Google Knowledge Graph Search
+        #     API](https://developers.google.com/knowledge-graph/).
         # @!attribute [rw] locale
         #   @return [String]
         #     The language code for the locale in which the entity textual
@@ -332,6 +348,7 @@ module Google
         #     Overall score of the result. Range [0, 1].
         # @!attribute [rw] confidence
         #   @return [Float]
+        #     **Deprecated. Use +score+ instead.**
         #     The accuracy of the entity detection in an image.
         #     For example, for an image in which the "Eiffel Tower" entity is detected,
         #     this field represents the confidence that there is a tower in the query
@@ -345,10 +362,8 @@ module Google
         #     there is a tower in each image may be the same. Range [0, 1].
         # @!attribute [rw] bounding_poly
         #   @return [Google::Cloud::Vision::V1::BoundingPoly]
-        #     Image region to which this entity belongs. Currently not produced
-        #     for +LABEL_DETECTION+ features. For +TEXT_DETECTION+ (OCR), +boundingPoly+s
-        #     are produced for the entire text detected in an image region, followed by
-        #     +boundingPoly+s for each word within the detected text.
+        #     Image region to which this entity belongs. Not produced
+        #     for +LABEL_DETECTION+ features.
         # @!attribute [rw] locations
         #   @return [Array<Google::Cloud::Vision::V1::LocationInfo>]
         #     The location information for the detected entity. Multiple
@@ -367,7 +382,9 @@ module Google
         # violence).
         # @!attribute [rw] adult
         #   @return [Google::Cloud::Vision::V1::Likelihood]
-        #     Represents the adult content likelihood for the image.
+        #     Represents the adult content likelihood for the image. Adult content may
+        #     contain elements such as nudity, pornographic images or cartoons, or
+        #     sexual activities.
         # @!attribute [rw] spoof
         #   @return [Google::Cloud::Vision::V1::Likelihood]
         #     Spoof likelihood. The likelihood that an modification
@@ -378,7 +395,13 @@ module Google
         #     Likelihood that this is a medical image.
         # @!attribute [rw] violence
         #   @return [Google::Cloud::Vision::V1::Likelihood]
-        #     Violence likelihood.
+        #     Likelihood that this image contains violent content.
+        # @!attribute [rw] racy
+        #   @return [Google::Cloud::Vision::V1::Likelihood]
+        #     Likelihood that the request image contains racy content. Racy content may
+        #     include (but is not limited to) skimpy or sheer clothing, strategically
+        #     covered nudity, lewd or provocative poses, or close-ups of sensitive
+        #     body areas.
         class SafeSearchAnnotation; end
 
         # Rectangle determined by min and max +LatLng+ pairs.
@@ -433,6 +456,7 @@ module Google
         # Set of crop hints that are used to generate new crops when serving images.
         # @!attribute [rw] crop_hints
         #   @return [Array<Google::Cloud::Vision::V1::CropHint>]
+        #     Crop hint results.
         class CropHintsAnnotation; end
 
         # Parameters for crop hints annotation request.
@@ -446,10 +470,16 @@ module Google
         #     ignored.
         class CropHintsParams; end
 
+        # Parameters for web detection request.
+        # @!attribute [rw] include_geo_results
+        #   @return [true, false]
+        #     Whether to include results derived from the geo information in the image.
+        class WebDetectionParams; end
+
         # Image context and/or feature-specific parameters.
         # @!attribute [rw] lat_long_rect
         #   @return [Google::Cloud::Vision::V1::LatLongRect]
-        #     lat/long rectangle that specifies the location of the image.
+        #     Not used.
         # @!attribute [rw] language_hints
         #   @return [Array<String>]
         #     List of languages to use for TEXT_DETECTION. In most cases, an empty value
@@ -463,6 +493,9 @@ module Google
         # @!attribute [rw] crop_hints_params
         #   @return [Google::Cloud::Vision::V1::CropHintsParams]
         #     Parameters for crop hints annotation request.
+        # @!attribute [rw] web_detection_params
+        #   @return [Google::Cloud::Vision::V1::WebDetectionParams]
+        #     Parameters for web detection.
         class ImageContext; end
 
         # Request for performing Google Cloud Vision API tasks over a user-provided
@@ -478,6 +511,17 @@ module Google
         #     Additional context that may accompany the image.
         class AnnotateImageRequest; end
 
+        # If an image was produced from a file (e.g. a PDF), this message gives
+        # information about the source of that image.
+        # @!attribute [rw] uri
+        #   @return [String]
+        #     The URI of the file used to produce the image.
+        # @!attribute [rw] page_number
+        #   @return [Integer]
+        #     If the file was a PDF or TIFF, this field gives the page number within
+        #     the file used to produce the image.
+        class ImageAnnotationContext; end
+
         # Response to an image annotation request.
         # @!attribute [rw] face_annotations
         #   @return [Array<Google::Cloud::Vision::V1::FaceAnnotation>]
@@ -493,8 +537,7 @@ module Google
         #     If present, label detection has completed successfully.
         # @!attribute [rw] text_annotations
         #   @return [Array<Google::Cloud::Vision::V1::EntityAnnotation>]
-        #     If present, text (OCR) detection or document (OCR) text detection has
-        #     completed successfully.
+        #     If present, text (OCR) detection has completed successfully.
         # @!attribute [rw] full_text_annotation
         #   @return [Google::Cloud::Vision::V1::TextAnnotation]
         #     If present, text (OCR) detection or document (OCR) text detection has
@@ -518,8 +561,22 @@ module Google
         #     If set, represents the error message for the operation.
         #     Note that filled-in image annotations are guaranteed to be
         #     correct, even when +error+ is set.
+        # @!attribute [rw] context
+        #   @return [Google::Cloud::Vision::V1::ImageAnnotationContext]
+        #     If present, contextual information is needed to understand where this image
+        #     comes from.
         class AnnotateImageResponse; end
 
+        # Response to a single file annotation request. A file may contain one or more
+        # images, which individually have their own responses.
+        # @!attribute [rw] input_config
+        #   @return [Google::Cloud::Vision::V1::InputConfig]
+        #     Information about the file for which this response is generated.
+        # @!attribute [rw] responses
+        #   @return [Array<Google::Cloud::Vision::V1::AnnotateImageResponse>]
+        #     Individual responses to images found within the file.
+        class AnnotateFileResponse; end
+
         # Multiple image annotation requests are batched into a single service call.
         # @!attribute [rw] requests
         #   @return [Array<Google::Cloud::Vision::V1::AnnotateImageRequest>]
@@ -532,6 +589,127 @@ module Google
         #     Individual responses to image annotation requests within the batch.
         class BatchAnnotateImagesResponse; end
 
+        # An offline file annotation request.
+        # @!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] output_config
+        #   @return [Google::Cloud::Vision::V1::OutputConfig]
+        #     Required. The desired output location and metadata (e.g. format).
+        class AsyncAnnotateFileRequest; end
+
+        # The response for a single offline file annotation request.
+        # @!attribute [rw] output_config
+        #   @return [Google::Cloud::Vision::V1::OutputConfig]
+        #     The output location and metadata from AsyncAnnotateFileRequest.
+        class AsyncAnnotateFileResponse; end
+
+        # Multiple async file annotation requests are batched into a single service
+        # call.
+        # @!attribute [rw] requests
+        #   @return [Array<Google::Cloud::Vision::V1::AsyncAnnotateFileRequest>]
+        #     Individual async file annotation requests for this batch.
+        class AsyncBatchAnnotateFilesRequest; end
+
+        # Response to an async batch file annotation request.
+        # @!attribute [rw] responses
+        #   @return [Array<Google::Cloud::Vision::V1::AsyncAnnotateFileResponse>]
+        #     The list of file annotation responses, one for each request in
+        #     AsyncBatchAnnotateFilesRequest.
+        class AsyncBatchAnnotateFilesResponse; end
+
+        # The desired input location and metadata.
+        # @!attribute [rw] gcs_source
+        #   @return [Google::Cloud::Vision::V1::GcsSource]
+        #     The Google Cloud Storage location to read the input from.
+        # @!attribute [rw] mime_type
+        #   @return [String]
+        #     The type of the file. Currently only "application/pdf" and "image/tiff"
+        #     are supported. Wildcards are not supported.
+        class InputConfig; end
+
+        # The desired output location and metadata.
+        # @!attribute [rw] gcs_destination
+        #   @return [Google::Cloud::Vision::V1::GcsDestination]
+        #     The Google Cloud Storage location to write the output(s) to.
+        # @!attribute [rw] batch_size
+        #   @return [Integer]
+        #     The max number of response protos to put into each output JSON file on
+        #     Google Cloud Storage.
+        #     The valid range is [1, 100]. If not specified, the default value is 20.
+        #
+        #     For example, for one pdf file with 100 pages, 100 response protos will
+        #     be generated. If +batch_size+ = 20, then 5 json files each
+        #     containing 20 response protos will be written under the prefix
+        #     +gcs_destination+.+uri+.
+        #
+        #     Currently, batch_size only applies to GcsDestination, with potential future
+        #     support for other output configurations.
+        class OutputConfig; end
+
+        # The Google Cloud Storage location where the input will be read from.
+        # @!attribute [rw] uri
+        #   @return [String]
+        #     Google Cloud Storage URI for the input file. This must only be a
+        #     Google Cloud Storage object. Wildcards are not currently supported.
+        class GcsSource; end
+
+        # 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 +/+.
+        #
+        #     Examples:
+        #
+        #     * File: gs://bucket-name/filename.json
+        #     * Prefix: gs://bucket-name/prefix/here/
+        #     * File: gs://bucket-name/prefix/here
+        #
+        #     If multiple outputs, each response is still AnnotateFileResponse, each of
+        #     which contains some subset of the full list of AnnotateImageResponse.
+        #     Multiple outputs can happen if, for example, the output JSON is too large
+        #     and overflows into multiple sharded files.
+        class GcsDestination; end
+
+        # Contains metadata for the BatchAnnotateImages operation.
+        # @!attribute [rw] state
+        #   @return [Google::Cloud::Vision::V1::OperationMetadata::State]
+        #     Current state of the batch operation.
+        # @!attribute [rw] create_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     The time when the batch request was received.
+        # @!attribute [rw] update_time
+        #   @return [Google::Protobuf::Timestamp]
+        #     The time when the operation result was last updated.
+        class OperationMetadata
+          # Batch operation states.
+          module State
+            # Invalid.
+            STATE_UNSPECIFIED = 0
+
+            # Request is received.
+            CREATED = 1
+
+            # Request is actively being processed.
+            RUNNING = 2
+
+            # The batch processing is done.
+            DONE = 3
+
+            # The batch processing was cancelled.
+            CANCELLED = 4
+          end
+        end
+
         # A bucketized representation of likelihood, which is intended to give clients
         # highly stable results across model upgrades.
         module Likelihood