RubyGems - google-cloud-vision-v1 - Versions diffs - 0.1.2 → 0.1.3 - Mend

google-cloud-vision-v1 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

checksums.yaml +4 -4
data/README.md +48 -1
data/lib/google-cloud-vision-v1.rb +21 -1
data/lib/google/cloud/vision/v1.rb +16 -0
data/lib/google/cloud/vision/v1/image_annotator.rb +33 -2
data/lib/google/cloud/vision/v1/image_annotator/client.rb +44 -53
data/lib/google/cloud/vision/v1/image_annotator/operations.rb +39 -33
data/lib/google/cloud/vision/v1/product_search.rb +44 -2
data/lib/google/cloud/vision/v1/product_search/client.rb +185 -207
data/lib/google/cloud/vision/v1/product_search/operations.rb +39 -33
data/lib/google/cloud/vision/v1/version.rb +1 -1
metadata +2 -2

data/lib/google/cloud/vision/v1/product_search.rb CHANGED Viewed

@@ -16,6 +16,48 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
-require "google/cloud/vision/v1/product_search/client"
-require "google/cloud/vision/v1/product_search/operations"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+require "google/cloud/vision/v1/version"
 require "google/cloud/vision/v1/product_search/credentials"
+require "google/cloud/vision/v1/product_search/paths"
+require "google/cloud/vision/v1/product_search/operations"
+require "google/cloud/vision/v1/product_search/client"
+module Google
+  module Cloud
+    module Vision
+      module V1
+        ##
+        # Manages Products and ProductSets of reference images for use in product
+        # search. It uses the following resource model:
+        #
+        # - The API has a collection of {Google::Cloud::Vision::V1::ProductSet ProductSet} resources, named
+        # `projects/*/locations/*/productSets/*`, which acts as a way to put different
+        # products into groups to limit identification.
+        #
+        # In parallel,
+        #
+        # - The API has a collection of {Google::Cloud::Vision::V1::Product Product} resources, named
+        #   `projects/*/locations/*/products/*`
+        #
+        # - Each {Google::Cloud::Vision::V1::Product Product} has a collection of {Google::Cloud::Vision::V1::ReferenceImage ReferenceImage} resources, named
+        #   `projects/*/locations/*/products/*/referenceImages/*`
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/vision/v1/product_search"
+        #     client = Google::Cloud::Vision::V1::ProductSearch::Client.new
+        #
+        module ProductSearch
+        end
+      end
+    end
+  end
+end
+helper_path = ::File.join __dir__, "product_search", "helpers.rb"
+require "google/cloud/vision/v1/product_search/helpers" if ::File.file? helper_path

data/lib/google/cloud/vision/v1/product_search/client.rb CHANGED Viewed

@@ -16,16 +16,8 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
-require "gapic/common"
-require "gapic/config"
-require "gapic/config/method"
 require "google/cloud/errors"
-require "google/cloud/vision/v1/version"
 require "google/cloud/vision/v1/product_search_service_pb"
-require "google/cloud/vision/v1/product_search/credentials"
-require "google/cloud/vision/v1/product_search/paths"
-require "google/cloud/vision/v1/product_search/operations"
 module Google
   module Cloud
@@ -329,22 +321,25 @@ module Google
             #   4096 characters.
             #
             # @overload create_product_set(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::CreateProductSetRequest | Hash]
-            #     Creates and returns a new ProductSet resource.
-            #
-            #     Possible errors:
+            #   Pass arguments to `create_product_set` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::CreateProductSetRequest} or an equivalent Hash.
             #
-            #     * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
-            #       4096 characters.
+            #   @param request [Google::Cloud::Vision::V1::CreateProductSetRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload create_product_set(parent: nil, product_set: nil, product_set_id: nil)
+            #   Pass arguments to `create_product_set` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The project in which the ProductSet should be created.
             #
             #     Format is `projects/PROJECT_ID/locations/LOC_ID`.
-            #   @param product_set [Google::Cloud::Vision::V1::ProductSet | Hash]
+            #   @param product_set [Google::Cloud::Vision::V1::ProductSet, Hash]
             #     Required. The ProductSet to create.
             #   @param product_set_id [String]
             #     A user-supplied resource id for this ProductSet. If set, the server will
@@ -352,7 +347,6 @@ module Google
             #     error is returned with code ALREADY_EXISTS. Must be at most 128 characters
             #     long. It cannot contain the character `/`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::ProductSet]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -407,17 +401,20 @@ module Google
             #   than 1.
             #
             # @overload list_product_sets(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::ListProductSetsRequest | Hash]
-            #     Lists ProductSets in an unspecified order.
+            #   Pass arguments to `list_product_sets` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::ListProductSetsRequest} or an equivalent Hash.
             #
-            #     Possible errors:
-            #
-            #     * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
-            #       than 1.
+            #   @param request [Google::Cloud::Vision::V1::ListProductSetsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_product_sets(parent: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_product_sets` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The project from which ProductSets should be listed.
             #
@@ -427,7 +424,6 @@ module Google
             #   @param page_token [String]
             #     The next_page_token returned from a previous List request, if any.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Vision::V1::ProductSet>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -482,23 +478,26 @@ module Google
             # * Returns NOT_FOUND if the ProductSet does not exist.
             #
             # @overload get_product_set(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::GetProductSetRequest | Hash]
-            #     Gets information associated with a ProductSet.
-            #
-            #     Possible errors:
+            #   Pass arguments to `get_product_set` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::GetProductSetRequest} or an equivalent Hash.
             #
-            #     * Returns NOT_FOUND if the ProductSet does not exist.
+            #   @param request [Google::Cloud::Vision::V1::GetProductSetRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload get_product_set(name: nil)
+            #   Pass arguments to `get_product_set` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. Resource name of the ProductSet to get.
             #
             #     Format is:
             #     `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::ProductSet]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -555,28 +554,28 @@ module Google
             #   missing from the request or longer than 4096 characters.
             #
             # @overload update_product_set(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::UpdateProductSetRequest | Hash]
-            #     Makes changes to a ProductSet resource.
-            #     Only display_name can be updated currently.
+            #   Pass arguments to `update_product_set` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::UpdateProductSetRequest} or an equivalent Hash.
             #
-            #     Possible errors:
-            #
-            #     * Returns NOT_FOUND if the ProductSet does not exist.
-            #     * Returns INVALID_ARGUMENT if display_name is present in update_mask but
-            #       missing from the request or longer than 4096 characters.
+            #   @param request [Google::Cloud::Vision::V1::UpdateProductSetRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload update_product_set(product_set: nil, update_mask: nil)
-            #   @param product_set [Google::Cloud::Vision::V1::ProductSet | Hash]
+            #   Pass arguments to `update_product_set` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param product_set [Google::Cloud::Vision::V1::ProductSet, Hash]
             #     Required. The ProductSet resource which replaces the one on the server.
-            #   @param update_mask [Google::Protobuf::FieldMask | Hash]
+            #   @param update_mask [Google::Protobuf::FieldMask, Hash]
             #     The {Google::Protobuf::FieldMask FieldMask} that specifies which fields to
             #     update.
             #     If update_mask isn't specified, all mutable fields are to be updated.
             #     Valid mask path is `display_name`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::ProductSet]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -629,22 +628,26 @@ module Google
             # The actual image files are not deleted from Google Cloud Storage.
             #
             # @overload delete_product_set(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::DeleteProductSetRequest | Hash]
-            #     Permanently deletes a ProductSet. Products and ReferenceImages in the
-            #     ProductSet are not deleted.
+            #   Pass arguments to `delete_product_set` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::DeleteProductSetRequest} or an equivalent Hash.
             #
-            #     The actual image files are not deleted from Google Cloud Storage.
+            #   @param request [Google::Cloud::Vision::V1::DeleteProductSetRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload delete_product_set(name: nil)
+            #   Pass arguments to `delete_product_set` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. Resource name of the ProductSet to delete.
             #
             #     Format is:
             #     `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -701,25 +704,26 @@ module Google
             # * Returns INVALID_ARGUMENT if product_category is missing or invalid.
             #
             # @overload create_product(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::CreateProductRequest | Hash]
-            #     Creates and returns a new product resource.
-            #
-            #     Possible errors:
+            #   Pass arguments to `create_product` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::CreateProductRequest} or an equivalent Hash.
             #
-            #     * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
-            #       characters.
-            #     * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
-            #     * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+            #   @param request [Google::Cloud::Vision::V1::CreateProductRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload create_product(parent: nil, product: nil, product_id: nil)
+            #   Pass arguments to `create_product` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The project in which the Product should be created.
             #
             #     Format is
             #     `projects/PROJECT_ID/locations/LOC_ID`.
-            #   @param product [Google::Cloud::Vision::V1::Product | Hash]
+            #   @param product [Google::Cloud::Vision::V1::Product, Hash]
             #     Required. The product to create.
             #   @param product_id [String]
             #     A user-supplied resource id for this Product. If set, the server will
@@ -727,7 +731,6 @@ module Google
             #     error is returned with code ALREADY_EXISTS. Must be at most 128 characters
             #     long. It cannot contain the character `/`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::Product]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -781,16 +784,20 @@ module Google
             # * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
             #
             # @overload list_products(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::ListProductsRequest | Hash]
-            #     Lists products in an unspecified order.
+            #   Pass arguments to `list_products` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::ListProductsRequest} or an equivalent Hash.
             #
-            #     Possible errors:
-            #
-            #     * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+            #   @param request [Google::Cloud::Vision::V1::ListProductsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_products(parent: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_products` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The project OR ProductSet from which Products should be listed.
             #
@@ -801,7 +808,6 @@ module Google
             #   @param page_token [String]
             #     The next_page_token returned from a previous List request, if any.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Vision::V1::Product>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -856,23 +862,26 @@ module Google
             # * Returns NOT_FOUND if the Product does not exist.
             #
             # @overload get_product(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::GetProductRequest | Hash]
-            #     Gets information associated with a Product.
-            #
-            #     Possible errors:
+            #   Pass arguments to `get_product` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::GetProductRequest} or an equivalent Hash.
             #
-            #     * Returns NOT_FOUND if the Product does not exist.
+            #   @param request [Google::Cloud::Vision::V1::GetProductRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload get_product(name: nil)
+            #   Pass arguments to `get_product` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. Resource name of the Product to get.
             #
             #     Format is:
             #     `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::Product]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -936,37 +945,30 @@ module Google
             # * Returns INVALID_ARGUMENT if product_category is present in update_mask.
             #
             # @overload update_product(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::UpdateProductRequest | Hash]
-            #     Makes changes to a Product resource.
-            #     Only the `display_name`, `description`, and `labels` fields can be updated
-            #     right now.
-            #
-            #     If labels are updated, the change will not be reflected in queries until
-            #     the next index time.
-            #
-            #     Possible errors:
-            #
-            #     * Returns NOT_FOUND if the Product does not exist.
-            #     * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
-            #       missing from the request or longer than 4096 characters.
-            #     * Returns INVALID_ARGUMENT if description is present in update_mask but is
-            #       longer than 4096 characters.
-            #     * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+            #   Pass arguments to `update_product` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::UpdateProductRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Vision::V1::UpdateProductRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload update_product(product: nil, update_mask: nil)
-            #   @param product [Google::Cloud::Vision::V1::Product | Hash]
+            #   Pass arguments to `update_product` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param product [Google::Cloud::Vision::V1::Product, Hash]
             #     Required. The Product resource which replaces the one on the server.
             #     product.name is immutable.
-            #   @param update_mask [Google::Protobuf::FieldMask | Hash]
+            #   @param update_mask [Google::Protobuf::FieldMask, Hash]
             #     The {Google::Protobuf::FieldMask FieldMask} that specifies which fields
             #     to update.
             #     If update_mask isn't specified, all mutable fields are to be updated.
             #     Valid mask paths include `product_labels`, `display_name`, and
             #     `description`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::Product]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1020,23 +1022,26 @@ module Google
             # until all related caches are refreshed.
             #
             # @overload delete_product(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::DeleteProductRequest | Hash]
-            #     Permanently deletes a product and its reference images.
+            #   Pass arguments to `delete_product` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::DeleteProductRequest} or an equivalent Hash.
             #
-            #     Metadata of the product and all its images will be deleted right away, but
-            #     search queries against ProductSets containing the product may still work
-            #     until all related caches are refreshed.
+            #   @param request [Google::Cloud::Vision::V1::DeleteProductRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload delete_product(name: nil)
+            #   Pass arguments to `delete_product` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. Resource name of product to delete.
             #
             #     Format is:
             #     `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1104,36 +1109,26 @@ module Google
             # * Returns INVALID_ARGUMENT if bounding_poly contains more than 10 polygons.
             #
             # @overload create_reference_image(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::CreateReferenceImageRequest | Hash]
-            #     Creates and returns a new ReferenceImage resource.
-            #
-            #     The `bounding_poly` field is optional. If `bounding_poly` is not specified,
-            #     the system will try to detect regions of interest in the image that are
-            #     compatible with the product_category on the parent product. If it is
-            #     specified, detection is ALWAYS skipped. The system converts polygons into
-            #     non-rotated rectangles.
-            #
-            #     Note that the pipeline will resize the image if the image resolution is too
-            #     large to process (above 50MP).
-            #
-            #     Possible errors:
-            #
-            #     * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
-            #       characters.
-            #     * Returns INVALID_ARGUMENT if the product does not exist.
-            #     * Returns INVALID_ARGUMENT if bounding_poly is not provided, and nothing
-            #       compatible with the parent product's product_category is detected.
-            #     * Returns INVALID_ARGUMENT if bounding_poly contains more than 10 polygons.
+            #   Pass arguments to `create_reference_image` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::CreateReferenceImageRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Vision::V1::CreateReferenceImageRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload create_reference_image(parent: nil, reference_image: nil, reference_image_id: nil)
+            #   Pass arguments to `create_reference_image` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. Resource name of the product in which to create the reference image.
             #
             #     Format is
             #     `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-            #   @param reference_image [Google::Cloud::Vision::V1::ReferenceImage | Hash]
+            #   @param reference_image [Google::Cloud::Vision::V1::ReferenceImage, Hash]
             #     Required. The reference image to create.
             #     If an image ID is specified, it is ignored.
             #   @param reference_image_id [String]
@@ -1142,7 +1137,6 @@ module Google
             #     already in use, an error is returned with code ALREADY_EXISTS. Must be at
             #     most 128 characters long. It cannot contain the character `/`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::ReferenceImage]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1198,18 +1192,20 @@ module Google
             # The actual image files are not deleted from Google Cloud Storage.
             #
             # @overload delete_reference_image(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::DeleteReferenceImageRequest | Hash]
-            #     Permanently deletes a reference image.
-            #
-            #     The image metadata will be deleted right away, but search queries
-            #     against ProductSets containing the image may still work until all related
-            #     caches are refreshed.
+            #   Pass arguments to `delete_reference_image` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::DeleteReferenceImageRequest} or an equivalent Hash.
             #
-            #     The actual image files are not deleted from Google Cloud Storage.
+            #   @param request [Google::Cloud::Vision::V1::DeleteReferenceImageRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload delete_reference_image(name: nil)
+            #   Pass arguments to `delete_reference_image` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. The resource name of the reference image to delete.
             #
@@ -1217,7 +1213,6 @@ module Google
             #
             #     `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1273,18 +1268,20 @@ module Google
             #   than 1.
             #
             # @overload list_reference_images(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::ListReferenceImagesRequest | Hash]
-            #     Lists reference images.
+            #   Pass arguments to `list_reference_images` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::ListReferenceImagesRequest} or an equivalent Hash.
             #
-            #     Possible errors:
-            #
-            #     * Returns NOT_FOUND if the parent product does not exist.
-            #     * Returns INVALID_ARGUMENT if the page_size is greater than 100, or less
-            #       than 1.
+            #   @param request [Google::Cloud::Vision::V1::ListReferenceImagesRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_reference_images(parent: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_reference_images` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. Resource name of the product containing the reference images.
             #
@@ -1298,7 +1295,6 @@ module Google
             #
             #     Defaults to the first page if not specified.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Vision::V1::ReferenceImage>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1353,16 +1349,20 @@ module Google
             # * Returns NOT_FOUND if the specified image does not exist.
             #
             # @overload get_reference_image(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::GetReferenceImageRequest | Hash]
-            #     Gets information associated with a ReferenceImage.
-            #
-            #     Possible errors:
+            #   Pass arguments to `get_reference_image` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::GetReferenceImageRequest} or an equivalent Hash.
             #
-            #     * Returns NOT_FOUND if the specified image does not exist.
+            #   @param request [Google::Cloud::Vision::V1::GetReferenceImageRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload get_reference_image(name: nil)
+            #   Pass arguments to `get_reference_image` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. The resource name of the ReferenceImage to get.
             #
@@ -1370,7 +1370,6 @@ module Google
             #
             #     `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Vision::V1::ReferenceImage]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1427,19 +1426,20 @@ module Google
             # * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
             #
             # @overload add_product_to_product_set(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::AddProductToProductSetRequest | Hash]
-            #     Adds a Product to the specified ProductSet. If the Product is already
-            #     present, no change is made.
-            #
-            #     One Product can be added to at most 100 ProductSets.
-            #
-            #     Possible errors:
+            #   Pass arguments to `add_product_to_product_set` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::AddProductToProductSetRequest} or an equivalent Hash.
             #
-            #     * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+            #   @param request [Google::Cloud::Vision::V1::AddProductToProductSetRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload add_product_to_product_set(name: nil, product: nil)
+            #   Pass arguments to `add_product_to_product_set` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. The resource name for the ProductSet to modify.
             #
@@ -1451,7 +1451,6 @@ module Google
             #     Format is:
             #     `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1501,12 +1500,20 @@ module Google
             # Removes a Product from the specified ProductSet.
             #
             # @overload remove_product_from_product_set(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::RemoveProductFromProductSetRequest | Hash]
-            #     Removes a Product from the specified ProductSet.
+            #   Pass arguments to `remove_product_from_product_set` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::RemoveProductFromProductSetRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Vision::V1::RemoveProductFromProductSetRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload remove_product_from_product_set(name: nil, product: nil)
+            #   Pass arguments to `remove_product_from_product_set` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. The resource name for the ProductSet to modify.
             #
@@ -1518,7 +1525,6 @@ module Google
             #     Format is:
             #     `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1574,18 +1580,20 @@ module Google
             # * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
             #
             # @overload list_products_in_product_set(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::ListProductsInProductSetRequest | Hash]
-            #     Lists the Products in a ProductSet, in an unspecified order. If the
-            #     ProductSet does not exist, the products field of the response will be
-            #     empty.
+            #   Pass arguments to `list_products_in_product_set` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::ListProductsInProductSetRequest} or an equivalent Hash.
             #
-            #     Possible errors:
-            #
-            #     * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+            #   @param request [Google::Cloud::Vision::V1::ListProductsInProductSetRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_products_in_product_set(name: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_products_in_product_set` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. The ProductSet resource for which to retrieve Products.
             #
@@ -1596,7 +1604,6 @@ module Google
             #   @param page_token [String]
             #     The next_page_token returned from a previous List request, if any.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Vision::V1::Product>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1657,30 +1664,27 @@ module Google
             # {Google::Cloud::Vision::V1::ImportProductSetsGcsSource#csv_file_uri ImportProductSetsGcsSource.csv_file_uri}.
             #
             # @overload import_product_sets(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::ImportProductSetsRequest | Hash]
-            #     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.
-            #     `Operation.metadata` contains `BatchOperationMetadata`. (progress)
-            #     `Operation.response` contains `ImportProductSetsResponse`. (results)
-            #
-            #     The input source of this method is a csv file on Google Cloud Storage.
-            #     For the format of the csv file please see
-            #     {Google::Cloud::Vision::V1::ImportProductSetsGcsSource#csv_file_uri ImportProductSetsGcsSource.csv_file_uri}.
+            #   Pass arguments to `import_product_sets` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::ImportProductSetsRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Vision::V1::ImportProductSetsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload import_product_sets(parent: nil, input_config: nil)
+            #   Pass arguments to `import_product_sets` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The project in which the ProductSets should be imported.
             #
             #     Format is `projects/PROJECT_ID/locations/LOC_ID`.
-            #   @param input_config [Google::Cloud::Vision::V1::ImportProductSetsInputConfig | Hash]
+            #   @param input_config [Google::Cloud::Vision::V1::ImportProductSetsInputConfig, Hash]
             #     Required. The input content for the list of requests.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1754,36 +1758,21 @@ module Google
             # `Operation.metadata` contains `BatchOperationMetadata`. (progress)
             #
             # @overload purge_products(request, options = nil)
-            #   @param request [Google::Cloud::Vision::V1::PurgeProductsRequest | Hash]
-            #     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)
+            #   Pass arguments to `purge_products` via a request object, either of type
+            #   {Google::Cloud::Vision::V1::PurgeProductsRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Vision::V1::PurgeProductsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload purge_products(product_set_purge_config: nil, delete_orphan_products: nil, parent: nil, force: nil)
-            #   @param product_set_purge_config [Google::Cloud::Vision::V1::ProductSetPurgeConfig | Hash]
+            #   Pass arguments to `purge_products` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param product_set_purge_config [Google::Cloud::Vision::V1::ProductSetPurgeConfig, Hash]
             #     Specify which ProductSet contains the Products to be deleted.
             #   @param delete_orphan_products [Boolean]
             #     If delete_orphan_products is true, all Products that are not in any
@@ -1796,7 +1785,6 @@ module Google
             #     The default value is false. Override this value to true to actually perform
             #     the purge.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -2122,13 +2110,3 @@ module Google
     end
   end
 end
-# rubocop:disable Lint/HandleExceptions
-# Once client is loaded, load helpers.rb if it exists.
-begin
-  require "google/cloud/vision/v1/product_search/helpers"
-rescue LoadError
-end
-# rubocop:enable Lint/HandleExceptions