google-cloud-vision 0.34.0 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28fd98f624d5cfc073c4a97134b284bc7469f3ab3c2f93b03b81bf8a272df577
-  data.tar.gz: c62874f495e20ce8a9cbfd2aac394694acf6479f433e0491930ebf029d9c6fcd
+  metadata.gz: 87ba7f880087f96739437e7d73a2a4f094b21f5a25a881fee6abe2aa8a050f2f
+  data.tar.gz: 601339912d7b2df023c04b3f915c19182c46aba05808187d2655aa851c51df2f
 SHA512:
-  metadata.gz: 2a6d40a407815737957bf83ed7324af52a6f07f59863c774f658d722ff5112a211ef8b23f76f5afe35dabe1fe076fcc4ef60c6a0b6cc8f818ff9f04ae4295d13
-  data.tar.gz: d9944f3f13445f20c9e9fb78b7220a75e2c71f3101baf02a3e0280c78f63a4a3b3918fb4f4ddceed624a7de1c3e40a98cfe35a84737ace080d4fc2fed16b1134
+  metadata.gz: e73a8ef684bf122c86ae5f3f79ba4417b4e0de059ee184fcca5b58979ccd2e94f965033a862de28bec1bbf19d77040e1eeea4a1dba0b1307635380804b17d757
+  data.tar.gz: 2677ac71fa18ac2e67e71608de678e390cea2a9f2230bf5c8c22ac2ed3d21d151e67f43f390bd382f8b3bfd6a2fcb30d466b882e3fbe0d77f842ed173802a981

data/README.md

@@ -14,7 +14,7 @@ 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)
+4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-vision/latest/file.AUTHENTICATION.html)
 
 ### Installation
 ```
@@ -53,14 +53,14 @@ response = image_annotator_client.batch_annotate_images(requests)
 - 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
+[Client Library Documentation]: https://googleapis.dev/ruby/google-cloud-vision/latest
 [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)
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 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.
 

data/lib/google/cloud/vision.rb

@@ -36,7 +36,7 @@ module Google
     # 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)
+    # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-vision/latest/file.AUTHENTICATION.html)
     #
     # ### Installation
     # ```
@@ -79,7 +79,7 @@ module Google
     #
     # 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)
+    # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
     # 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.
     #

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

@@ -40,7 +40,7 @@ module Google
       # 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)
+      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-vision/latest/file.AUTHENTICATION.html)
       #
       # ### Installation
       # ```
@@ -76,7 +76,7 @@ module Google
       #
       # 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)
+      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
       # 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.
       #

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

@@ -600,16 +600,35 @@ module Google
         #     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.
+        #     Individual responses to images found within the file. This field will be
+        #     empty if the `error` field is set.
         # @!attribute [rw] total_pages
         #   @return [Integer]
         #     This field gives the total number of pages in the file.
+        # @!attribute [rw] error
+        #   @return [Google::Rpc::Status]
+        #     If set, represents the error message for the failed request. The
+        #     `responses` field will not be set in this case.
         class AnnotateFileResponse; end
 
         # Multiple image annotation requests are batched into a single service call.
         # @!attribute [rw] requests
         #   @return [Array<Google::Cloud::Vision::V1::AnnotateImageRequest>]
         #     Individual image annotation requests for this batch.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Optional. Target project and location to make a call.
+        #
+        #     Format: `projects/{project-id}/locations/{location-id}`.
+        #
+        #     If no parent is specified, a region will be chosen automatically.
+        #
+        #     Supported location-ids:
+        #         `us`: USA country only,
+        #         `asia`: East asia areas, like Japan, Taiwan,
+        #         `eu`: The European Union.
+        #
+        #     Example: `projects/project-A/locations/eu`.
         class BatchAnnotateImagesRequest; end
 
         # Response to a batch image annotation request.
@@ -651,6 +670,20 @@ module Google
         #   @return [Array<Google::Cloud::Vision::V1::AnnotateFileRequest>]
         #     The list of file annotation requests. Right now we support only one
         #     AnnotateFileRequest in BatchAnnotateFilesRequest.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Optional. Target project and location to make a call.
+        #
+        #     Format: `projects/{project-id}/locations/{location-id}`.
+        #
+        #     If no parent is specified, a region will be chosen automatically.
+        #
+        #     Supported location-ids:
+        #         `us`: USA country only,
+        #         `asia`: East asia areas, like Japan, Taiwan,
+        #         `eu`: The European Union.
+        #
+        #     Example: `projects/project-A/locations/eu`.
         class BatchAnnotateFilesRequest; end
 
         # A list of file annotation responses.
@@ -688,6 +721,20 @@ module Google
         # @!attribute [rw] output_config
         #   @return [Google::Cloud::Vision::V1::OutputConfig]
         #     Required. The desired output location and metadata (e.g. format).
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Optional. Target project and location to make a call.
+        #
+        #     Format: `projects/{project-id}/locations/{location-id}`.
+        #
+        #     If no parent is specified, a region will be chosen automatically.
+        #
+        #     Supported location-ids:
+        #         `us`: USA country only,
+        #         `asia`: East asia areas, like Japan, Taiwan,
+        #         `eu`: The European Union.
+        #
+        #     Example: `projects/project-A/locations/eu`.
         class AsyncBatchAnnotateImagesRequest; end
 
         # Response to an async batch image annotation request.
@@ -701,6 +748,20 @@ module Google
         # @!attribute [rw] requests
         #   @return [Array<Google::Cloud::Vision::V1::AsyncAnnotateFileRequest>]
         #     Individual async file annotation requests for this batch.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Optional. Target project and location to make a call.
+        #
+        #     Format: `projects/{project-id}/locations/{location-id}`.
+        #
+        #     If no parent is specified, a region will be chosen automatically.
+        #
+        #     Supported location-ids:
+        #         `us`: USA country only,
+        #         `asia`: East asia areas, like Japan, Taiwan,
+        #         `eu`: The European Union.
+        #
+        #     Example: `projects/project-A/locations/eu`.
         class AsyncBatchAnnotateFilesRequest; end
 
         # Response to an async batch file annotation request.
@@ -817,19 +878,19 @@ module Google
           # Unknown likelihood.
           UNKNOWN = 0
 
-          # It is very unlikely that the image belongs to the specified vertical.
+          # It is very unlikely.
           VERY_UNLIKELY = 1
 
-          # It is unlikely that the image belongs to the specified vertical.
+          # It is unlikely.
           UNLIKELY = 2
 
-          # It is possible that the image belongs to the specified vertical.
+          # It is possible.
           POSSIBLE = 3
 
-          # It is likely that the image belongs to the specified vertical.
+          # It is likely.
           LIKELY = 4
 
-          # It is very likely that the image belongs to the specified vertical.
+          # It is very likely.
           VERY_LIKELY = 5
         end
       end

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

@@ -80,6 +80,23 @@ module Google
           #     to the query.
           class Result; end
 
+          # Prediction for what the object in the bounding box is.
+          # @!attribute [rw] mid
+          #   @return [String]
+          #     Object ID that should align with EntityAnnotation mid.
+          # @!attribute [rw] language_code
+          #   @return [String]
+          #     The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+          #     information, see
+          #     http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+          # @!attribute [rw] name
+          #   @return [String]
+          #     Object name, expressed in its `language_code` language.
+          # @!attribute [rw] score
+          #   @return [Float]
+          #     Score of the result. Range [0, 1].
+          class ObjectAnnotation; end
+
           # Information about the products similar to a single product in a query
           # image.
           # @!attribute [rw] bounding_poly
@@ -88,6 +105,9 @@ module Google
           # @!attribute [rw] results
           #   @return [Array<Google::Cloud::Vision::V1::ProductSearchResults::Result>]
           #     List of results, one for each product match.
+          # @!attribute [rw] object_annotations
+          #   @return [Array<Google::Cloud::Vision::V1::ProductSearchResults::ObjectAnnotation>]
+          #     List of generic predictions for the object in the bounding box.
           class GroupedResult; end
         end
       end

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

@@ -38,10 +38,8 @@ module Google
         #   @return [String]
         #     The category for the product identified by the reference image. This should
         #     be either "homegoods-v2", "apparel-v2", or "toys-v2". The legacy categories
-        #     "homegoods", "apparel", and "toys" are still supported but will be
-        #     deprecated. For new products, please use "homegoods-v2", "apparel-v2", or
-        #     "toys-v2" for better product search accuracy. It is recommended to migrate
-        #     existing products to these categories as well.
+        #     "homegoods", "apparel", and "toys" are still supported, but these should
+        #     not be used for new products.
         #
         #     This field is immutable.
         # @!attribute [rw] product_labels
@@ -54,7 +52,11 @@ module Google
         #     to be supported soon.
         #
         #     Multiple values can be assigned to the same key. One product may have up to
-        #     100 product_labels.
+        #     500 product_labels.
+        #
+        #     Notice that the total number of distinct product_labels over all products
+        #     in one ProductSet cannot exceed 1M, otherwise the product search pipeline
+        #     will refuse to work for that ProductSet.
         class Product
           # A product label represented as a key-value pair.
           # @!attribute [rw] key
@@ -543,6 +545,33 @@ module Google
             CANCELLED = 4
           end
         end
+
+        # Config to control which ProductSet contains the Products to be deleted.
+        # @!attribute [rw] product_set_id
+        #   @return [String]
+        #     The ProductSet that contains the Products to delete. If a Product is a
+        #     member of product_set_id in addition to other ProductSets, the Product will
+        #     still be deleted.
+        class ProductSetPurgeConfig; end
+
+        # Request message for the `PurgeProducts` method.
+        # @!attribute [rw] product_set_purge_config
+        #   @return [Google::Cloud::Vision::V1::ProductSetPurgeConfig]
+        #     Specify which ProductSet contains the Products to be deleted.
+        # @!attribute [rw] delete_orphan_products
+        #   @return [true, false]
+        #     If delete_orphan_products is true, all Products that are not in any
+        #     ProductSet will be deleted.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     The project and location in which the Products should be deleted.
+        #
+        #     Format is `projects/PROJECT_ID/locations/LOC_ID`.
+        # @!attribute [rw] force
+        #   @return [true, false]
+        #     The default value is false. Override this value to true to actually perform
+        #     the purge.
+        class PurgeProductsRequest; end
       end
     end
   end

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

@@ -185,7 +185,7 @@ module Google
         #         and the vertex order will still be (0, 1, 2, 3).
         # @!attribute [rw] words
         #   @return [Array<Google::Cloud::Vision::V1::Word>]
-        #     List of words in this paragraph.
+        #     List of all words in this paragraph.
         # @!attribute [rw] confidence
         #   @return [Float]
         #     Confidence of the OCR results for the paragraph. Range [0, 1].
@@ -241,7 +241,7 @@ module Google
         #         2----3
         #         |    |
         #         1----0
-        #         and the vertice order will still be (0, 1, 2, 3).
+        #         and the vertex order will still be (0, 1, 2, 3).
         # @!attribute [rw] text
         #   @return [String]
         #     The actual UTF-8 representation of the symbol.

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

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

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

@@ -192,22 +192,34 @@ module Google
             @batch_annotate_images = Google::Gax.create_api_call(
               @image_annotator_stub.method(:batch_annotate_images),
               defaults["batch_annotate_images"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @batch_annotate_files = Google::Gax.create_api_call(
               @image_annotator_stub.method(:batch_annotate_files),
               defaults["batch_annotate_files"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @async_batch_annotate_images = Google::Gax.create_api_call(
               @image_annotator_stub.method(:async_batch_annotate_images),
               defaults["async_batch_annotate_images"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @async_batch_annotate_files = Google::Gax.create_api_call(
               @image_annotator_stub.method(:async_batch_annotate_files),
               defaults["async_batch_annotate_files"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
           end
 
@@ -219,6 +231,19 @@ module Google
           #   Individual image annotation requests for this batch.
           #   A hash of the same form as `Google::Cloud::Vision::V1::AnnotateImageRequest`
           #   can also be provided.
+          # @param parent [String]
+          #   Optional. Target project and location to make a call.
+          #
+          #   Format: `projects/{project-id}/locations/{location-id}`.
+          #
+          #   If no parent is specified, a region will be chosen automatically.
+          #
+          #   Supported location-ids:
+          #       `us`: USA country only,
+          #       `asia`: East asia areas, like Japan, Taiwan,
+          #       `eu`: The European Union.
+          #
+          #   Example: `projects/project-A/locations/eu`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -238,10 +263,12 @@ module Google
 
           def batch_annotate_images \
               requests,
+              parent: nil,
               options: nil,
               &block
             req = {
-              requests: requests
+              requests: requests,
+              parent: parent
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::Vision::V1::BatchAnnotateImagesRequest)
             @batch_annotate_images.call(req, options, &block)
@@ -260,6 +287,19 @@ module Google
           #   AnnotateFileRequest in BatchAnnotateFilesRequest.
           #   A hash of the same form as `Google::Cloud::Vision::V1::AnnotateFileRequest`
           #   can also be provided.
+          # @param parent [String]
+          #   Optional. Target project and location to make a call.
+          #
+          #   Format: `projects/{project-id}/locations/{location-id}`.
+          #
+          #   If no parent is specified, a region will be chosen automatically.
+          #
+          #   Supported location-ids:
+          #       `us`: USA country only,
+          #       `asia`: East asia areas, like Japan, Taiwan,
+          #       `eu`: The European Union.
+          #
+          #   Example: `projects/project-A/locations/eu`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -279,10 +319,12 @@ module Google
 
           def batch_annotate_files \
               requests,
+              parent: nil,
               options: nil,
               &block
             req = {
-              requests: requests
+              requests: requests,
+              parent: parent
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::Vision::V1::BatchAnnotateFilesRequest)
             @batch_annotate_files.call(req, options, &block)
@@ -306,6 +348,19 @@ module Google
           #   Required. The desired output location and metadata (e.g. format).
           #   A hash of the same form as `Google::Cloud::Vision::V1::OutputConfig`
           #   can also be provided.
+          # @param parent [String]
+          #   Optional. Target project and location to make a call.
+          #
+          #   Format: `projects/{project-id}/locations/{location-id}`.
+          #
+          #   If no parent is specified, a region will be chosen automatically.
+          #
+          #   Supported location-ids:
+          #       `us`: USA country only,
+          #       `asia`: East asia areas, like Japan, Taiwan,
+          #       `eu`: The European Union.
+          #
+          #   Example: `projects/project-A/locations/eu`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -352,10 +407,12 @@ module Google
           def async_batch_annotate_images \
               requests,
               output_config,
+              parent: nil,
               options: nil
             req = {
               requests: requests,
-              output_config: output_config
+              output_config: output_config,
+              parent: parent
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::Vision::V1::AsyncBatchAnnotateImagesRequest)
             operation = Google::Gax::Operation.new(
@@ -380,6 +437,19 @@ module Google
           #   Individual async file annotation requests for this batch.
           #   A hash of the same form as `Google::Cloud::Vision::V1::AsyncAnnotateFileRequest`
           #   can also be provided.
+          # @param parent [String]
+          #   Optional. Target project and location to make a call.
+          #
+          #   Format: `projects/{project-id}/locations/{location-id}`.
+          #
+          #   If no parent is specified, a region will be chosen automatically.
+          #
+          #   Supported location-ids:
+          #       `us`: USA country only,
+          #       `asia`: East asia areas, like Japan, Taiwan,
+          #       `eu`: The European Union.
+          #
+          #   Example: `projects/project-A/locations/eu`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -422,9 +492,11 @@ module Google
 
           def async_batch_annotate_files \
               requests,
+              parent: nil,
               options: nil
             req = {
-              requests: requests
+              requests: requests,
+              parent: parent
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::Vision::V1::AsyncBatchAnnotateFilesRequest)
             operation = Google::Gax::Operation.new(

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

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 require 'google/cloud/vision/v1/geometry_pb'
 require 'google/cloud/vision/v1/product_search_pb'
 require 'google/cloud/vision/v1/text_annotation_pb'
@@ -200,9 +201,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :input_config, :message, 1, "google.cloud.vision.v1.InputConfig"
     repeated :responses, :message, 2, "google.cloud.vision.v1.AnnotateImageResponse"
     optional :total_pages, :int32, 3
+    optional :error, :message, 4, "google.rpc.Status"
   end
   add_message "google.cloud.vision.v1.BatchAnnotateImagesRequest" do
     repeated :requests, :message, 1, "google.cloud.vision.v1.AnnotateImageRequest"
+    optional :parent, :string, 4
   end
   add_message "google.cloud.vision.v1.BatchAnnotateImagesResponse" do
     repeated :responses, :message, 1, "google.cloud.vision.v1.AnnotateImageResponse"
@@ -215,6 +218,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   end
   add_message "google.cloud.vision.v1.BatchAnnotateFilesRequest" do
     repeated :requests, :message, 1, "google.cloud.vision.v1.AnnotateFileRequest"
+    optional :parent, :string, 3
   end
   add_message "google.cloud.vision.v1.BatchAnnotateFilesResponse" do
     repeated :responses, :message, 1, "google.cloud.vision.v1.AnnotateFileResponse"
@@ -231,12 +235,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.vision.v1.AsyncBatchAnnotateImagesRequest" do
     repeated :requests, :message, 1, "google.cloud.vision.v1.AnnotateImageRequest"
     optional :output_config, :message, 2, "google.cloud.vision.v1.OutputConfig"
+    optional :parent, :string, 4
   end
   add_message "google.cloud.vision.v1.AsyncBatchAnnotateImagesResponse" do
     optional :output_config, :message, 1, "google.cloud.vision.v1.OutputConfig"
   end
   add_message "google.cloud.vision.v1.AsyncBatchAnnotateFilesRequest" do
     repeated :requests, :message, 1, "google.cloud.vision.v1.AsyncAnnotateFileRequest"
+    optional :parent, :string, 4
   end
   add_message "google.cloud.vision.v1.AsyncBatchAnnotateFilesResponse" do
     repeated :responses, :message, 1, "google.cloud.vision.v1.AsyncAnnotateFileResponse"

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

@@ -444,6 +444,14 @@ module Google
                 {'parent' => request.parent}
               end
             )
+            @purge_products = Google::Gax.create_api_call(
+              @product_search_stub.method(:purge_products),
+              defaults["purge_products"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
+            )
           end
 
           # Service calls
@@ -1376,6 +1384,107 @@ module Google
             operation.on_done { |operation| yield(operation) } if block_given?
             operation
           end
+
+          # Asynchronous API to delete all Products in a ProductSet or all Products
+          # that are in no ProductSet.
+          #
+          # If a Product is a member of the specified ProductSet in addition to other
+          # ProductSets, the Product will still be deleted.
+          #
+          # It is recommended to not delete the specified ProductSet until after this
+          # operation has completed. It is also recommended to not add any of the
+          # Products involved in the batch delete to a new ProductSet while this
+          # operation is running because those Products may still end up deleted.
+          #
+          # It's not possible to undo the PurgeProducts operation. Therefore, it is
+          # recommended to keep the csv files used in ImportProductSets (if that was
+          # how you originally built the Product Set) before starting PurgeProducts, in
+          # case you need to re-import the data after deletion.
+          #
+          # If the plan is to purge all of the Products from a ProductSet and then
+          # re-use the empty ProductSet to re-import new Products into the empty
+          # ProductSet, you must wait until the PurgeProducts operation has finished
+          # for that ProductSet.
+          #
+          # The {Google::Longrunning::Operation} API can be
+          # used to keep track of the progress and results of the request.
+          # `Operation.metadata` contains `BatchOperationMetadata`. (progress)
+          #
+          # @param parent [String]
+          #   The project and location in which the Products should be deleted.
+          #
+          #   Format is `projects/PROJECT_ID/locations/LOC_ID`.
+          # @param product_set_purge_config [Google::Cloud::Vision::V1::ProductSetPurgeConfig | Hash]
+          #   Specify which ProductSet contains the Products to be deleted.
+          #   A hash of the same form as `Google::Cloud::Vision::V1::ProductSetPurgeConfig`
+          #   can also be provided.
+          # @param delete_orphan_products [true, false]
+          #   If delete_orphan_products is true, all Products that are not in any
+          #   ProductSet will be deleted.
+          # @param force [true, false]
+          #   The default value is false. Override this value to true to actually perform
+          #   the purge.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @return [Google::Gax::Operation]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/vision"
+          #
+          #   product_search_client = Google::Cloud::Vision::ProductSearch.new(version: :v1)
+          #   formatted_parent = Google::Cloud::Vision::V1::ProductSearchClient.location_path("[PROJECT]", "[LOCATION]")
+          #
+          #   # Register a callback during the method call.
+          #   operation = product_search_client.purge_products(formatted_parent) do |op|
+          #     raise op.results.message if op.error?
+          #     op_results = op.results
+          #     # Process the results.
+          #
+          #     metadata = op.metadata
+          #     # Process the metadata.
+          #   end
+          #
+          #   # Or use the return value to register a callback.
+          #   operation.on_done do |op|
+          #     raise op.results.message if op.error?
+          #     op_results = op.results
+          #     # Process the results.
+          #
+          #     metadata = op.metadata
+          #     # Process the metadata.
+          #   end
+          #
+          #   # Manually reload the operation.
+          #   operation.reload!
+          #
+          #   # Or block until the operation completes, triggering callbacks on
+          #   # completion.
+          #   operation.wait_until_done!
+
+          def purge_products \
+              parent,
+              product_set_purge_config: nil,
+              delete_orphan_products: nil,
+              force: nil,
+              options: nil
+            req = {
+              parent: parent,
+              product_set_purge_config: product_set_purge_config,
+              delete_orphan_products: delete_orphan_products,
+              force: force
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Vision::V1::PurgeProductsRequest)
+            operation = Google::Gax::Operation.new(
+              @purge_products.call(req, options),
+              @operations_client,
+              Google::Protobuf::Empty,
+              Google::Cloud::Vision::V1::BatchOperationMetadata,
+              call_options: options
+            )
+            operation.on_done { |operation| yield(operation) } if block_given?
+            operation
+          end
         end
       end
     end

data/lib/google/cloud/vision/v1/product_search_client_config.json

@@ -109,6 +109,11 @@
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
+        },
+        "PurgeProducts": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
         }
       }
     }

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

@@ -25,9 +25,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :score, :float, 2
     optional :image, :string, 3
   end
+  add_message "google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation" do
+    optional :mid, :string, 1
+    optional :language_code, :string, 2
+    optional :name, :string, 3
+    optional :score, :float, 4
+  end
   add_message "google.cloud.vision.v1.ProductSearchResults.GroupedResult" do
     optional :bounding_poly, :message, 1, "google.cloud.vision.v1.BoundingPoly"
     repeated :results, :message, 2, "google.cloud.vision.v1.ProductSearchResults.Result"
+    repeated :object_annotations, :message, 3, "google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation"
   end
 end
 
@@ -38,6 +45,7 @@ module Google
         ProductSearchParams = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.ProductSearchParams").msgclass
         ProductSearchResults = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.ProductSearchResults").msgclass
         ProductSearchResults::Result = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.ProductSearchResults.Result").msgclass
+        ProductSearchResults::ObjectAnnotation = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation").msgclass
         ProductSearchResults::GroupedResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.ProductSearchResults.GroupedResult").msgclass
       end
     end

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

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 require 'google/cloud/vision/v1/geometry_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/empty_pb'
@@ -148,6 +149,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :FAILED, 3
     value :CANCELLED, 4
   end
+  add_message "google.cloud.vision.v1.ProductSetPurgeConfig" do
+    optional :product_set_id, :string, 1
+  end
+  add_message "google.cloud.vision.v1.PurgeProductsRequest" do
+    optional :parent, :string, 1
+    optional :force, :bool, 4
+    oneof :target do
+      optional :product_set_purge_config, :message, 2, "google.cloud.vision.v1.ProductSetPurgeConfig"
+      optional :delete_orphan_products, :bool, 3
+    end
+  end
 end
 
 module Google
@@ -185,6 +197,8 @@ module Google
         ImportProductSetsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.ImportProductSetsResponse").msgclass
         BatchOperationMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.BatchOperationMetadata").msgclass
         BatchOperationMetadata::State = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.BatchOperationMetadata.State").enummodule
+        ProductSetPurgeConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.ProductSetPurgeConfig").msgclass
+        PurgeProductsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.PurgeProductsRequest").msgclass
       end
     end
   end

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

@@ -200,6 +200,31 @@ module Google
             # For the format of the csv file please see
             # [ImportProductSetsGcsSource.csv_file_uri][google.cloud.vision.v1.ImportProductSetsGcsSource.csv_file_uri].
             rpc :ImportProductSets, ImportProductSetsRequest, Google::Longrunning::Operation
+            # Asynchronous API to delete all Products in a ProductSet or all Products
+            # that are in no ProductSet.
+            #
+            # If a Product is a member of the specified ProductSet in addition to other
+            # ProductSets, the Product will still be deleted.
+            #
+            # It is recommended to not delete the specified ProductSet until after this
+            # operation has completed. It is also recommended to not add any of the
+            # Products involved in the batch delete to a new ProductSet while this
+            # operation is running because those Products may still end up deleted.
+            #
+            # It's not possible to undo the PurgeProducts operation. Therefore, it is
+            # recommended to keep the csv files used in ImportProductSets (if that was
+            # how you originally built the Product Set) before starting PurgeProducts, in
+            # case you need to re-import the data after deletion.
+            #
+            # If the plan is to purge all of the Products from a ProductSet and then
+            # re-use the empty ProductSet to re-import new Products into the empty
+            # ProductSet, you must wait until the PurgeProducts operation has finished
+            # for that ProductSet.
+            #
+            # The [google.longrunning.Operation][google.longrunning.Operation] API can be
+            # used to keep track of the progress and results of the request.
+            # `Operation.metadata` contains `BatchOperationMetadata`. (progress)
+            rpc :PurgeProducts, PurgeProductsRequest, Google::Longrunning::Operation
           end
 
           Stub = Service.rpc_stub_class

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

@@ -23,10 +23,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :url, :string, 1
     optional :score, :float, 2
   end
-  add_message "google.cloud.vision.v1.WebDetection.WebLabel" do
-    optional :label, :string, 1
-    optional :language_code, :string, 2
-  end
   add_message "google.cloud.vision.v1.WebDetection.WebPage" do
     optional :url, :string, 1
     optional :score, :float, 2
@@ -34,6 +30,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     repeated :full_matching_images, :message, 4, "google.cloud.vision.v1.WebDetection.WebImage"
     repeated :partial_matching_images, :message, 5, "google.cloud.vision.v1.WebDetection.WebImage"
   end
+  add_message "google.cloud.vision.v1.WebDetection.WebLabel" do
+    optional :label, :string, 1
+    optional :language_code, :string, 2
+  end
 end
 
 module Google
@@ -43,8 +43,8 @@ module Google
         WebDetection = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection").msgclass
         WebDetection::WebEntity = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebEntity").msgclass
         WebDetection::WebImage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebImage").msgclass
-        WebDetection::WebLabel = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebLabel").msgclass
         WebDetection::WebPage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebPage").msgclass
+        WebDetection::WebLabel = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.vision.v1.WebDetection.WebLabel").msgclass
       end
     end
   end

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

@@ -40,7 +40,7 @@ module Google
       # 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)
+      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-vision/latest/file.AUTHENTICATION.html)
       #
       # ### Installation
       # ```
@@ -76,7 +76,7 @@ module Google
       #
       # 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)
+      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
       # 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.
       #

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Vision
-      VERSION = "0.34.0".freeze
+      VERSION = "0.35.0".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-vision
 version: !ruby/object:Gem::Version
-  version: 0.34.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-09 00:00:00.000000000 Z
+date: 2019-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -187,7 +187,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.4
 signing_key: 
 specification_version: 4
 summary: API Client library for Cloud Vision API