Skip to main content
Google Cloud Vision logo
  • Category: artificial intelligence
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 29
  • Triggers: 0
  • Slug: GOOGLE_CLOUD_VISION
  • Version: 20261101_00

Tools

Slug: GOOGLE_CLOUD_VISION_ANNOTATE_FILESTool to perform image detection and annotation for batch files in Google Cloud Vision. Supports PDF, TIFF, and GIF files. Extracts up to 5 frames (GIF) or pages (PDF/TIFF) from each file and performs detection for each image. Use when you need to analyze documents or multi-page images with features like text detection, label detection, face detection, or other Vision API capabilities.

Input Parameters

string
required
Required. Target project and location for the request. Format: projects/{project-id}/locations/{location-id}. Supported locations: us, asia, eu.
array
required
Required. Array of individual file annotation requests. Each request specifies input file configuration and desired features. At least one request is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_ANNOTATE_FILES_ASYNC_BATCHTool to run asynchronous image detection and annotation for a list of generic files (PDF, TIFF, GIF). Use when processing multi-page documents that may contain multiple images per page. Results are written to Google Cloud Storage and progress can be tracked via the returned operation name using VisionGetOperation.

Input Parameters

string
Optional target project and location. Format: projects/{project-id}/locations/{location-id}. Supported locations: us, eu. If not specified, the service will auto-select a location.
array
required
Individual async file annotation requests for this batch. Must include at least one request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_ANNOTATE_IMAGESRun image detection and annotation for a batch of images using Google Cloud Vision API. Performs various types of image analysis including face detection, landmark detection, logo detection, label detection, text detection (OCR), safe search detection, image properties, crop hints, web detection, product search, and object localization. Supports up to 16 images in a single batch request. Each image can have multiple feature types analyzed simultaneously.

Input Parameters

string
Optional parent resource name in format projects/{project_id}/locations/{location_id}. Typically not required for standard image annotation.
array
required
Array of individual image annotation requests. Each request specifies an image and features to detect. The API supports up to 16 images in a single batch request for most features (specify 1-16 requests).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_ANNOTATE_IMAGES_ASYNC_BATCHTool to run asynchronous image detection and annotation for a batch of images. Use when processing multiple images or large images that require longer processing time. Results are written to Google Cloud Storage as JSON files.

Input Parameters

string
required
Required location specification in format: projects/{project-id}/locations/{location-id}. Supported locations: ‘us’, ‘asia’, ‘eu’. This controls where the async batch annotation operation runs and where data is processed.
array
required
List of image annotation requests. Must contain at least one request. Each request specifies an image (via GCS URI) and the features to detect. You can process multiple images in a single batch operation.
object
required
Configuration specifying where to write the annotation results. Results are written to Google Cloud Storage as JSON files. You must have write access to the specified GCS bucket.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_ANNOTATE_LOCATION_IMAGESAnnotate a batch of images for a specific project and location using Google Cloud Vision. Supports label, face, landmark and logo detection, OCR, safe search, image properties, crop hints, web detection, product search and object localization, with regional endpoint routing for us, asia and eu.

Input Parameters

string
required
Target project and location for the annotation request. Format: projects/{project-id}/locations/{location-id}. Supported locations: us, asia, eu. Example: projects/my-project/locations/us
array
required
Array of individual image annotation requests. Each request specifies an image and the features to detect on it. Maximum 16 requests per batch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_CREATE_PRODUCTCreates a new Product resource in Google Cloud Vision Product Search. A Product represents a physical item that can be visually searched using reference images. After creating a product, you can add reference images to it and include it in product sets for visual search capabilities. Prerequisites: - Vision API must be enabled in your Google Cloud project - Product Search must be enabled - Valid project ID and location (us-west1, us-east1, europe-west1, or asia-east1) Use this action to: - Register a new product for visual search - Set up product metadata (display name, description, category, labels) - Obtain a product resource name for adding reference images

Input Parameters

string
required
Required. The parent resource where the product will be created. Must be in format: projects/{PROJECT_ID}/locations/{LOC_ID}. Valid locations for Product Search: us-west1, us-east1, europe-west1, asia-east1.
string
Optional. User-defined ID for the product. If not provided, the system generates one. Maximum 128 characters. Must not contain forward slashes (’/’). Use lowercase alphanumeric characters, hyphens, and underscores only.
string
Optional. User-provided description of the product. Maximum 4096 characters. Provides additional context about the product.
string
required
Required. Display name for the product. Must be non-empty. Maximum 4096 characters. This is the human-readable name shown to users.
array
Optional. Key-value pairs for organizing and filtering products. Maximum 500 labels per product. Each key and value must be non-empty and ≤128 bytes. Useful for categorization (e.g., color:red, size:large, brand:acme).
string
required
Required. Immutable product category. Cannot be changed after creation. Valid values: ‘homegoods-v2’, ‘apparel-v2’, ‘toys-v2’, ‘packagedgoods-v1’, ‘general-v1’. Choose ‘general-v1’ for products that don’t fit other categories.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_CREATE_PRODUCT_SETCreates a new ProductSet resource in Google Cloud Vision Product Search. A ProductSet is a container for grouping related products together for visual search. After creating a product set, you can add products to it using the AddProductToProductSet action. Prerequisites: - Vision API must be enabled in your Google Cloud project - Product Search must be enabled - Valid project ID and location (us-west1, us-east1, europe-west1, or asia-east1) Use this action to: - Create a new product set container - Organize products into logical groups - Obtain a product set resource name for adding products

Input Parameters

string
required
Required. The parent resource where the product set will be created. Must be in format: projects/{PROJECT_ID}/locations/{LOC_ID}. Valid locations for Product Search: us-west1, us-east1, europe-west1, asia-east1.
string
required
Required. Display name for the product set. Must be non-empty. Maximum 4096 characters. This is the human-readable name shown to users.
string
Optional. User-defined ID for the product set. If not provided, the system generates one. Maximum 128 characters. Must not contain forward slashes (’/’). Use lowercase alphanumeric characters, hyphens, and underscores only.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_CREATE_REFERENCE_IMAGETool to create a ReferenceImage under a product. Use when adding a new image to a product for detection.

Input Parameters

string
required
Google Cloud Storage URI of the image; must start with gs://
string
required
Resource name of the product to add the reference image under. Format: projects/{PROJECT_ID}/locations/{LOC_ID}/products/{PRODUCT_ID}
array
Optional list of up to 10 regions of interest. If omitted, service auto-detects regions.
string
Client-specified ID for the new ReferenceImage; max 128 chars, no ’/’. If already in use, returns ALREADY_EXISTS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_DELETE_PRODUCTDeletes a product and its associated reference images from Google Cloud Vision Product Search using the product resource name. An empty response does not necessarily confirm that the product was deleted.

Input Parameters

string
required
Resource name of the Product to delete. Format: projects/{project_id}/locations/{location_id}/products/{product_id}. Supported locations: us-west1, us-east1, europe-west1, asia-east1.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_GET_PRODUCTTool to get information associated with a Product. Use when you have the product resource name and need its details.

Input Parameters

string
required
Resource name of the Product to retrieve. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}/products/{PRODUCT_ID}. Supported locations: us-west1, us-east1, asia-east1, europe-west1.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_GET_PRODUCT_SETRetrieves Cloud Vision ProductSet metadata by its full resource name, including its display name and indexing information.

Input Parameters

string
required
Resource name of the ProductSet to get. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}/productSets/{PRODUCT_SET_ID}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_IMPORT_PRODUCT_SETSAsynchronously imports product sets and reference images from a CSV file stored in Google Cloud Storage. This bulk import operation creates ProductSets, Products, and ReferenceImages from a properly formatted CSV file. Returns a long-running Operation that can be polled for completion status. The import automatically creates new ProductSets and Products if they don’t exist based on the IDs in the CSV. Use this when you need to: - Bulk import multiple products and images at once - Create product catalogs from existing CSV data - Set up initial product search datasets Note: Requires OAuth authentication with cloud-platform or cloud-vision scope, and read access to the GCS bucket.

Input Parameters

string
required
Project and location resource name. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}.
object
required
The input configuration for the import request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_LIST_INDEX_ENDPOINTSLists Vision AI IndexEndpoints in a specified project and location, helping discover endpoints for visual search and retrieval. Results can be filtered by deployed image index or corpus and paginated; the requested page size defaults to 50 and is limited to 1,000. Listing requires OAuth and the visionai.indexEndpoints.list IAM permission.

Input Parameters

string
Filter expression supports filtering by deployedImageIndex.image_index or deployedImageIndex.corpus.
string
required
The parent resource name. Format: projects/{project}/locations/{location}.
integer
Maximum number of items to return; default 50; maximum 1000 (higher coerced to 1000).
string
The nextPageToken from a previous call to retrieve the subsequent page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_LIST_LOCATIONSLists a fixed set of four Cloud Vision Product Search locations under a supplied project name, for use when choosing a region. Supports case-insensitive substring filtering by location ID or display name and pagination.

Input Parameters

string
required
The project resource name that owns the locations collection. Format: projects/{project_id}
string
Filter expression to narrow results, e.g., ‘displayName=tokyo’.
integer
Maximum number of locations to return; between 1 and 1000.
string
Pagination token from previous ListLocations call to retrieve next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_LIST_OPERATIONSList a page of Vision API operations under a project and location, optionally filtered. A next-page token may be returned for retrieving subsequent pages.

Input Parameters

string
required
The name of the operation’s parent resource. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}
string
The standard list filter.
integer
The standard list page size.
string
The standard list page token.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_PURGE_PRODUCTSTool to asynchronously delete products in a ProductSet or orphan products. Use when you need to clean up products at scale; ensure force is true to execute.

Input Parameters

boolean
required
Must be true to actually perform the purge.
string
required
Project and location path. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}
boolean
If true, delete all products not in any ProductSet.
object
Configuration to specify a ProductSet whose products should be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_UPDATE_PRODUCTTool to update a Product’s mutable fields: displayName, description, and productLabels. Use after confirming the product resource name.

Input Parameters

string
required
Resource name of the Product. Format: projects/{PROJECT_ID}/locations/{LOC_ID}/products/{PRODUCT_ID}.
string
Comma-separated list of fields to update. Valid mask paths: displayName,description,productLabels. If omitted, all mutable fields are updated.
string
Product description; max 4096 characters.
string
Product display name; non-empty; max 4096 characters.
array
List of labels to update; each key/value pair non-empty with max 128 bytes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_UPDATE_PRODUCT_SETUpdates the display name of an existing Google Cloud Vision ProductSet identified by its resource name. A returned ProductSet does not necessarily confirm that the update succeeded, including when access is denied or the resource is not found.

Input Parameters

string
required
Resource name of the ProductSet to update. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}/productSets/{PRODUCT_SET_ID}
string
Comma-separated list of fields to update; only ‘displayName’ is supported.
string
required
New display name for the ProductSet (non-empty, max 4096 chars).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_ADD_PRODUCT_TO_PRODUCT_SETAdd a Product to a ProductSet in Google Cloud Vision Product Search. This action associates a Product with a ProductSet, enabling the product to be included in product search queries against that set. Both resources must exist in the same Google Cloud project and location before calling this action. Key characteristics: - Idempotent: If the Product is already in the ProductSet, no change is made and no error occurs - Constraint: One Product can be added to at most 100 ProductSets - The Product and ProductSet must be in the same project and location - Valid locations: us-west1, us-east1, europe-west1, asia-east1 Use this after creating both a Product and a ProductSet to establish their association. Returns an empty response on success.

Input Parameters

string
required
The ProductSet resource name to add the product to. Format: projects/{project_id}/locations/{location_id}/productSets/{product_set_id}. Valid locations: us-west1, us-east1, europe-west1, asia-east1. Example: ‘projects/my-project/locations/us-west1/productSets/my-product-set’
string
required
The Product resource name to add to the ProductSet. Must be in the same project and location as the ProductSet. Format: projects/{project_id}/locations/{location_id}/products/{product_id}. Example: ‘projects/my-project/locations/us-west1/products/my-product’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_CANCEL_OPERATIONStarts asynchronous cancellation of a long-running Vision API operation. Cancellation is best effort and not guaranteed; an empty response can also indicate that cancellation is unimplemented, so check the operation status afterward.

Input Parameters

string
required
The server-assigned name of the operation resource to cancel. Format: operations/{operation_id} or projects/{project}/locations/{location}/operations/{operation_id}. This name is returned when creating long-running operations like importProductSets or purgeProducts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_DELETE_OPERATIONDeletes a long-running Google Cloud Vision API operation by resource name. The name must start with operations/; a successful request returns an empty response.

Input Parameters

string
required
The resource name of the operation to delete, e.g. ‘operations/12345’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_DELETE_PRODUCT_SETDeletes a Google Cloud Vision ProductSet by resource name. A 403 or 404 response is returned as an empty response, so an empty response does not always confirm deletion.

Input Parameters

string
required
The resource name of the ProductSet to delete. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}/productSets/{PRODUCT_SET_ID}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_DELETE_REFERENCE_IMAGEPermanently removes a reference image from a product in Google Cloud Vision Product Search. This action deletes the reference image association from the specified product. The image will be marked for deletion and removed during the next indexing operation. Note that the actual image file in Google Cloud Storage is not deleted. Use this when you need to: - Remove outdated or incorrect product reference images - Clean up test images from products - Update product imagery by removing old references Prerequisites: - The product must exist - The reference image must have been previously created under the product - You need the full resource path of the reference image (use List Reference Images if unknown)

Input Parameters

string
required
The full resource path of the reference image to delete. Must follow the format: projects/{PROJECT_ID}/locations/{LOCATION_ID}/products/{PRODUCT_ID}/referenceImages/{IMAGE_ID}. Valid locations: us-west1, us-east1, europe-west1, asia-east1. Use the List Reference Images action to find available image IDs if needed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_GET_OPERATIONRetrieves the latest state of a long-running Vision API operation by its resource name. Use it to poll asynchronous work such as product set imports or product purges; the operation name is returned when the work is started.

Input Parameters

string
required
The full resource name of the operation to retrieve. Must be in one of these formats: (1) ‘projects/{project}/operations/{operation_id}’ or (2) ‘projects/{project}/locations/{location}/operations/{operation_id}’. Use format (2) for location-specific operations like import and purge.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_GET_REFERENCE_IMAGETool to get information associated with a ReferenceImage. Use when you have the full resource name and need its metadata.

Input Parameters

string
required
Full resource name of the ReferenceImage to retrieve. Format: projects/{PROJECT_ID}/locations/{LOCATION_ID}/products/{PRODUCT_ID}/referenceImages/{REFERENCE_IMAGE_ID}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_LIST_PRODUCTS_IN_PRODUCT_SETLists products associated with a specified ProductSet, with optional pagination. A 403 or 404 response is returned as an empty product list, so an empty result does not establish that the set contains no products.

Input Parameters

string
required
Resource name of the ProductSet to list Products from. Format: projects/{project_id}/locations/{location_id}/productSets/{product_set_id}
integer
Maximum number of items to return; default 10; maximum 100. Requests outside 1-100 return INVALID_ARGUMENT.
string
The nextPageToken from a previous call to retrieve the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_LIST_PROJECTSList Google Cloud projects accessible to the authenticated user through Cloud Resource Manager, with filtering and pagination. Use this to discover project IDs for Vision API requests; listing requires OAuth 2.0 and appropriate project permissions, as an API key alone is insufficient.

Input Parameters

string
Filter expression (case-insensitive). Supported fields: name, id (or projectId), labels.<key>, parent.type, parent.id, lifecycleState. Examples: ‘name:how*’, ‘lifecycleState:ACTIVE’, ‘labels.color:red’
integer
Maximum number of projects to return; server may return fewer.
string
Token from a previous list call to retrieve the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_LIST_REFERENCE_IMAGESTool to list reference images for a product. Use when you need to retrieve stored reference images under a specified product resource name, with optional pagination.

Input Parameters

string
required
Resource name of the product to list reference images for. Format: projects/{PROJECT_ID}/locations/{LOC_ID}/products/{PRODUCT_ID}.
integer
Maximum number of images to return; default 10, maximum 100.
string
Token for fetching the next page of results from a previous list call.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLE_CLOUD_VISION_VISION_REMOVE_PRODUCT_FROM_PRODUCT_SETRemoves a Product from a specified ProductSet in Google Cloud Vision API. This operation unlinks a product from a product set but does not delete either resource. Both the product and product set must exist in the same Google Cloud project and location. The product must have been previously added to the product set for this operation to succeed. Use this when you need to reorganize products across product sets or remove a product from a set without deleting the product itself.

Input Parameters

string
required
Resource name of the ProductSet to modify. Format: projects/{project_id}/locations/{location_id}/productSets/{product_set_id}
string
required
Resource name of the Product to remove. Format: projects/{project_id}/locations/{location_id}/products/{product_id}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not