google-cloud-vision 0.32.2 → 0.32.3

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -37,16 +37,18 @@ module Google
         # 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.
+        # * 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
+        # * 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
+        # * Each {Google::Cloud::Vision::V1::Product Product} has a collection of
+        #   {Google::Cloud::Vision::V1::ReferenceImage ReferenceImage} resources, named
         #   `projects/*/locations/*/products/*/referenceImages/*`
         #
         # @!attribute [r] product_search_stub
@@ -106,18 +108,18 @@ module Google
 
           private_constant :LOCATION_PATH_TEMPLATE
 
-          PRODUCT_SET_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/locations/{location}/productSets/{product_set}"
-          )
-
-          private_constant :PRODUCT_SET_PATH_TEMPLATE
-
           PRODUCT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/locations/{location}/products/{product}"
           )
 
           private_constant :PRODUCT_PATH_TEMPLATE
 
+          PRODUCT_SET_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/locations/{location}/productSets/{product_set}"
+          )
+
+          private_constant :PRODUCT_SET_PATH_TEMPLATE
+
           REFERENCE_IMAGE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}"
           )
@@ -135,29 +137,29 @@ module Google
             )
           end
 
-          # Returns a fully-qualified product_set resource name string.
+          # Returns a fully-qualified product resource name string.
           # @param project [String]
           # @param location [String]
-          # @param product_set [String]
+          # @param product [String]
           # @return [String]
-          def self.product_set_path project, location, product_set
-            PRODUCT_SET_PATH_TEMPLATE.render(
+          def self.product_path project, location, product
+            PRODUCT_PATH_TEMPLATE.render(
               :"project" => project,
               :"location" => location,
-              :"product_set" => product_set
+              :"product" => product
             )
           end
 
-          # Returns a fully-qualified product resource name string.
+          # Returns a fully-qualified product_set resource name string.
           # @param project [String]
           # @param location [String]
-          # @param product [String]
+          # @param product_set [String]
           # @return [String]
-          def self.product_path project, location, product
-            PRODUCT_PATH_TEMPLATE.render(
+          def self.product_set_path project, location, product_set
+            PRODUCT_SET_PATH_TEMPLATE.render(
               :"project" => project,
               :"location" => location,
-              :"product" => product
+              :"product_set" => product_set
             )
           end
 
@@ -291,92 +293,146 @@ module Google
             @create_product = Google::Gax.create_api_call(
               @product_search_stub.method(:create_product),
               defaults["create_product"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @list_products = Google::Gax.create_api_call(
               @product_search_stub.method(:list_products),
               defaults["list_products"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_product = Google::Gax.create_api_call(
               @product_search_stub.method(:get_product),
               defaults["get_product"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @update_product = Google::Gax.create_api_call(
               @product_search_stub.method(:update_product),
               defaults["update_product"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'product.name' => request.product.name}
+              end
             )
             @delete_product = Google::Gax.create_api_call(
               @product_search_stub.method(:delete_product),
               defaults["delete_product"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @list_reference_images = Google::Gax.create_api_call(
               @product_search_stub.method(:list_reference_images),
               defaults["list_reference_images"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_reference_image = Google::Gax.create_api_call(
               @product_search_stub.method(:get_reference_image),
               defaults["get_reference_image"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @delete_reference_image = Google::Gax.create_api_call(
               @product_search_stub.method(:delete_reference_image),
               defaults["delete_reference_image"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @create_reference_image = Google::Gax.create_api_call(
               @product_search_stub.method(:create_reference_image),
               defaults["create_reference_image"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @create_product_set = Google::Gax.create_api_call(
               @product_search_stub.method(:create_product_set),
               defaults["create_product_set"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @list_product_sets = Google::Gax.create_api_call(
               @product_search_stub.method(:list_product_sets),
               defaults["list_product_sets"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_product_set = Google::Gax.create_api_call(
               @product_search_stub.method(:get_product_set),
               defaults["get_product_set"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @update_product_set = Google::Gax.create_api_call(
               @product_search_stub.method(:update_product_set),
               defaults["update_product_set"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'product_set.name' => request.product_set.name}
+              end
             )
             @delete_product_set = Google::Gax.create_api_call(
               @product_search_stub.method(:delete_product_set),
               defaults["delete_product_set"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @add_product_to_product_set = Google::Gax.create_api_call(
               @product_search_stub.method(:add_product_to_product_set),
               defaults["add_product_to_product_set"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @remove_product_from_product_set = Google::Gax.create_api_call(
               @product_search_stub.method(:remove_product_from_product_set),
               defaults["remove_product_from_product_set"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @list_products_in_product_set = Google::Gax.create_api_call(
               @product_search_stub.method(:list_products_in_product_set),
               defaults["list_products_in_product_set"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @import_product_sets = Google::Gax.create_api_call(
               @product_search_stub.method(:import_product_sets),
               defaults["import_product_sets"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
           end
 
@@ -1121,10 +1177,8 @@ module Google
           #
           #   product_search_client = Google::Cloud::Vision::ProductSearch.new(version: :v1)
           #   formatted_name = Google::Cloud::Vision::V1::ProductSearchClient.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
-          #
-          #   # TODO: Initialize `product`:
-          #   product = ''
-          #   product_search_client.add_product_to_product_set(formatted_name, product)
+          #   formatted_product = Google::Cloud::Vision::V1::ProductSearchClient.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+          #   product_search_client.add_product_to_product_set(formatted_name, formatted_product)
 
           def add_product_to_product_set \
               name,
@@ -1168,10 +1222,8 @@ module Google
           #
           #   product_search_client = Google::Cloud::Vision::ProductSearch.new(version: :v1)
           #   formatted_name = Google::Cloud::Vision::V1::ProductSearchClient.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
-          #
-          #   # TODO: Initialize `product`:
-          #   product = ''
-          #   product_search_client.remove_product_from_product_set(formatted_name, product)
+          #   formatted_product = Google::Cloud::Vision::V1::ProductSearchClient.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+          #   product_search_client.remove_product_from_product_set(formatted_name, formatted_product)
 
           def remove_product_from_product_set \
               name,
@@ -1253,8 +1305,8 @@ module Google
           # Asynchronous API that imports a list of reference images to specified
           # product sets based on a list of image information.
           #
-          # The {Google::Longrunning::Operation} API can be used to keep track of the
-          # progress and results of the request.
+          # The {Google::Longrunning::Operation} API can be
+          # used to keep track of the progress and results of the request.
           # `Operation.metadata` contains `BatchOperationMetadata`. (progress)
           # `Operation.response` contains `ImportProductSetsResponse`. (results)
           #

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

@@ -29,16 +29,18 @@ module Google
           # Manages Products and ProductSets of reference images for use in product
           # search. It uses the following resource model:
           #
-          # - The API has a collection of [ProductSet][google.cloud.vision.v1.ProductSet] resources, named
-          # `projects/*/locations/*/productSets/*`, which acts as a way to put different
-          # products into groups to limit identification.
+          # - The API has a collection of [ProductSet][google.cloud.vision.v1.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 [Product][google.cloud.vision.v1.Product] resources, named
+          # - The API has a collection of [Product][google.cloud.vision.v1.Product]
+          # resources, named
           #   `projects/*/locations/*/products/*`
           #
-          # - Each [Product][google.cloud.vision.v1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1.ReferenceImage] resources, named
+          # - Each [Product][google.cloud.vision.v1.Product] has a collection of
+          # [ReferenceImage][google.cloud.vision.v1.ReferenceImage] resources, named
           #   `projects/*/locations/*/products/*/referenceImages/*`
           class Service
 
@@ -205,8 +207,8 @@ module Google
             # Asynchronous API that imports a list of reference images to specified
             # product sets based on a list of image information.
             #
-            # The [google.longrunning.Operation][google.longrunning.Operation] API can be used to keep track of the
-            # progress and results of the request.
+            # 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)
             # `Operation.response` contains `ImportProductSetsResponse`. (results)
             #

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -106,16 +106,20 @@ module Google
           # 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::V1p3beta1::ProductSet ProductSet} resources, named
+          # * The API has a collection of
+          #   {Google::Cloud::Vision::V1p3beta1::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::V1p3beta1::Product Product} resources, named
+          # * The API has a collection of
+          #   {Google::Cloud::Vision::V1p3beta1::Product Product} resources, named
           #   `projects/*/locations/*/products/*`
           #
-          # * Each {Google::Cloud::Vision::V1p3beta1::Product Product} has a collection of {Google::Cloud::Vision::V1p3beta1::ReferenceImage ReferenceImage} resources, named
+          # * Each {Google::Cloud::Vision::V1p3beta1::Product Product} has a collection of
+          #   {Google::Cloud::Vision::V1p3beta1::ReferenceImage ReferenceImage} resources,
+          #   named
           #   `projects/*/locations/*/products/*/referenceImages/*`
           #
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -49,7 +49,9 @@ module Google
         #     Optional. Defaults to `BASIC`.
         # @!attribute [rw] product_set
         #   @return [String]
-        #     The resource name of a {Google::Cloud::Vision::V1p3beta1::ProductSet ProductSet} to be searched for similar images.
+        #     The resource name of a
+        #     {Google::Cloud::Vision::V1p3beta1::ProductSet ProductSet} to be searched for
+        #     similar images.
         #
         #     Format is:
         #     `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -429,9 +429,11 @@ module Google
         #     product_display_name, product_category and labels are ignored.
         #
         #     If a Product doesn't exist and needs to be created on the fly, the
-        #     product_display_name field refers to {Google::Cloud::Vision::V1p3beta1::Product#display_name Product#display_name}, the
-        #     product_category field refers to {Google::Cloud::Vision::V1p3beta1::Product#product_category Product#product_category}, and the
-        #     labels field refers to {Product#labels}.
+        #     product_display_name field refers to
+        #     {Google::Cloud::Vision::V1p3beta1::Product#display_name Product#display_name},
+        #     the product_category field refers to
+        #     {Google::Cloud::Vision::V1p3beta1::Product#product_category Product#product_category},
+        #     and the labels field refers to {Product#labels}.
         #
         #     Labels (optional) should be a line containing a list of comma-separated
         #     key-value pairs, with the format
@@ -476,8 +478,10 @@ module Google
         # Response message for the `ImportProductSets` method.
         #
         # This message is returned by the
-        # {Google::Longrunning::Operations::GetOperation} method in the returned
-        # {Google::Longrunning::Operation#response} field.
+        # {Google::Longrunning::Operations::GetOperation}
+        # method in the returned
+        # {Google::Longrunning::Operation#response}
+        # field.
         # @!attribute [rw] reference_images
         #   @return [Array<Google::Cloud::Vision::V1p3beta1::ReferenceImage>]
         #     The list of reference_images that are imported successfully.
@@ -504,7 +508,8 @@ module Google
         # @!attribute [rw] end_time
         #   @return [Google::Protobuf::Timestamp]
         #     The time when the batch request is finished and
-        #     {Google::Longrunning::Operation#done} is set to true.
+        #     {Google::Longrunning::Operation#done} is
+        #     set to true.
         class BatchOperationMetadata
           # Enumerates the possible states that the batch request can be in.
           module State

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -22,8 +22,9 @@ module Google
         #     TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol
         # Each structural component, starting from Page, may further have their own
         # properties. Properties describe detected languages, breaks etc.. Please refer
-        # to the {Google::Cloud::Vision::V1p3beta1::TextAnnotation::TextProperty TextAnnotation::TextProperty} message definition below for more
-        # detail.
+        # to the
+        # {Google::Cloud::Vision::V1p3beta1::TextAnnotation::TextProperty TextAnnotation::TextProperty}
+        # message definition below for more detail.
         # @!attribute [rw] pages
         #   @return [Array<Google::Cloud::Vision::V1p3beta1::Page>]
         #     List of pages detected by OCR.