google-cloud-vision 0.31.0 → 0.32.0

data/lib/google/cloud/vision/v1p3beta1/text_annotation_pb.rb

@@ -0,0 +1,94 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision/v1p3beta1/text_annotation.proto
+
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/cloud/vision/v1p3beta1/geometry_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.cloud.vision.v1p3beta1.TextAnnotation" do
+    repeated :pages, :message, 1, "google.cloud.vision.v1p3beta1.Page"
+    optional :text, :string, 2
+  end
+  add_message "google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage" do
+    optional :language_code, :string, 1
+    optional :confidence, :float, 2
+  end
+  add_message "google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak" do
+    optional :type, :enum, 1, "google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak.BreakType"
+    optional :is_prefix, :bool, 2
+  end
+  add_enum "google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak.BreakType" do
+    value :UNKNOWN, 0
+    value :SPACE, 1
+    value :SURE_SPACE, 2
+    value :EOL_SURE_SPACE, 3
+    value :HYPHEN, 4
+    value :LINE_BREAK, 5
+  end
+  add_message "google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty" do
+    repeated :detected_languages, :message, 1, "google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage"
+    optional :detected_break, :message, 2, "google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak"
+  end
+  add_message "google.cloud.vision.v1p3beta1.Page" do
+    optional :property, :message, 1, "google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty"
+    optional :width, :int32, 2
+    optional :height, :int32, 3
+    repeated :blocks, :message, 4, "google.cloud.vision.v1p3beta1.Block"
+    optional :confidence, :float, 5
+  end
+  add_message "google.cloud.vision.v1p3beta1.Block" do
+    optional :property, :message, 1, "google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty"
+    optional :bounding_box, :message, 2, "google.cloud.vision.v1p3beta1.BoundingPoly"
+    repeated :paragraphs, :message, 3, "google.cloud.vision.v1p3beta1.Paragraph"
+    optional :block_type, :enum, 4, "google.cloud.vision.v1p3beta1.Block.BlockType"
+    optional :confidence, :float, 5
+  end
+  add_enum "google.cloud.vision.v1p3beta1.Block.BlockType" do
+    value :UNKNOWN, 0
+    value :TEXT, 1
+    value :TABLE, 2
+    value :PICTURE, 3
+    value :RULER, 4
+    value :BARCODE, 5
+  end
+  add_message "google.cloud.vision.v1p3beta1.Paragraph" do
+    optional :property, :message, 1, "google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty"
+    optional :bounding_box, :message, 2, "google.cloud.vision.v1p3beta1.BoundingPoly"
+    repeated :words, :message, 3, "google.cloud.vision.v1p3beta1.Word"
+    optional :confidence, :float, 4
+  end
+  add_message "google.cloud.vision.v1p3beta1.Word" do
+    optional :property, :message, 1, "google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty"
+    optional :bounding_box, :message, 2, "google.cloud.vision.v1p3beta1.BoundingPoly"
+    repeated :symbols, :message, 3, "google.cloud.vision.v1p3beta1.Symbol"
+    optional :confidence, :float, 4
+  end
+  add_message "google.cloud.vision.v1p3beta1.Symbol" do
+    optional :property, :message, 1, "google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty"
+    optional :bounding_box, :message, 2, "google.cloud.vision.v1p3beta1.BoundingPoly"
+    optional :text, :string, 3
+    optional :confidence, :float, 4
+  end
+end
+
+module Google
+  module Cloud
+    module Vision
+      module V1p3beta1
+        TextAnnotation = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.TextAnnotation").msgclass
+        TextAnnotation::DetectedLanguage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage").msgclass
+        TextAnnotation::DetectedBreak = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak").msgclass
+        TextAnnotation::DetectedBreak::BreakType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak.BreakType").enummodule
+        TextAnnotation::TextProperty = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty").msgclass
+        Page = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.Page").msgclass
+        Block = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.Block").msgclass
+        Block::BlockType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.Block.BlockType").enummodule
+        Paragraph = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.Paragraph").msgclass
+        Word = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.Word").msgclass
+        Symbol = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.Symbol").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/vision/v1p3beta1/web_detection_pb.rb

@@ -0,0 +1,51 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision/v1p3beta1/web_detection.proto
+
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.cloud.vision.v1p3beta1.WebDetection" do
+    repeated :web_entities, :message, 1, "google.cloud.vision.v1p3beta1.WebDetection.WebEntity"
+    repeated :full_matching_images, :message, 2, "google.cloud.vision.v1p3beta1.WebDetection.WebImage"
+    repeated :partial_matching_images, :message, 3, "google.cloud.vision.v1p3beta1.WebDetection.WebImage"
+    repeated :pages_with_matching_images, :message, 4, "google.cloud.vision.v1p3beta1.WebDetection.WebPage"
+    repeated :visually_similar_images, :message, 6, "google.cloud.vision.v1p3beta1.WebDetection.WebImage"
+    repeated :best_guess_labels, :message, 8, "google.cloud.vision.v1p3beta1.WebDetection.WebLabel"
+  end
+  add_message "google.cloud.vision.v1p3beta1.WebDetection.WebEntity" do
+    optional :entity_id, :string, 1
+    optional :score, :float, 2
+    optional :description, :string, 3
+  end
+  add_message "google.cloud.vision.v1p3beta1.WebDetection.WebImage" do
+    optional :url, :string, 1
+    optional :score, :float, 2
+  end
+  add_message "google.cloud.vision.v1p3beta1.WebDetection.WebPage" do
+    optional :url, :string, 1
+    optional :score, :float, 2
+    optional :page_title, :string, 3
+    repeated :full_matching_images, :message, 4, "google.cloud.vision.v1p3beta1.WebDetection.WebImage"
+    repeated :partial_matching_images, :message, 5, "google.cloud.vision.v1p3beta1.WebDetection.WebImage"
+  end
+  add_message "google.cloud.vision.v1p3beta1.WebDetection.WebLabel" do
+    optional :label, :string, 1
+    optional :language_code, :string, 2
+  end
+end
+
+module Google
+  module Cloud
+    module Vision
+      module V1p3beta1
+        WebDetection = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.WebDetection").msgclass
+        WebDetection::WebEntity = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.WebDetection.WebEntity").msgclass
+        WebDetection::WebImage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.WebDetection.WebImage").msgclass
+        WebDetection::WebPage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.WebDetection.WebPage").msgclass
+        WebDetection::WebLabel = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1p3beta1.WebDetection.WebLabel").msgclass
+      end
+    end
+  end
+end

metadata

@@ -1,30 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-vision
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.32.0
 platform: ruby
 authors:
-- Mike Moore
-- Chris Smith
+- Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-26 00:00:00.000000000 Z
+date: 2018-11-30 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: google-cloud-core
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: google-gax
   requirement: !ruby/object:Gem::Requirement
@@ -53,62 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.10'
-- !ruby/object:Gem::Dependency
-  name: minitest-autotest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: minitest-focus
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-- !ruby/object:Gem::Dependency
-  name: minitest-rg
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.2'
-- !ruby/object:Gem::Dependency
-  name: autotest-suffix
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -129,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: 0.59.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: 0.59.2
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -165,81 +94,83 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: yard-doctest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.13
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.13
-description: google-cloud-vision is the official library for Google Cloud Vision API.
-email:
-- mike@blowmage.com
-- quartzmo@gmail.com
+description: google-cloud-vision is the official library for Cloud Vision API.
+email: googleapis-packages@google.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
-- AUTHENTICATION.md
-- CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
 - LICENSE
-- LOGGING.md
-- OVERVIEW.md
-- TROUBLESHOOTING.md
-- lib/google-cloud-vision.rb
+- README.md
 - lib/google/cloud/vision.rb
-- lib/google/cloud/vision/annotate.rb
-- lib/google/cloud/vision/annotation.rb
-- lib/google/cloud/vision/annotation/crop_hint.rb
-- lib/google/cloud/vision/annotation/entity.rb
-- lib/google/cloud/vision/annotation/face.rb
-- lib/google/cloud/vision/annotation/normalized_vertex.rb
-- lib/google/cloud/vision/annotation/object_localization.rb
-- lib/google/cloud/vision/annotation/properties.rb
-- lib/google/cloud/vision/annotation/safe_search.rb
-- lib/google/cloud/vision/annotation/text.rb
-- lib/google/cloud/vision/annotation/vertex.rb
-- lib/google/cloud/vision/annotation/web.rb
-- lib/google/cloud/vision/credentials.rb
-- lib/google/cloud/vision/image.rb
-- lib/google/cloud/vision/location.rb
-- lib/google/cloud/vision/project.rb
-- lib/google/cloud/vision/service.rb
 - lib/google/cloud/vision/v1.rb
 - lib/google/cloud/vision/v1/credentials.rb
 - lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/geometry.rb
 - lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb
+- lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/product_search.rb
+- lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/product_search_service.rb
 - lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/text_annotation.rb
 - lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/web_detection.rb
 - lib/google/cloud/vision/v1/doc/google/longrunning/operations.rb
 - lib/google/cloud/vision/v1/doc/google/protobuf/any.rb
+- lib/google/cloud/vision/v1/doc/google/protobuf/empty.rb
+- lib/google/cloud/vision/v1/doc/google/protobuf/field_mask.rb
+- lib/google/cloud/vision/v1/doc/google/protobuf/timestamp.rb
 - lib/google/cloud/vision/v1/doc/google/protobuf/wrappers.rb
 - lib/google/cloud/vision/v1/doc/google/rpc/status.rb
 - lib/google/cloud/vision/v1/doc/google/type/color.rb
 - lib/google/cloud/vision/v1/doc/google/type/latlng.rb
 - lib/google/cloud/vision/v1/geometry_pb.rb
+- lib/google/cloud/vision/v1/helpers.rb
 - lib/google/cloud/vision/v1/image_annotator_client.rb
 - lib/google/cloud/vision/v1/image_annotator_client_config.json
 - lib/google/cloud/vision/v1/image_annotator_pb.rb
 - lib/google/cloud/vision/v1/image_annotator_services_pb.rb
+- lib/google/cloud/vision/v1/product_search_client.rb
+- lib/google/cloud/vision/v1/product_search_client_config.json
+- lib/google/cloud/vision/v1/product_search_pb.rb
+- lib/google/cloud/vision/v1/product_search_service_pb.rb
+- lib/google/cloud/vision/v1/product_search_service_services_pb.rb
 - lib/google/cloud/vision/v1/text_annotation_pb.rb
 - lib/google/cloud/vision/v1/web_detection_pb.rb
-- lib/google/cloud/vision/version.rb
+- lib/google/cloud/vision/v1p3beta1.rb
+- lib/google/cloud/vision/v1p3beta1/credentials.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/cloud/vision/v1p3beta1/geometry.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/cloud/vision/v1p3beta1/image_annotator.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/cloud/vision/v1p3beta1/product_search.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/cloud/vision/v1p3beta1/product_search_service.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/cloud/vision/v1p3beta1/text_annotation.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/cloud/vision/v1p3beta1/web_detection.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/longrunning/operations.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/protobuf/any.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/protobuf/empty.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/protobuf/field_mask.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/protobuf/timestamp.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/protobuf/wrappers.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/rpc/status.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/type/color.rb
+- lib/google/cloud/vision/v1p3beta1/doc/google/type/latlng.rb
+- lib/google/cloud/vision/v1p3beta1/geometry_pb.rb
+- lib/google/cloud/vision/v1p3beta1/helpers.rb
+- lib/google/cloud/vision/v1p3beta1/image_annotator_client.rb
+- lib/google/cloud/vision/v1p3beta1/image_annotator_client_config.json
+- lib/google/cloud/vision/v1p3beta1/image_annotator_pb.rb
+- lib/google/cloud/vision/v1p3beta1/image_annotator_services_pb.rb
+- lib/google/cloud/vision/v1p3beta1/product_search_client.rb
+- lib/google/cloud/vision/v1p3beta1/product_search_client_config.json
+- lib/google/cloud/vision/v1p3beta1/product_search_pb.rb
+- lib/google/cloud/vision/v1p3beta1/product_search_service_pb.rb
+- lib/google/cloud/vision/v1p3beta1/product_search_service_services_pb.rb
+- lib/google/cloud/vision/v1p3beta1/text_annotation_pb.rb
+- lib/google/cloud/vision/v1p3beta1/web_detection_pb.rb
 homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/google-cloud-vision
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message: '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.'
 rdoc_options: []
 require_paths:
 - lib
@@ -258,5 +189,5 @@ rubyforge_project:
 rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
-summary: API Client library for Google Cloud Vision API
+summary: API Client library for Cloud Vision API
 test_files: []

data/AUTHENTICATION.md

@@ -1,179 +0,0 @@
-# Authentication
-
-In general, the google-cloud-vision library uses [Service
-Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
-credentials to connect to Google Cloud services. When running on Compute Engine
-the credentials will be discovered automatically. When running on other
-environments, the Service Account credentials can be specified by providing the
-path to the [JSON
-keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys) for
-the account (or the JSON itself) in environment variables. Additionally, Cloud
-SDK credentials can also be discovered automatically, but this is only
-recommended during development.
-
-## Project and Credential Lookup
-
-The google-cloud-vision library aims to make authentication as simple as
-possible, and provides several mechanisms to configure your system without
-providing **Project ID** and **Service Account Credentials** directly in code.
-
-**Project ID** is discovered in the following order:
-
-1. Specify project ID in method arguments
-2. Specify project ID in configuration
-3. Discover project ID in environment variables
-4. Discover GCE project ID
-
-**Credentials** are discovered in the following order:
-
-1. Specify credentials in method arguments
-2. Specify credentials in configuration
-3. Discover credentials path in environment variables
-4. Discover credentials JSON in environment variables
-5. Discover credentials file in the Cloud SDK's path
-6. Discover GCE credentials
-
-### Google Cloud Platform environments
-
-While running on Google Cloud Platform environments such as Google Compute
-Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed.
-The **Project ID** and **Credentials** and are discovered automatically. Code
-should be written as if already authenticated. Just be sure when you [set up the
-GCE instance][gce-how-to], you add the correct scopes for the APIs you want to
-access. For example:
-
-  * **All APIs**
-    * `https://www.googleapis.com/auth/cloud-platform`
-    * `https://www.googleapis.com/auth/cloud-platform.read-only`
-  * **BigQuery**
-    * `https://www.googleapis.com/auth/bigquery`
-    * `https://www.googleapis.com/auth/bigquery.insertdata`
-  * **Compute Engine**
-    * `https://www.googleapis.com/auth/compute`
-  * **Datastore**
-    * `https://www.googleapis.com/auth/datastore`
-    * `https://www.googleapis.com/auth/userinfo.email`
-  * **DNS**
-    * `https://www.googleapis.com/auth/ndev.clouddns.readwrite`
-  * **Pub/Sub**
-    * `https://www.googleapis.com/auth/pubsub`
-  * **Storage**
-    * `https://www.googleapis.com/auth/devstorage.full_control`
-    * `https://www.googleapis.com/auth/devstorage.read_only`
-    * `https://www.googleapis.com/auth/devstorage.read_write`
-
-### Environment Variables
-
-The **Project ID** and **Credentials JSON** can be placed in environment
-variables instead of declaring them directly in code. Each service has its own
-environment variable, allowing for different service accounts to be used for
-different services. (See the READMEs for the individual service gems for
-details.) The path to the **Credentials JSON** file can be stored in the
-environment variable, or the **Credentials JSON** itself can be stored for
-environments such as Docker containers where writing files is difficult or not
-encouraged.
-
-The environment variables that Vision checks for project ID are:
-
-1. `VISION_PROJECT`
-2. `GOOGLE_CLOUD_PROJECT`
-
-The environment variables that Vision checks for credentials are configured on
-{Google::Cloud::Vision::V1::Credentials}:
-
-1. `VISION_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `VISION_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
-
-```ruby
-require "google/cloud/vision"
-
-ENV["VISION_PROJECT"]     = "my-project-id"
-ENV["VISION_CREDENTIALS"] = "path/to/keyfile.json"
-
-vision = Google::Cloud::Vision.new
-```
-
-### Configuration
-
-The **Project ID** and **Credentials JSON** can be configured instead of placing them in environment variables or providing them as arguments.
-
-```ruby
-require "google/cloud/vision"
-
-Google::Cloud::Vision.configure do |config|
-  config.project_id  = "my-project-id"
-  config.credentials = "path/to/keyfile.json"
-end
-
-vision = Google::Cloud::Vision.new
-```
-
-### Cloud SDK
-
-This option allows for an easy way to authenticate during development. If
-credentials are not provided in code or in environment variables, then Cloud SDK
-credentials are discovered.
-
-To configure your system for this, simply:
-
-1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
-3. Write code as if already authenticated.
-
-**NOTE:** This is _not_ recommended for running in production. The Cloud SDK
-*should* only be used during development.
-
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
-## Creating a Service Account
-
-Google Cloud requires a **Project ID** and **Service Account Credentials** to
-connect to the APIs. You will use the **Project ID** and **JSON key file** to
-connect to most services with google-cloud-vision.
-
-If you are not running this client on Google Compute Engine, you need a Google
-Developers service account.
-
-1. Visit the [Google Developers Console][dev-console].
-1. Create a new project or click on an existing project.
-1. Activate the slide-out navigation tray and select **API Manager**. From
-   here, you will enable the APIs that your application requires.
-
-   ![Enable the APIs that your application requires][enable-apis]
-
-   *Note: You may need to enable billing in order to use these services.*
-
-1. Select **Credentials** from the side navigation.
-
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
-
-   If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
-
-   The key file you download will be used by this library to authenticate API
-   requests and should be stored in a secure location.
-
-## Troubleshooting
-
-If you're having trouble authenticating you can ask for help by following the
-{file:TROUBLESHOOTING.md Troubleshooting Guide}.