google-cloud-vision 0.31.0 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b97dd452706561fd304da05cf2572636618d8695e0d13e9db8fe0e000cd3a876
-  data.tar.gz: d1c466ff99ff655bb881d382e444846605a927a5820e2645f2068cd5a8e053b3
+  metadata.gz: 9f8e0d1755f74466a7f690802a403fe5188c3fea88c7909837e1064d892a936a
+  data.tar.gz: c2964cf1822eb5a8322a77d375330bc08c9387556104b65ed15d082965a6d3f6
 SHA512:
-  metadata.gz: d12d2ecd9e3c996af934dff0ae9508a377cb373ba92852d2b7c3aff0e6e34039403f0f54c5ba15f05c911ea490c80794aef2d3a7eac70ab5842377bec9567260
-  data.tar.gz: ed0e16cb06817bb8cecaf574247e44466db8c4f1f96d2c064ef3bfb17c5e37b6df75310bacebc2f58bc7841fd25bce38f27ce5bd2e6fbe52d2c8a0c22a304cc2
+  metadata.gz: 4a0b49386304f05fc46c76b1983912e1499379925485503f49c6481d7c577fcedfd70a66ceed9b10211debfdbbe6705db1ca3a187e3929367b673f46fa66ecab
+  data.tar.gz: d59ff7b92bcae64f6f20714ea9609ef9e73c4bb591692e6ebb7770172cbadd1ff7613a4b4574828a0279b084d83cf1a290a123998b45718bf0b97f332c475973

data/.yardopts

@@ -1,17 +1,10 @@
 --no-private
---title=Google Cloud Vision
+--title=Cloud Vision API
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet
---main OVERVIEW.md
 
 ./lib/**/*.rb
 -
-OVERVIEW.md
-AUTHENTICATION.md
-LOGGING.md
-CONTRIBUTING.md
-TROUBLESHOOTING.md
-CHANGELOG.md
-CODE_OF_CONDUCT.md
+README.md
 LICENSE

data/LICENSE

@@ -1,4 +1,4 @@
-                                 Apache License
+                            Apache License
                            Version 2.0, January 2004
                         https://www.apache.org/licenses/
 

data/README.md

@@ -0,0 +1,94 @@
+# 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.
+- [Client Library Documentation][]
+- [Product Documentation][]
+
+## Quick Start
+In order to use this library, you first need to go through the following
+steps:
+
+1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+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/library/vision.googleapis.com)
+4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+
+### Installation
+```
+$ gem install google-cloud-vision
+```
+
+### Migration Guide
+
+The 0.32.0 release introduced breaking changes relative to the previous release,
+0.31.0. For more details and instructions to migrate your code, please visit the
+[migration
+guide](https://cloud.google.com/vision/docs/ruby-client-migration).
+
+### Preview
+#### ImageAnnotatorClient
+```rb
+require "google/cloud/vision"
+
+image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new
+gcs_image_uri = "gs://gapic-toolkit/President_Barack_Obama.jpg"
+source = { gcs_image_uri: gcs_image_uri }
+image = { source: source }
+type = :FACE_DETECTION
+features_element = { type: type }
+features = [features_element]
+requests_element = { image: image, features: features }
+requests = [requests_element]
+response = image_annotator_client.batch_annotate_images(requests)
+```
+
+### Next Steps
+- Read the [Client Library Documentation][] for Cloud Vision API
+  to see other available methods on the client.
+- 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/googleapis/google-cloud-ruby/blob/master/README.md)
+  to see the full list of Cloud APIs that we cover.
+
+[Client Library Documentation]: https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-vision/latest/google/cloud/vision/v1
+[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://googleapis.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.3+.
+
+Google provides official support for Ruby versions that are actively supported
+by Ruby Core—that is, Ruby versions that are either in normal maintenance or
+in security maintenance, and not end of life. Currently, this means Ruby 2.3
+and later. Older versions of Ruby _may_ still work, but are unsupported and not
+recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
+about the Ruby support schedule.

data/lib/google/cloud/vision.rb

@@ -1,4 +1,4 @@
-# Copyright 2016 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,557 +13,222 @@
 # limitations under the License.
 
 
-require "google-cloud-vision"
-require "google/cloud/vision/project"
-require "google/cloud/config"
-require "google/cloud/env"
+require "google/gax"
+require "pathname"
 
 module Google
   module Cloud
+    # rubocop:disable LineLength
+
     ##
-    # # Google Cloud Vision
+    # # 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.
+    # - [Product Documentation][]
+    #
+    # ## Quick Start
+    # In order to use this library, you first need to go through the following
+    # steps:
+    #
+    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+    # 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/library/vision.googleapis.com)
+    # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+    #
+    # ### Installation
+    # ```
+    # $ gem install google-cloud-vision
+    # ```
+    #
+    # ### Migration Guide
+    #
+    # The 0.32.0 release introduced breaking changes relative to the previous
+    # release, 0.31.0. For more details and instructions to migrate your code,
+    # please visit the [migration
+    # guide](https://cloud.google.com/vision/docs/ruby-client-migration).
+    #
+    # ### Preview
+    # #### ImageAnnotatorClient
+    # ```rb
+    # require "google/cloud/vision"
+    #
+    # image_annotator_client = Google::Cloud::Vision::ImageAnnotator.new
+    # gcs_image_uri = "gs://gapic-toolkit/President_Barack_Obama.jpg"
+    # source = { gcs_image_uri: gcs_image_uri }
+    # image = { source: source }
+    # type = :FACE_DETECTION
+    # features_element = { type: type }
+    # features = [features_element]
+    # requests_element = { image: image, features: features }
+    # requests = [requests_element]
+    # response = image_annotator_client.batch_annotate_images(requests)
+    # ```
+    #
+    # ### Next Steps
+    # - 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/googleapis/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
     #
-    # Google Cloud Vision allows developers to easily integrate vision
-    # detection features within applications, including image labeling, face
-    # and landmark detection, optical character recognition (OCR), and tagging
-    # of explicit content.
+    # 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://googleapis.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.
     #
-    # For more information about Cloud Vision, read the [Google Cloud Vision API
-    # Documentation](https://cloud.google.com/vision/docs/).
+    # Configuring a Ruby stdlib logger:
     #
-    # See {file:OVERVIEW.md Vision Overview}.
+    # ```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
-      class << self
-        ##
-        # The default max results to return for facial detection requests. This
-        # is used on {Project#annotate} as well as {Image#faces}.
-        #
-        # The default value is `100`.
-        #
-        # This is also available on the configuration as
-        # `Google::Cloud::Vision.configure.default_max_faces`
-        #
-        # @example Using the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_faces #=> 100
-        #
-        #   annotation = vision.annotate "path/to/faces.jpg", faces: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate "path/to/faces.jpg", faces: 100
-        #
-        # @example Updating the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_faces = 5
-        #
-        #   annotation = vision.annotate "path/to/faces.jpg", faces: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate "path/to/faces.jpg", faces: 5
-        #
-        #
-        # @example Using the default setting on {Image#faces}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_faces #=> 100
-        #
-        #   faces = vision.image("path/to/faces.jpg").faces
-        #   # This is the same as calling
-        #   # faces = vision.image("path/to/faces.jpg").faces 100
-        #
-        # @example Updating the default setting on {Image#faces}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_faces = 5
-        #
-        #   faces = vision.image("path/to/faces.jpg").faces
-        #   # This is the same as calling
-        #   # faces = vision.image("path/to/faces.jpg").faces 5
-        #
-        def default_max_faces= value
-          configure.default_max_faces = value
-        end
-
-        ##
-        # The default max results to return for face detection requests.
-        #
-        def default_max_faces
-          configure.default_max_faces
-        end
-
-        ##
-        # The default max results to return for landmark detection requests.
-        # This is used on {Project#annotate} as well as {Image#landmarks}.
-        #
-        # The default value is 100.
-        #
-        # This is also available on the configuration as
-        # `Google::Cloud::Vision.configure.default_max_landmarks`
-        #
-        # @example Using the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_landmarks #=> 100
-        #
-        #   img = "path/to/landmarks.jpg"
-        #   annotation = vision.annotate img, landmarks: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate img, landmarks: 100
-        #
-        # @example Updating the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_landmarks = 5
-        #
-        #   img = "path/to/landmarks.jpg"
-        #   annotation = vision.annotate img, landmarks: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate img, landmarks: 5
-        #
-        #
-        # @example Using the default setting on {Image#landmarks}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_landmarks #=> 100
-        #
-        #   landmarks = vision.image("path/to/landmarks.jpg").landmarks
-        #   # This is the same as calling
-        #   # landmarks = vision.image("path/to/landmarks.jpg").landmarks 100
-        #
-        # @example Updating the default setting on {Image#landmarks}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_landmarks = 5
-        #
-        #   landmarks = vision.image("path/to/landmarks.jpg").landmarks
-        #   # This is the same as calling
-        #   # landmarks = vision.image("path/to/landmarks.jpg").landmarks 5
-        #
-        def default_max_landmarks= value
-          configure.default_max_landmarks = value
-        end
-
-        ##
-        # The default max results to return for landmark detection requests.
-        #
-        def default_max_landmarks
-          configure.default_max_landmarks
-        end
-
-        ##
-        # The default max results to return for logo detection requests. This is
-        # used on {Project#annotate} as well as {Image#logos}.
-        #
-        # The default value is 100.
-        #
-        # This is also available on the configuration as
-        # `Google::Cloud::Vision.configure.default_max_logos`
-        #
-        # @example Using the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_logos #=> 100
-        #
-        #   annotation = vision.annotate "path/to/logos.jpg", logos: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate "path/to/logos.jpg", logos: 100
-        #
-        # @example Updating the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_logos = 5
-        #
-        #   annotation = vision.annotate "path/to/logos.jpg", logos: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate "path/to/logos.jpg", logos: 5
-        #
-        #
-        # @example Using the default setting on {Image#logos}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_logos #=> 100
-        #
-        #   logos = vision.image("path/to/logos.jpg").logos
-        #   # This is the same as calling
-        #   # logos = vision.image("path/to/logos.jpg").logos 100
-        #
-        # @example Updating the default setting on {Image#logos}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_logos = 5
-        #
-        #   logos = vision.image("path/to/logos.jpg").logos
-        #   # This is the same as calling
-        #   # logos = vision.image("path/to/logos.jpg").logos 5
-        #
-        def default_max_logos= value
-          configure.default_max_logos = value
-        end
-
-        ##
-        # The default max results to return for logo detection requests.
-        #
-        def default_max_logos
-          configure.default_max_logos
-        end
-
-        ##
-        # The default max results to return for label detection requests. This
-        # is used on {Project#annotate} as well as {Image#labels}.
-        #
-        # The default value is 100.
-        #
-        # This is also available on the configuration as
-        # `Google::Cloud::Vision.configure.default_max_labels`
-        #
-        # @example Using the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_labels #=> 100
-        #
-        #   annotation = vision.annotate "path/to/labels.jpg", labels: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate "path/to/labels.jpg", labels: 100
-        #
-        # @example Updating the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_labels = 5
-        #
-        #   annotation = vision.annotate "path/to/labels.jpg", labels: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate "path/to/labels.jpg", labels: 5
-        #
-        #
-        # @example Using the default setting on {Image#labels}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_labels #=> 100
-        #
-        #   labels = vision.image("path/to/labels.jpg").labels
-        #   # This is the same as calling
-        #   # labels = vision.image("path/to/labels.jpg").labels 100
-        #
-        # @example Updating the default setting on {Image#labels}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_labels = 5
-        #
-        #   labels = vision.image("path/to/labels.jpg").labels
-        #   # This is the same as calling
-        #   # labels = vision.image("path/to/labels.jpg").labels 5
-        #
-        def default_max_labels= value
-          configure.default_max_labels = value
-        end
-
-        ##
-        # The default max results to return for label detection requests.
-        #
-        def default_max_labels
-          configure.default_max_labels
-        end
-
-        ##
-        # The default max results to return for crop hints detection requests.
-        # This is used on {Project#annotate} as well as {Image#crop_hints}.
-        #
-        # The default value is 100.
-        #
-        # This is also available on the configuration as
-        # `Google::Cloud::Vision.configure.default_max_crop_hints`
-        #
-        # @example Using the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_crop_hints #=> 100
-        #
-        #   img = "path/to/landmarks.jpg"
-        #   annotation = vision.annotate img, crop_hints: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate img, crop_hints: 100
-        #
-        # @example Updating the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_crop_hints = 5
-        #
-        #   img = "path/to/landmarks.jpg"
-        #   annotation = vision.annotate img, crop_hints: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate img, crop_hints: 5
-        #
-        #
-        # @example Using the default setting on {Image#crop_hints}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_crop_hints #=> 100
-        #
-        #   crop_hints = vision.image("path/to/landmarks.jpg").crop_hints
-        #   # This is the same as calling
-        #   # crop_hints = vision.image("path/to/landmarks.jpg").crop_hints 100
-        #
-        # @example Updating the default setting on {Image#crop_hints}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_crop_hints = 5
-        #
-        #   crop_hints = vision.image("path/to/landmarks.jpg").crop_hints
-        #   # This is the same as calling
-        #   # crop_hints = vision.image("path/to/landmarks.jpg").crop_hints 5
-        #
-        def default_max_crop_hints= value
-          configure.default_max_crop_hints = value
-        end
+      # rubocop:enable LineLength
 
-        ##
-        # The default max results to return for crop hints detection requests.
-        #
-        def default_max_crop_hints
-          configure.default_max_crop_hints
-        end
+      FILE_DIR = File.realdirpath(Pathname.new(__FILE__).join("..").join("vision"))
 
-        ##
-        # The default max results to return for web detection requests.
-        # This is used on {Project#annotate} as well as {Image#web}.
-        #
-        # The default value is 100.
-        #
-        # This is also available on the configuration as
-        # `Google::Cloud::Vision.configure.default_max_web`
-        #
-        # @example Using the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_web #=> 100
-        #
-        #   img = "path/to/landmarks.jpg"
-        #   annotation = vision.annotate img, web: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate img, web: 100
-        #
-        # @example Updating the default setting on {Project#annotate}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_web = 5
-        #
-        #   img = "path/to/landmarks.jpg"
-        #   annotation = vision.annotate img, web: true
-        #   # This is the same as calling
-        #   # annotation = vision.annotate img, web: 5
-        #
-        #
-        # @example Using the default setting on {Image#web}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   Google::Cloud::Vision.default_max_web #=> 100
-        #
-        #   web = vision.image("path/to/landmarks.jpg").web
-        #   # This is the same as calling
-        #   # web = vision.image("path/to/landmarks.jpg").web 100
-        #
-        # @example Updating the default setting on {Image#web}:
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   # Set a new default
-        #   Google::Cloud::Vision.default_max_web = 5
-        #
-        #   web = vision.image("path/to/landmarks.jpg").web
-        #   # This is the same as calling
-        #   # web = vision.image("path/to/landmarks.jpg").web 5
-        #
-        def default_max_web= value
-          configure.default_max_web = value
-        end
+      AVAILABLE_VERSIONS = Dir["#{FILE_DIR}/*"]
+        .select { |file| File.directory?(file) }
+        .select { |dir| Google::Gax::VERSION_MATCHER.match(File.basename(dir)) }
+        .select { |dir| File.exist?(dir + ".rb") }
+        .map { |dir| File.basename(dir) }
 
+      module ProductSearch
         ##
-        # The default max results to return for web detection requests.
-        #
-        def default_max_web
-          configure.default_max_web
-        end
-
-        def default_max_object_localizations= value
-          configure.default_max_object_localizations = value
-        end
-
-        def default_max_object_localizations
-          configure.default_max_object_localizations
+        # 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
+        #   is used.
+        # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
+        #   @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
+        #     be many types.
+        #     A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+        #     authenticating requests made by this client.
+        #     A `String` will be treated as the path to the keyfile to be used for the construction of
+        #     credentials for this client.
+        #     A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+        #     credentials for this client.
+        #     A `GRPC::Core::Channel` will be used to make calls through.
+        #     A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+        #     should already be composed with a `GRPC::Core::CallCredentials` object.
+        #     A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+        #     metadata for requests, generally, to give OAuth credentials.
+        #   @param scopes [Array<String>]
+        #     The OAuth scopes for this service. This parameter is ignored if
+        #     an updater_proc is supplied.
+        #   @param client_config [Hash]
+        #     A Hash for call options for each method. See
+        #     Google::Gax#construct_settings for the structure of
+        #     this data. Falls back to the default config if not specified
+        #     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(*args, version: :v1, **kwargs)
+          unless AVAILABLE_VERSIONS.include?(version.to_s.downcase)
+            raise "The version: #{version} is not available. The available versions " \
+              "are: [#{AVAILABLE_VERSIONS.join(", ")}]"
+          end
+
+          require "#{FILE_DIR}/#{version.to_s.downcase}"
+          version_module = Google::Cloud::Vision
+            .constants
+            .select {|sym| sym.to_s.downcase == version.to_s.downcase}
+            .first
+          Google::Cloud::Vision.const_get(version_module)::ProductSearch.new(*args, **kwargs)
         end
       end
 
-      ##
-      # Creates a new object for connecting to the Vision service.
-      # Each call creates a new connection.
-      #
-      # @param [String] project_id Project identifier for the Vision service you
-      #   are connecting to. If not present, the default project for the
-      #   credentials is used.
-      # @param [String, Hash, Google::Auth::Credentials] credentials The path to
-      #   the keyfile as a String, the contents of the keyfile as a Hash, or a
-      #   Google::Auth::Credentials object. (See {Vision::Credentials})
-      # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling
-      #   the set of resources and operations that the connection can access.
-      #   See [Using OAuth 2.0 to Access Google
-      #   APIs](https://developers.google.com/identity/protocols/OAuth2).
-      #
-      #   The default scope is:
-      #
-      #   * `https://www.googleapis.com/auth/cloud-platform`
-      # @param [Integer] timeout Default timeout to use in requests. Optional.
-      # @param [Hash] client_config A hash of values to override the default
-      #   behavior of the API client. Optional.
-      # @param [String] project Alias for the `project_id` argument. Deprecated.
-      # @param [String] keyfile Alias for the `credentials` argument.
-      #   Deprecated.
-      #
-      # @return [Google::Cloud::Vision::Project]
-      #
-      # @example
-      #   require "google/cloud/vision"
-      #
-      #   vision = Google::Cloud::Vision.new
-      #
-      #   image = vision.image "path/to/landmark.jpg"
-      #
-      #   landmark = image.landmark
-      #   landmark.description #=> "Mount Rushmore"
-      #
-      def self.new project_id: nil, credentials: nil, scope: nil, timeout: nil,
-                   client_config: nil, project: nil, keyfile: nil
-        project_id ||= (project || default_project_id)
-        project_id = project_id.to_s # Always cast to a string
-        raise ArgumentError, "project_id is missing" if project_id.empty?
-
-        scope ||= configure.scope
-        timeout ||= configure.timeout
-        client_config ||= configure.client_config
-        credentials ||= (keyfile || default_credentials(scope: scope))
-        unless credentials.is_a? Google::Auth::Credentials
-          credentials = Vision::Credentials.new credentials, scope: scope
+      module ImageAnnotator
+        ##
+        # 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
+        #   is used.
+        # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
+        #   @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
+        #     be many types.
+        #     A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+        #     authenticating requests made by this client.
+        #     A `String` will be treated as the path to the keyfile to be used for the construction of
+        #     credentials for this client.
+        #     A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+        #     credentials for this client.
+        #     A `GRPC::Core::Channel` will be used to make calls through.
+        #     A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+        #     should already be composed with a `GRPC::Core::CallCredentials` object.
+        #     A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+        #     metadata for requests, generally, to give OAuth credentials.
+        #   @param scopes [Array<String>]
+        #     The OAuth scopes for this service. This parameter is ignored if
+        #     an updater_proc is supplied.
+        #   @param client_config [Hash]
+        #     A Hash for call options for each method. See
+        #     Google::Gax#construct_settings for the structure of
+        #     this data. Falls back to the default config if not specified
+        #     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(*args, version: :v1, **kwargs)
+          unless AVAILABLE_VERSIONS.include?(version.to_s.downcase)
+            raise "The version: #{version} is not available. The available versions " \
+              "are: [#{AVAILABLE_VERSIONS.join(", ")}]"
+          end
+
+          require "#{FILE_DIR}/#{version.to_s.downcase}"
+          version_module = Google::Cloud::Vision
+            .constants
+            .select {|sym| sym.to_s.downcase == version.to_s.downcase}
+            .first
+          Google::Cloud::Vision.const_get(version_module)::ImageAnnotator.new(*args, **kwargs)
         end
-
-        Vision::Project.new(
-          Vision::Service.new(
-            project_id, credentials, timeout: timeout,
-                                     client_config: client_config
-          )
-        )
-      end
-
-      ##
-      # Configure the Google Cloud Vision library.
-      #
-      # The following Vision configuration parameters are supported:
-      #
-      # * `project_id` - (String) Identifier for a Vision project. (The
-      #   parameter `project` is considered deprecated, but may also be used.)
-      # * `credentials` - (String, Hash, Google::Auth::Credentials) The path to
-      #   the keyfile as a String, the contents of the keyfile as a Hash, or a
-      #   Google::Auth::Credentials object. (See {Vision::Credentials}) (The
-      #   parameter `keyfile` is considered deprecated, but may also be used.)
-      # * `scope` - (String, Array<String>) The OAuth 2.0 scopes controlling
-      #   the set of resources and operations that the connection can access.
-      # * `timeout` - (Integer) Default timeout to use in requests.
-      # * `client_config` - (Hash) A hash of values to override the default
-      #   behavior of the API client.
-      # * `default_max_faces` - (Integer) The default max results to return for
-      #   facial detection requests. See {Vision.default_max_faces=}.
-      # * `default_max_landmarks` - (Integer) The default max results to return
-      #   for landmark detection requests. See {Vision.default_max_landmarks=}.
-      # * `default_max_logos` - (Integer) The default max results to return for
-      #   logo detection requests. See {Vision.default_max_logos=}.
-      # * `default_max_labels` - (Integer) The default max results to return for
-      #   label detection requests. See {Vision.default_max_labels=}.
-      # * `default_max_crop_hints` - (Integer) The default max results to return
-      #   for crop hints detection requests. See
-      #   {Vision.default_max_crop_hints=}.
-      # * `default_max_web` - (Integer) The default max results to return for
-      #   web detection requests. See {Vision.default_max_faces=}.
-      #
-      # @return [Google::Cloud::Config] The configuration object the
-      #   Google::Cloud::Vision library uses.
-      #
-      def self.configure
-        yield Google::Cloud.configure.vision if block_given?
-
-        Google::Cloud.configure.vision
-      end
-
-      ##
-      # @private Default project.
-      def self.default_project_id
-        Google::Cloud.configure.vision.project_id ||
-          Google::Cloud.configure.project_id ||
-          Google::Cloud.env.project_id
-      end
-
-      ##
-      # @private Default credentials.
-      def self.default_credentials scope: nil
-        Google::Cloud.configure.vision.credentials ||
-          Google::Cloud.configure.credentials ||
-          Vision::Credentials.default(scope: scope)
       end
     end
   end