The Cloud Private Catalog API provides searchable endpoints for discovering catalog resources, their products, and product versions that a consumer can access within a specified Google Cloud resource hierarchy (project, folder, or organization), with support for name‑ or parent‑based queries and pagination.
Search Catalog resources that consumers have access to, within the scope of the consumer cloud resource hierarchy context.
resource(path, required) — Required. The name of the resource context. It can be in following formats: * `projects/{project_id}` * `folders/{folder_id}` * `organizations/{organization_id}`
pageSize(query, limit) — The maximum number of entries that are requested.
pageToken(query) — A pagination token returned from a previous call to SearchCatalogs that indicates where this listing should continue from. This field is optional.
query(query) — The query to filter the catalogs. The supported queries are: * Get a single catalog: `name=catalogs/{catalog_id}`
GET
/v1beta1/{resource}/products:search
Search Product resources that consumers have access to, within the scope of the consumer cloud resource hierarchy context.
resource(path, required) — Required. The name of the resource context. See SearchCatalogsRequest.resource for details.
pageSize(query, limit) — The maximum number of entries that are requested.
pageToken(query) — A pagination token returned from a previous call to SearchProducts that indicates where this listing should continue from. This field is optional.
query(query) — The query to filter the products. The supported queries are: * List products of all catalogs: empty * List products under a catalog: `parent=catalogs/{catalog_id}` * Get a product by name: `name=catalogs/{catalog_id}/products/{product_id}`
GET
/v1beta1/{resource}/versions:search
Search Version resources that consumers have access to, within the scope of the consumer cloud resource hierarchy context.
resource(path, required) — Required. The name of the resource context. See SearchCatalogsRequest.resource for details.
pageSize(query, limit) — The maximum number of entries that are requested.
pageToken(query) — A pagination token returned from a previous call to SearchVersions that indicates where this listing should continue from. This field is optional.
query(query) — The query to filter the versions. Required. The supported queries are: * List versions under a product: `parent=catalogs/{catalog_id}/products/{product_id}` * Get a version by name: `name=catalogs/{catalog_id}/products/{product_id}/versions/{version_id}`
3 endpoints auto-detected
Authentication
This API requires authentication: OAuth.
curl -X GET \
"https://cloudprivatecatalog.googleapis.com/v1beta1/{resource}/catalogs:search"