google-cloud-vision-v1 0.1.2 → 0.1.3

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

@@ -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

@@ -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