class ProjectsLocationsProducts extends Resource (View source)

The "products" collection of methods.

Typical usage is:

 $visionService = new Google\Service\Vision(...);
 $products = $visionService->projects_locations_products;

Methods

create(string $parent, Product $postBody, array $optParams = [])

Creates and returns a new product resource. Possible errors: 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.

delete(string $name, array $optParams = [])

Permanently deletes a product and its reference images. 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. (products.delete)

get(string $name, array $optParams = [])

Gets information associated with a Product. Possible errors: * Returns NOT_FOUND if the Product does not exist. (products.get)

listProjectsLocationsProducts(string $parent, array $optParams = [])

Lists products in an unspecified order. Possible errors: * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.

patch(string $name, Product $postBody, array $optParams = [])

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.

purge(string $parent, PurgeProductsRequest $postBody, array $optParams = [])

Asynchronous API to delete all Products in a ProductSet or all Products that are in no ProductSet. If a Product is a member of the specified ProductSet in addition to other ProductSets, the Product will still be deleted. It is recommended to not delete the specified ProductSet until after this operation has completed. It is also recommended to not add any of the Products involved in the batch delete to a new ProductSet while this operation is running because those Products may still end up deleted. It's not possible to undo the PurgeProducts operation. Therefore, it is recommended to keep the csv files used in ImportProductSets (if that was how you originally built the Product Set) before starting PurgeProducts, in case you need to re-import the data after deletion. If the plan is to purge all of the Products from a ProductSet and then re-use the empty ProductSet to re-import new Products into the empty ProductSet, you must wait until the PurgeProducts operation has finished for that ProductSet. The google.longrunning.Operation API can be used to keep track of the progress and results of the request.

Details

Product create(string $parent, Product $postBody, array $optParams = [])

Creates and returns a new product resource. Possible errors: 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.

(products.create)

Parameters

string $parent

Required. The project in which the Product should be created. Format is projects/PROJECT_ID/locations/LOC_ID.

Product $postBody
array $optParams

Optional parameters.

Return Value

Product

Exceptions

Exception

VisionEmpty delete(string $name, array $optParams = [])

Permanently deletes a product and its reference images. 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. (products.delete)

Parameters

string $name

Required. Resource name of product to delete. Format is: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

array $optParams

Optional parameters.

Return Value

VisionEmpty

Exceptions

Exception

Product get(string $name, array $optParams = [])

Gets information associated with a Product. Possible errors: * Returns NOT_FOUND if the Product does not exist. (products.get)

Parameters

string $name

Required. Resource name of the Product to get. Format is: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

array $optParams

Optional parameters.

Return Value

Product

Exceptions

Exception

ListProductsResponse listProjectsLocationsProducts(string $parent, array $optParams = [])

Lists products in an unspecified order. Possible errors: * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.

(products.listProjectsLocationsProducts)

Parameters

string $parent

Required. The project OR ProductSet from which Products should be listed. Format: projects/PROJECT_ID/locations/LOC_ID

array $optParams

Optional parameters.

Return Value

ListProductsResponse

Exceptions

Exception

Product patch(string $name, Product $postBody, array $optParams = [])

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. (products.patch)

Parameters

string $name

The resource name of the product. Format is: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID. This field is ignored when creating a product.

Product $postBody
array $optParams

Optional parameters.

Return Value

Product

Exceptions

Exception

Operation purge(string $parent, PurgeProductsRequest $postBody, array $optParams = [])

Asynchronous API to delete all Products in a ProductSet or all Products that are in no ProductSet. If a Product is a member of the specified ProductSet in addition to other ProductSets, the Product will still be deleted. It is recommended to not delete the specified ProductSet until after this operation has completed. It is also recommended to not add any of the Products involved in the batch delete to a new ProductSet while this operation is running because those Products may still end up deleted. It's not possible to undo the PurgeProducts operation. Therefore, it is recommended to keep the csv files used in ImportProductSets (if that was how you originally built the Product Set) before starting PurgeProducts, in case you need to re-import the data after deletion. If the plan is to purge all of the Products from a ProductSet and then re-use the empty ProductSet to re-import new Products into the empty ProductSet, you must wait until the PurgeProducts operation has finished for that ProductSet. The google.longrunning.Operation API can be used to keep track of the progress and results of the request.

Operation.metadata contains BatchOperationMetadata. (progress) (products.purge)

Parameters

string $parent

Required. The project and location in which the Products should be deleted. Format is projects/PROJECT_ID/locations/LOC_ID.

PurgeProductsRequest $postBody
array $optParams

Optional parameters.

Return Value

Operation

Exceptions

Exception