Gcp/vision

@swamp/gcp/visionv2026.07.21.3· 6d agoMODELS

01README

Google Cloud vision infrastructure models

02Release Notes

Updated: productsets, productsets_products, products, products_referenceimages

03Models4

@swamp/gcp/vision/productsv2026.07.21.2products.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
description?	string	no	User-provided metadata to be stored with this product. Must be at most 4096 characters long.
displayName?	string	no	The user-provided name for this Product. Must not be empty. Must be at most 4096 characters long.
name?	string	no	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.
productCategory?	string	no	Immutable. The category for the product identified by the reference image. This should be one of "homegoods-v2", "apparel-v2", "toys-v2", "packagedgoods-v1" or "general-v1". The legacy categories "homegoods", "apparel", and "toys" are still supported, but these should not be used for new products.
productLabels?	array	no	Key-value pairs that can be attached to a product. At query time, constraints can be specified based on the product_labels. Note that integer values can be provided as strings, e.g. "1199". Only strings with integer values can match a range-based restriction which is to be supported soon. Multiple values can be assigned to the same key. One product may have up to 500 product_labels. Notice that the total number of distinct product_labels over all products in one ProductSet cannot exceed 1M, othe
productId?	string	no	A user-supplied resource id for this Product. If set, the server will attempt to use this value as the resource id. If it is already in use, an error is returned with code ALREADY_EXISTS. Must be at most 128 characters long. It cannot contain the character `/`.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a products

fn get(identifier: string)

Get a products

Argument	Type	Required	Description
identifier	string	yes	The name of the products

fn update(identifier?: string)

Update products attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific products by name (e.g. one discovered by list)

fn delete(identifier: string)

Delete the products

Argument	Type	Required	Description
identifier	string	yes	The name of the products

fn sync(identifier?: string)

Sync products state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific products by name (e.g. one discovered by list)

fn list(pageSize?: number, maxPages?: number)

List products resources

Argument	Type	Required	Description
pageSize?	number	no	The maximum number of items to return. Default 10, maximum 100.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn purge(deleteOrphanProducts?: any, force?: any, productSetPurgeConfig?: any)

purge

Argument	Type	Required
deleteOrphanProducts?	any	no
force?	any	no
productSetPurgeConfig?	any	no

Resources

state(infinite)— A Product contains ReferenceImages.

@swamp/gcp/vision/products-referenceimagesv2026.07.21.2products_referenceimages.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
boundingPolys?	array	no	Optional. Bounding polygons around the areas of interest in the reference image. If this field is empty, the system will try to detect regions of interest. At most 10 bounding polygons will be used. The provided shape is converted into a non-rotated rectangle. Once converted, the small edge of the rectangle must be greater than or equal to 300 pixels. The aspect ratio must be 1:4 or less (i.e. 1:3 is ok; 1:5 is not).
name?	string	no	The resource name of the reference image. Format is: `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`. This field is ignored when creating a reference image.
uri?	string	no	Required. The Google Cloud Storage URI of the reference image. The URI must start with `gs://`.
referenceImageId?	string	no	A user-supplied resource id for the ReferenceImage to be added. If set, the server will attempt to use this value as the resource id. If it is already in use, an error is returned with code ALREADY_EXISTS. Must be at most 128 characters long. It cannot contain the character `/`.
parent?	string	no	The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a referenceImages

fn get(identifier: string)

Get a referenceImages

Argument	Type	Required	Description
identifier	string	yes	The name of the referenceImages

fn delete(identifier: string)

Delete the referenceImages

Argument	Type	Required	Description
identifier	string	yes	The name of the referenceImages

fn sync(identifier?: string)

Sync referenceImages state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific referenceImages by name (e.g. one discovered by list)

fn list(pageSize?: number, maxPages?: number)

List referenceImages resources

Argument	Type	Required	Description
pageSize?	number	no	The maximum number of items to return. Default 10, maximum 100.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A `ReferenceImage` represents a product image and its associated metadata, su...

@swamp/gcp/vision/productsetsv2026.07.21.3productsets.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
displayName?	string	no	The user-provided name for this ProductSet. Must not be empty. Must be at most 4096 characters long.
name?	string	no	The resource name of the ProductSet. Format is: `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`. This field is ignored when creating a ProductSet.
productSetId?	string	no	A user-supplied resource id for this ProductSet. If set, the server will attempt to use this value as the resource id. If it is already in use, an error is returned with code ALREADY_EXISTS. Must be at most 128 characters long. It cannot contain the character `/`.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create()

Create a productSets

fn get(identifier: string)

Get a productSets

Argument	Type	Required	Description
identifier	string	yes	The name of the productSets

fn update(identifier?: string)

Update productSets attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific productSets by name (e.g. one discovered by list)

fn delete(identifier: string)

Delete the productSets

Argument	Type	Required	Description
identifier	string	yes	The name of the productSets

fn sync(identifier?: string)

Sync productSets state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific productSets by name (e.g. one discovered by list)

fn list(pageSize?: number, maxPages?: number)

List productSets resources

Argument	Type	Required	Description
pageSize?	number	no	The maximum number of items to return. Default 10, maximum 100.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn add_product(product?: any)

add product

Argument	Type	Required	Description
product?	any	no

fn import(inputConfig?: any)

import

Argument	Type	Required	Description
inputConfig?	any	no

Resources

state(infinite)— A ProductSet contains Products. A ProductSet can contain a maximum of 1 milli...

@swamp/gcp/vision/productsets-productsv2026.07.21.2productsets_products.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
name	string	yes	Required. The ProductSet resource for which to retrieve Products. Format is: `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`

fn get(identifier: string)

Get a products

Argument	Type	Required	Description
identifier	string	yes	The name of the products

fn sync(identifier?: string)

Sync products state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific products by name (e.g. one discovered by list)

fn list(pageSize?: number, maxPages?: number)

List products resources

Argument	Type	Required	Description
pageSize?	number	no	The maximum number of items to return. Default 10, maximum 100.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

Resources

state(infinite)— A Product contains ReferenceImages.

04Previous Versions19

2026.07.21.1Jul 21, 2026

Updated: productsets

2026.07.20.1Jul 20, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.07.19.2Jul 19, 2026

Updated: productsets_products

2026.07.19.1Jul 19, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.07.18.2Jul 18, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.07.17.2Jul 17, 2026

Updated: productsets, products, products_referenceimages

2026.07.17.1Jul 17, 2026

Updated: productsets, products, products_referenceimages

Added 4, removed 1 models

2026.06.08.2Jun 8, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.06.07.1Jun 7, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.05.25.1May 25, 2026

Updated: productsets, productsets_products, products, products_referenceimages

Modified 4 models

2026.05.24.1May 24, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.05.21.2May 21, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.05.21.1May 21, 2026

2026.05.19.2May 19, 2026

2026.05.19.1May 19, 2026

2026.05.18.1May 18, 2026

2026.04.23.1Apr 23, 2026

2026.04.03.3Apr 3, 2026

Updated: productsets, productsets_products, products, products_referenceimages

2026.04.03.1Apr 3, 2026

Updated: productsets, productsets_products, products, products_referenceimages

05Stats

100 / 100

Downloads

Archive size

50.8 KB

Verified by Swamp

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://github.com/swamp-club/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

07Labels

#gcp #google-cloud #vision #cloud #infrastructure