Vertex AI Search for commerce API is made up of Retail Search, Browse and Recommendations. These discovery AI solutions help you implement personalized search, browse and recommendations, based on machine learning models, across your websites and mobile applications.
- REST Resource: v2beta.projects
- REST Resource: v2beta.projects.locations.catalogs
- REST Resource: v2beta.projects.locations.catalogs.attributesConfig
- REST Resource: v2beta.projects.locations.catalogs.branches.operations
- REST Resource: v2beta.projects.locations.catalogs.branches.products
- REST Resource: v2beta.projects.locations.catalogs.completionData
- REST Resource: v2beta.projects.locations.catalogs.controls
- REST Resource: v2beta.projects.locations.catalogs.generativeQuestion
- REST Resource: v2beta.projects.locations.catalogs.generativeQuestions
- REST Resource: v2beta.projects.locations.catalogs.models
- REST Resource: v2beta.projects.locations.catalogs.operations
- REST Resource: v2beta.projects.locations.catalogs.placements
- REST Resource: v2beta.projects.locations.catalogs.servingConfigs
- REST Resource: v2beta.projects.locations.catalogs.userEvents
- REST Resource: v2beta.projects.locations.operations
- REST Resource: v2beta.projects.operations
- REST Resource: v2alpha.projects
- REST Resource: v2alpha.projects.locations.catalogs
- REST Resource: v2alpha.projects.locations.catalogs.attributesConfig
- REST Resource: v2alpha.projects.locations.catalogs.branches
- REST Resource: v2alpha.projects.locations.catalogs.branches.operations
- REST Resource: v2alpha.projects.locations.catalogs.branches.places.operations
- REST Resource: v2alpha.projects.locations.catalogs.branches.products
- REST Resource: v2alpha.projects.locations.catalogs.completionData
- REST Resource: v2alpha.projects.locations.catalogs.controls
- REST Resource: v2alpha.projects.locations.catalogs.generativeQuestion
- REST Resource: v2alpha.projects.locations.catalogs.generativeQuestions
- REST Resource: v2alpha.projects.locations.catalogs.merchantCenterAccountLinks
- REST Resource: v2alpha.projects.locations.catalogs.models
- REST Resource: v2alpha.projects.locations.catalogs.operations
- REST Resource: v2alpha.projects.locations.catalogs.placements
- REST Resource: v2alpha.projects.locations.catalogs.servingConfigs
- REST Resource: v2alpha.projects.locations.catalogs.userEvents
- REST Resource: v2alpha.projects.locations.operations
- REST Resource: v2alpha.projects.operations
- REST Resource: v2alpha.projects.retailProject
- REST Resource: v2.projects.locations.catalogs
- REST Resource: v2.projects.locations.catalogs.attributesConfig
- REST Resource: v2.projects.locations.catalogs.branches.operations
- REST Resource: v2.projects.locations.catalogs.branches.products
- REST Resource: v2.projects.locations.catalogs.completionData
- REST Resource: v2.projects.locations.catalogs.controls
- REST Resource: v2.projects.locations.catalogs.generativeQuestion
- REST Resource: v2.projects.locations.catalogs.generativeQuestions
- REST Resource: v2.projects.locations.catalogs.models
- REST Resource: v2.projects.locations.catalogs.operations
- REST Resource: v2.projects.locations.catalogs.placements
- REST Resource: v2.projects.locations.catalogs.servingConfigs
- REST Resource: v2.projects.locations.catalogs.userEvents
- REST Resource: v2.projects.locations.operations
- REST Resource: v2.projects.operations
Service: retail.googleapis.com
To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.
Discovery document
A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:
Service endpoint
A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:
- https://retail.googleapis.com
REST Resource: v2beta.projects
| Methods | |
|---|---|
| getAlertConfig | GET /v2beta/{name=projects/*/alertConfig}Get the AlertConfigof the requested project. | 
| updateAlertConfig | PATCH /v2beta/{alertConfig.name=projects/*/alertConfig}Update the alert config of the requested project. | 
REST Resource: v2beta.projects.locations.catalogs
| Methods | |
|---|---|
| completeQuery | GET /v2beta/{catalog=projects/*/locations/*/catalogs/*}:completeQueryCompletes the specified prefix with keyword suggestions. | 
| exportAnalyticsMetrics | POST /v2beta/{catalog=projects/*/locations/*/catalogs/*}:exportAnalyticsMetricsExports analytics metrics. | 
| getAttributesConfig | GET /v2beta/{name=projects/*/locations/*/catalogs/*/attributesConfig}Gets an AttributesConfig. | 
| getCompletionConfig | GET /v2beta/{name=projects/*/locations/*/catalogs/*/completionConfig}Gets a CompletionConfig. | 
| getConversationalSearchCustomizationConfig | GET /v2beta/{name=projects/*/locations/*/catalogs/*}/conversationalSearchCustomizationConfigReturns the conversational search customization config for a given catalog. | 
| getDefaultBranch | GET /v2beta/{catalog=projects/*/locations/*/catalogs/*}:getDefaultBranchGet which branch is currently default branch set by CatalogService.SetDefaultBranchmethod under a specified parent catalog. | 
| getGenerativeQuestionFeature | GET /v2beta/{catalog=projects/*/locations/*/catalogs/*}/generativeQuestionFeatureManages overal generative question feature state -- enables toggling feature on and off. | 
| list | GET /v2beta/{parent=projects/*/locations/*}/catalogsLists all the Catalogs associated with the project. | 
| patch | PATCH /v2beta/{catalog.name=projects/*/locations/*/catalogs/*}Updates the Catalogs. | 
| setDefaultBranch | POST /v2beta/{catalog=projects/*/locations/*/catalogs/*}:setDefaultBranchSet a specified branch id as default branch. | 
| updateAttributesConfig | PATCH /v2beta/{attributesConfig.name=projects/*/locations/*/catalogs/*/attributesConfig}Updates the AttributesConfig. | 
| updateCompletionConfig | PATCH /v2beta/{completionConfig.name=projects/*/locations/*/catalogs/*/completionConfig}Updates the CompletionConfigs. | 
| updateConversationalSearchCustomizationConfig | PATCH /v2beta/{conversationalSearchCustomizationConfig.catalog=projects/*/locations/*/catalogs/*}/conversationalSearchCustomizationConfigUpdates the conversational search customization config for a given catalog. | 
| updateGenerativeQuestion | PATCH /v2beta/{generativeQuestionConfig.catalog=projects/*/locations/*/catalogs/*}/generativeQuestionAllows management of individual questions. | 
| updateGenerativeQuestionFeature | PATCH /v2beta/{generativeQuestionsFeatureConfig.catalog=projects/*/locations/*/catalogs/*}/generativeQuestionFeatureManages overal generative question feature state -- enables toggling feature on and off. | 
REST Resource: v2beta.projects.locations.catalogs.attributesConfig
| Methods | |
|---|---|
| addCatalogAttribute | POST /v2beta/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:addCatalogAttributeAdds the specified CatalogAttributeto theAttributesConfig. | 
| batchRemoveCatalogAttributes | POST /v2beta/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:batchRemoveCatalogAttributesRemoves all specified CatalogAttributes from theAttributesConfig. | 
| removeCatalogAttribute | POST /v2beta/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:removeCatalogAttributeRemoves the specified CatalogAttributefrom theAttributesConfig. | 
| replaceCatalogAttribute | POST /v2beta/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:replaceCatalogAttributeReplaces the specified CatalogAttributein theAttributesConfigby updating the catalog attribute with the sameCatalogAttribute.key. | 
REST Resource: v2beta.projects.locations.catalogs.branches.operations
| Methods | |
|---|---|
| get | GET /v2beta/{name=projects/*/locations/*/catalogs/*/branches/*/operations/*}Gets the latest state of a long-running operation. | 
REST Resource: v2beta.projects.locations.catalogs.branches.products
| Methods | |
|---|---|
| addFulfillmentPlaces | POST /v2beta/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:addFulfillmentPlacesWe recommend that you use the ProductService.AddLocalInventoriesmethod instead of theProductService.AddFulfillmentPlacesmethod. | 
| addLocalInventories | POST /v2beta/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:addLocalInventoriesUpdates local inventory information for a Productat a list of places, while respecting the last update timestamps of each inventory field. | 
| create | POST /v2beta/{parent=projects/*/locations/*/catalogs/*/branches/*}/productsCreates a Product. | 
| delete | DELETE /v2beta/{name=projects/*/locations/*/catalogs/*/branches/*/products/**}Deletes a Product. | 
| export | POST /v2beta/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:exportExports multiple Products. | 
| get | GET /v2beta/{name=projects/*/locations/*/catalogs/*/branches/*/products/**}Gets a Product. | 
| import | POST /v2beta/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:importBulk import of multiple Products. | 
| list | GET /v2beta/{parent=projects/*/locations/*/catalogs/*/branches/*}/productsGets a list of Products. | 
| patch | PATCH /v2beta/{product.name=projects/*/locations/*/catalogs/*/branches/*/products/**}Updates a Product. | 
| purge | POST /v2beta/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:purgePermanently deletes all selected Products under a branch. | 
| removeFulfillmentPlaces | POST /v2beta/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:removeFulfillmentPlacesWe recommend that you use the ProductService.RemoveLocalInventoriesmethod instead of theProductService.RemoveFulfillmentPlacesmethod. | 
| removeLocalInventories | POST /v2beta/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:removeLocalInventoriesRemove local inventory information for a Productat a list of places at a removal timestamp. | 
| setInventory | POST /v2beta/{inventory.name=projects/*/locations/*/catalogs/*/branches/*/products/**}:setInventoryUpdates inventory information for a Productwhile respecting the last update timestamps of each inventory field. | 
REST Resource: v2beta.projects.locations.catalogs.completionData
| Methods | |
|---|---|
| import | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/completionData:importBulk import of processed completion dataset. | 
REST Resource: v2beta.projects.locations.catalogs.controls
| Methods | |
|---|---|
| create | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/controlsCreates a Control. | 
| delete | DELETE /v2beta/{name=projects/*/locations/*/catalogs/*/controls/*}Deletes a Control. | 
| get | GET /v2beta/{name=projects/*/locations/*/catalogs/*/controls/*}Gets a Control. | 
| list | GET /v2beta/{parent=projects/*/locations/*/catalogs/*}/controlsLists all Controls by their parent Catalog. | 
| patch | PATCH /v2beta/{control.name=projects/*/locations/*/catalogs/*/controls/*}Updates a Control. | 
REST Resource: v2beta.projects.locations.catalogs.generativeQuestion
| Methods | |
|---|---|
| batchUpdate | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/generativeQuestion:batchUpdateAllows management of multiple questions. | 
REST Resource: v2beta.projects.locations.catalogs.generativeQuestions
| Methods | |
|---|---|
| list | GET /v2beta/{parent=projects/*/locations/*/catalogs/*}/generativeQuestionsReturns all questions for a given catalog. | 
REST Resource: v2beta.projects.locations.catalogs.models
| Methods | |
|---|---|
| create | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/modelsCreates a new model. | 
| delete | DELETE /v2beta/{name=projects/*/locations/*/catalogs/*/models/*}Deletes an existing model. | 
| get | GET /v2beta/{name=projects/*/locations/*/catalogs/*/models/*}Gets a model. | 
| list | GET /v2beta/{parent=projects/*/locations/*/catalogs/*}/modelsLists all the models linked to this event store. | 
| patch | PATCH /v2beta/{model.name=projects/*/locations/*/catalogs/*/models/*}Update of model metadata. | 
| pause | POST /v2beta/{name=projects/*/locations/*/catalogs/*/models/*}:pausePauses the training of an existing model. | 
| resume | POST /v2beta/{name=projects/*/locations/*/catalogs/*/models/*}:resumeResumes the training of an existing model. | 
| tune | POST /v2beta/{name=projects/*/locations/*/catalogs/*/models/*}:tuneTunes an existing model. | 
REST Resource: v2beta.projects.locations.catalogs.operations
| Methods | |
|---|---|
| get | GET /v2beta/{name=projects/*/locations/*/catalogs/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2beta/{name=projects/*/locations/*/catalogs/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2beta.projects.locations.catalogs.placements
| Methods | |
|---|---|
| predict | POST /v2beta/{placement=projects/*/locations/*/catalogs/*/placements/*}:predictMakes a recommendation prediction. | 
| search | POST /v2beta/{placement=projects/*/locations/*/catalogs/*/placements/*}:searchPerforms a search. | 
REST Resource: v2beta.projects.locations.catalogs.servingConfigs
| Methods | |
|---|---|
| addControl | POST /v2beta/{servingConfig=projects/*/locations/*/catalogs/*/servingConfigs/*}:addControlEnables a Control on the specified ServingConfig. | 
| create | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/servingConfigsCreates a ServingConfig. | 
| delete | DELETE /v2beta/{name=projects/*/locations/*/catalogs/*/servingConfigs/*}Deletes a ServingConfig. | 
| get | GET /v2beta/{name=projects/*/locations/*/catalogs/*/servingConfigs/*}Gets a ServingConfig. | 
| list | GET /v2beta/{parent=projects/*/locations/*/catalogs/*}/servingConfigsLists all ServingConfigs linked to this catalog. | 
| patch | PATCH /v2beta/{servingConfig.name=projects/*/locations/*/catalogs/*/servingConfigs/*}Updates a ServingConfig. | 
| predict | POST /v2beta/{placement=projects/*/locations/*/catalogs/*/servingConfigs/*}:predictMakes a recommendation prediction. | 
| removeControl | POST /v2beta/{servingConfig=projects/*/locations/*/catalogs/*/servingConfigs/*}:removeControlDisables a Control on the specified ServingConfig. | 
| search | POST /v2beta/{placement=projects/*/locations/*/catalogs/*/servingConfigs/*}:searchPerforms a search. | 
REST Resource: v2beta.projects.locations.catalogs.userEvents
| Methods | |
|---|---|
| collect | GET /v2beta/{parent=projects/*/locations/*/catalogs/*}/userEvents:collectWrites a single user event from the browser. | 
| export | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/userEvents:exportExports user events. | 
| import | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/userEvents:importBulk import of User events. | 
| purge | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/userEvents:purgeDeletes permanently all user events specified by the filter provided. | 
| rejoin | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/userEvents:rejoinStarts a user-event rejoin operation with latest product catalog. | 
| write | POST /v2beta/{parent=projects/*/locations/*/catalogs/*}/userEvents:writeWrites a single user event. | 
REST Resource: v2beta.projects.locations.operations
| Methods | |
|---|---|
| get | GET /v2beta/{name=projects/*/locations/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2beta/{name=projects/*/locations/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2beta.projects.operations
| Methods | |
|---|---|
| get | GET /v2beta/{name=projects/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2beta/{name=projects/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2alpha.projects
| Methods | |
|---|---|
| enrollSolution | POST /v2alpha/{project=projects/*}:enrollSolutionThe method enrolls a solution of type Retail Searchinto a project. | 
| getAlertConfig | GET /v2alpha/{name=projects/*/alertConfig}Get the AlertConfigof the requested project. | 
| getLoggingConfig | GET /v2alpha/{name=projects/*/loggingConfig}Gets the LoggingConfigof the requested project. | 
| getRetailProject | GET /v2alpha/{name=projects/*/retailProject}Gets the project. | 
| listEnrolledSolutions | GET /v2alpha/{parent=projects/*}:enrolledSolutionsLists all the retail API solutions the project has enrolled. | 
| updateAlertConfig | PATCH /v2alpha/{alertConfig.name=projects/*/alertConfig}Update the alert config of the requested project. | 
| updateLoggingConfig | PATCH /v2alpha/{loggingConfig.name=projects/*/loggingConfig}Updates the LoggingConfigof the requested project. | 
REST Resource: v2alpha.projects.locations.catalogs
| Methods | |
|---|---|
| completeQuery | GET /v2alpha/{catalog=projects/*/locations/*/catalogs/*}:completeQueryCompletes the specified prefix with keyword suggestions. | 
| exportAnalyticsMetrics | POST /v2alpha/{catalog=projects/*/locations/*/catalogs/*}:exportAnalyticsMetricsExports analytics metrics. | 
| getAttributesConfig | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/attributesConfig}Gets an AttributesConfig. | 
| getCompletionConfig | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/completionConfig}Gets a CompletionConfig. | 
| getConversationalSearchCustomizationConfig | GET /v2alpha/{name=projects/*/locations/*/catalogs/*}/conversationalSearchCustomizationConfigReturns the conversational search customization config for a given catalog. | 
| getDefaultBranch | GET /v2alpha/{catalog=projects/*/locations/*/catalogs/*}:getDefaultBranchGet which branch is currently default branch set by CatalogService.SetDefaultBranchmethod under a specified parent catalog. | 
| getGenerativeQuestionFeature | GET /v2alpha/{catalog=projects/*/locations/*/catalogs/*}/generativeQuestionFeatureManages overal generative question feature state -- enables toggling feature on and off. | 
| list | GET /v2alpha/{parent=projects/*/locations/*}/catalogsLists all the Catalogs associated with the project. | 
| patch | PATCH /v2alpha/{catalog.name=projects/*/locations/*/catalogs/*}Updates the Catalogs. | 
| setDefaultBranch | POST /v2alpha/{catalog=projects/*/locations/*/catalogs/*}:setDefaultBranchSet a specified branch id as default branch. | 
| updateAttributesConfig | PATCH /v2alpha/{attributesConfig.name=projects/*/locations/*/catalogs/*/attributesConfig}Updates the AttributesConfig. | 
| updateCompletionConfig | PATCH /v2alpha/{completionConfig.name=projects/*/locations/*/catalogs/*/completionConfig}Updates the CompletionConfigs. | 
| updateConversationalSearchCustomizationConfig | PATCH /v2alpha/{conversationalSearchCustomizationConfig.catalog=projects/*/locations/*/catalogs/*}/conversationalSearchCustomizationConfigUpdates the conversational search customization config for a given catalog. | 
| updateGenerativeQuestion | PATCH /v2alpha/{generativeQuestionConfig.catalog=projects/*/locations/*/catalogs/*}/generativeQuestionAllows management of individual questions. | 
| updateGenerativeQuestionFeature | PATCH /v2alpha/{generativeQuestionsFeatureConfig.catalog=projects/*/locations/*/catalogs/*}/generativeQuestionFeatureManages overal generative question feature state -- enables toggling feature on and off. | 
REST Resource: v2alpha.projects.locations.catalogs.attributesConfig
| Methods | |
|---|---|
| addCatalogAttribute | POST /v2alpha/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:addCatalogAttributeAdds the specified CatalogAttributeto theAttributesConfig. | 
| batchRemoveCatalogAttributes | POST /v2alpha/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:batchRemoveCatalogAttributesRemoves all specified CatalogAttributes from theAttributesConfig. | 
| removeCatalogAttribute | POST /v2alpha/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:removeCatalogAttributeRemoves the specified CatalogAttributefrom theAttributesConfig. | 
| replaceCatalogAttribute | POST /v2alpha/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:replaceCatalogAttributeReplaces the specified CatalogAttributein theAttributesConfigby updating the catalog attribute with the sameCatalogAttribute.key. | 
REST Resource: v2alpha.projects.locations.catalogs.branches
| Methods | |
|---|---|
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/branches/*}Retrieves a Branch. | 
| list | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*}/branchesLists all instances of Branchunder the specified parentCatalog. | 
REST Resource: v2alpha.projects.locations.catalogs.branches.operations
| Methods | |
|---|---|
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/branches/*/operations/*}Gets the latest state of a long-running operation. | 
REST Resource: v2alpha.projects.locations.catalogs.branches.places.operations
| Methods | |
|---|---|
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/branches/*/places/*/operations/*}Gets the latest state of a long-running operation. | 
REST Resource: v2alpha.projects.locations.catalogs.branches.products
| Methods | |
|---|---|
| addFulfillmentPlaces | POST /v2alpha/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:addFulfillmentPlacesWe recommend that you use the ProductService.AddLocalInventoriesmethod instead of theProductService.AddFulfillmentPlacesmethod. | 
| addLocalInventories | POST /v2alpha/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:addLocalInventoriesUpdates local inventory information for a Productat a list of places, while respecting the last update timestamps of each inventory field. | 
| create | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*/branches/*}/productsCreates a Product. | 
| delete | DELETE /v2alpha/{name=projects/*/locations/*/catalogs/*/branches/*/products/**}Deletes a Product. | 
| export | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:exportExports multiple Products. | 
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/branches/*/products/**}Gets a Product. | 
| import | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:importBulk import of multiple Products. | 
| list | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*/branches/*}/productsGets a list of Products. | 
| patch | PATCH /v2alpha/{product.name=projects/*/locations/*/catalogs/*/branches/*/products/**}Updates a Product. | 
| purge | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:purgePermanently deletes all selected Products under a branch. | 
| removeFulfillmentPlaces | POST /v2alpha/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:removeFulfillmentPlacesWe recommend that you use the ProductService.RemoveLocalInventoriesmethod instead of theProductService.RemoveFulfillmentPlacesmethod. | 
| removeLocalInventories | POST /v2alpha/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:removeLocalInventoriesRemove local inventory information for a Productat a list of places at a removal timestamp. | 
| setInventory | POST /v2alpha/{inventory.name=projects/*/locations/*/catalogs/*/branches/*/products/**}:setInventoryUpdates inventory information for a Productwhile respecting the last update timestamps of each inventory field. | 
REST Resource: v2alpha.projects.locations.catalogs.completionData
| Methods | |
|---|---|
| import | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/completionData:importBulk import of processed completion dataset. | 
REST Resource: v2alpha.projects.locations.catalogs.controls
| Methods | |
|---|---|
| create | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/controlsCreates a Control. | 
| delete | DELETE /v2alpha/{name=projects/*/locations/*/catalogs/*/controls/*}Deletes a Control. | 
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/controls/*}Gets a Control. | 
| list | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*}/controlsLists all Controls by their parent Catalog. | 
| patch | PATCH /v2alpha/{control.name=projects/*/locations/*/catalogs/*/controls/*}Updates a Control. | 
REST Resource: v2alpha.projects.locations.catalogs.generativeQuestion
| Methods | |
|---|---|
| batchUpdate | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/generativeQuestion:batchUpdateAllows management of multiple questions. | 
REST Resource: v2alpha.projects.locations.catalogs.generativeQuestions
| Methods | |
|---|---|
| list | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*}/generativeQuestionsReturns all questions for a given catalog. | 
REST Resource: v2alpha.projects.locations.catalogs.merchantCenterAccountLinks
| Methods | |
|---|---|
| create | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/merchantCenterAccountLinksCreates a MerchantCenterAccountLink. | 
| delete | DELETE /v2alpha/{name=projects/*/locations/*/catalogs/*/merchantCenterAccountLinks/*}Deletes a MerchantCenterAccountLink. | 
| list | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*}/merchantCenterAccountLinksLists all MerchantCenterAccountLinks under the specified parentCatalog. | 
REST Resource: v2alpha.projects.locations.catalogs.models
| Methods | |
|---|---|
| create | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/modelsCreates a new model. | 
| delete | DELETE /v2alpha/{name=projects/*/locations/*/catalogs/*/models/*}Deletes an existing model. | 
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/models/*}Gets a model. | 
| list | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*}/modelsLists all the models linked to this event store. | 
| patch | PATCH /v2alpha/{model.name=projects/*/locations/*/catalogs/*/models/*}Update of model metadata. | 
| pause | POST /v2alpha/{name=projects/*/locations/*/catalogs/*/models/*}:pausePauses the training of an existing model. | 
| resume | POST /v2alpha/{name=projects/*/locations/*/catalogs/*/models/*}:resumeResumes the training of an existing model. | 
| tune | POST /v2alpha/{name=projects/*/locations/*/catalogs/*/models/*}:tuneTunes an existing model. | 
REST Resource: v2alpha.projects.locations.catalogs.operations
| Methods | |
|---|---|
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2alpha/{name=projects/*/locations/*/catalogs/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2alpha.projects.locations.catalogs.placements
| Methods | |
|---|---|
| conversationalSearch | POST /v2alpha/{placement=projects/*/locations/*/catalogs/*/placements/*}:conversationalSearchPerforms a conversational search. | 
| predict | POST /v2alpha/{placement=projects/*/locations/*/catalogs/*/placements/*}:predictMakes a recommendation prediction. | 
| search | POST /v2alpha/{placement=projects/*/locations/*/catalogs/*/placements/*}:searchPerforms a search. | 
REST Resource: v2alpha.projects.locations.catalogs.servingConfigs
| Methods | |
|---|---|
| addControl | POST /v2alpha/{servingConfig=projects/*/locations/*/catalogs/*/servingConfigs/*}:addControlEnables a Control on the specified ServingConfig. | 
| conversationalSearch | POST /v2alpha/{placement=projects/*/locations/*/catalogs/*/servingConfigs/*}:conversationalSearchPerforms a conversational search. | 
| create | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/servingConfigsCreates a ServingConfig. | 
| delete | DELETE /v2alpha/{name=projects/*/locations/*/catalogs/*/servingConfigs/*}Deletes a ServingConfig. | 
| get | GET /v2alpha/{name=projects/*/locations/*/catalogs/*/servingConfigs/*}Gets a ServingConfig. | 
| list | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*}/servingConfigsLists all ServingConfigs linked to this catalog. | 
| patch | PATCH /v2alpha/{servingConfig.name=projects/*/locations/*/catalogs/*/servingConfigs/*}Updates a ServingConfig. | 
| predict | POST /v2alpha/{placement=projects/*/locations/*/catalogs/*/servingConfigs/*}:predictMakes a recommendation prediction. | 
| removeControl | POST /v2alpha/{servingConfig=projects/*/locations/*/catalogs/*/servingConfigs/*}:removeControlDisables a Control on the specified ServingConfig. | 
| search | POST /v2alpha/{placement=projects/*/locations/*/catalogs/*/servingConfigs/*}:searchPerforms a search. | 
REST Resource: v2alpha.projects.locations.catalogs.userEvents
| Methods | |
|---|---|
| collect | GET /v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:collectWrites a single user event from the browser. | 
| export | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:exportExports user events. | 
| import | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:importBulk import of User events. | 
| purge | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:purgeDeletes permanently all user events specified by the filter provided. | 
| rejoin | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:rejoinStarts a user-event rejoin operation with latest product catalog. | 
| write | POST /v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:writeWrites a single user event. | 
REST Resource: v2alpha.projects.locations.operations
| Methods | |
|---|---|
| get | GET /v2alpha/{name=projects/*/locations/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2alpha/{name=projects/*/locations/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2alpha.projects.operations
| Methods | |
|---|---|
| get | GET /v2alpha/{name=projects/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2alpha/{name=projects/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2alpha.projects.retailProject
| Methods | |
|---|---|
| acceptTerms | POST /v2alpha/{project=projects/*/retailProject}:acceptTermsAccepts service terms for this project. | 
REST Resource: v2.projects.locations.catalogs
| Methods | |
|---|---|
| completeQuery | GET /v2/{catalog=projects/*/locations/*/catalogs/*}:completeQueryCompletes the specified prefix with keyword suggestions. | 
| exportAnalyticsMetrics | POST /v2/{catalog=projects/*/locations/*/catalogs/*}:exportAnalyticsMetricsExports analytics metrics. | 
| getAttributesConfig | GET /v2/{name=projects/*/locations/*/catalogs/*/attributesConfig}Gets an AttributesConfig. | 
| getCompletionConfig | GET /v2/{name=projects/*/locations/*/catalogs/*/completionConfig}Gets a CompletionConfig. | 
| getConversationalSearchCustomizationConfig | GET /v2/{name=projects/*/locations/*/catalogs/*}/conversationalSearchCustomizationConfigReturns the conversational search customization config for a given catalog. | 
| getDefaultBranch | GET /v2/{catalog=projects/*/locations/*/catalogs/*}:getDefaultBranchGet which branch is currently default branch set by CatalogService.SetDefaultBranchmethod under a specified parent catalog. | 
| getGenerativeQuestionFeature | GET /v2/{catalog=projects/*/locations/*/catalogs/*}/generativeQuestionFeatureManages overal generative question feature state -- enables toggling feature on and off. | 
| list | GET /v2/{parent=projects/*/locations/*}/catalogsLists all the Catalogs associated with the project. | 
| patch | PATCH /v2/{catalog.name=projects/*/locations/*/catalogs/*}Updates the Catalogs. | 
| setDefaultBranch | POST /v2/{catalog=projects/*/locations/*/catalogs/*}:setDefaultBranchSet a specified branch id as default branch. | 
| updateAttributesConfig | PATCH /v2/{attributesConfig.name=projects/*/locations/*/catalogs/*/attributesConfig}Updates the AttributesConfig. | 
| updateCompletionConfig | PATCH /v2/{completionConfig.name=projects/*/locations/*/catalogs/*/completionConfig}Updates the CompletionConfigs. | 
| updateConversationalSearchCustomizationConfig | PATCH /v2/{conversationalSearchCustomizationConfig.catalog=projects/*/locations/*/catalogs/*}/conversationalSearchCustomizationConfigUpdates the conversational search customization config for a given catalog. | 
| updateGenerativeQuestion | PATCH /v2/{generativeQuestionConfig.catalog=projects/*/locations/*/catalogs/*}/generativeQuestionAllows management of individual questions. | 
| updateGenerativeQuestionFeature | PATCH /v2/{generativeQuestionsFeatureConfig.catalog=projects/*/locations/*/catalogs/*}/generativeQuestionFeatureManages overal generative question feature state -- enables toggling feature on and off. | 
REST Resource: v2.projects.locations.catalogs.attributesConfig
| Methods | |
|---|---|
| addCatalogAttribute | POST /v2/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:addCatalogAttributeAdds the specified CatalogAttributeto theAttributesConfig. | 
| removeCatalogAttribute | POST /v2/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:removeCatalogAttributeRemoves the specified CatalogAttributefrom theAttributesConfig. | 
| replaceCatalogAttribute | POST /v2/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:replaceCatalogAttributeReplaces the specified CatalogAttributein theAttributesConfigby updating the catalog attribute with the sameCatalogAttribute.key. | 
REST Resource: v2.projects.locations.catalogs.branches.operations
| Methods | |
|---|---|
| get | GET /v2/{name=projects/*/locations/*/catalogs/*/branches/*/operations/*}Gets the latest state of a long-running operation. | 
REST Resource: v2.projects.locations.catalogs.branches.products
| Methods | |
|---|---|
| addFulfillmentPlaces | POST /v2/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:addFulfillmentPlacesWe recommend that you use the ProductService.AddLocalInventoriesmethod instead of theProductService.AddFulfillmentPlacesmethod. | 
| addLocalInventories | POST /v2/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:addLocalInventoriesUpdates local inventory information for a Productat a list of places, while respecting the last update timestamps of each inventory field. | 
| create | POST /v2/{parent=projects/*/locations/*/catalogs/*/branches/*}/productsCreates a Product. | 
| delete | DELETE /v2/{name=projects/*/locations/*/catalogs/*/branches/*/products/**}Deletes a Product. | 
| get | GET /v2/{name=projects/*/locations/*/catalogs/*/branches/*/products/**}Gets a Product. | 
| import | POST /v2/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:importBulk import of multiple Products. | 
| list | GET /v2/{parent=projects/*/locations/*/catalogs/*/branches/*}/productsGets a list of Products. | 
| patch | PATCH /v2/{product.name=projects/*/locations/*/catalogs/*/branches/*/products/**}Updates a Product. | 
| purge | POST /v2/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:purgePermanently deletes all selected Products under a branch. | 
| removeFulfillmentPlaces | POST /v2/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:removeFulfillmentPlacesWe recommend that you use the ProductService.RemoveLocalInventoriesmethod instead of theProductService.RemoveFulfillmentPlacesmethod. | 
| removeLocalInventories | POST /v2/{product=projects/*/locations/*/catalogs/*/branches/*/products/**}:removeLocalInventoriesRemove local inventory information for a Productat a list of places at a removal timestamp. | 
| setInventory | POST /v2/{inventory.name=projects/*/locations/*/catalogs/*/branches/*/products/**}:setInventoryUpdates inventory information for a Productwhile respecting the last update timestamps of each inventory field. | 
REST Resource: v2.projects.locations.catalogs.completionData
| Methods | |
|---|---|
| import | POST /v2/{parent=projects/*/locations/*/catalogs/*}/completionData:importBulk import of processed completion dataset. | 
REST Resource: v2.projects.locations.catalogs.controls
| Methods | |
|---|---|
| create | POST /v2/{parent=projects/*/locations/*/catalogs/*}/controlsCreates a Control. | 
| delete | DELETE /v2/{name=projects/*/locations/*/catalogs/*/controls/*}Deletes a Control. | 
| get | GET /v2/{name=projects/*/locations/*/catalogs/*/controls/*}Gets a Control. | 
| list | GET /v2/{parent=projects/*/locations/*/catalogs/*}/controlsLists all Controls by their parent Catalog. | 
| patch | PATCH /v2/{control.name=projects/*/locations/*/catalogs/*/controls/*}Updates a Control. | 
REST Resource: v2.projects.locations.catalogs.generativeQuestion
| Methods | |
|---|---|
| batchUpdate | POST /v2/{parent=projects/*/locations/*/catalogs/*}/generativeQuestion:batchUpdateAllows management of multiple questions. | 
REST Resource: v2.projects.locations.catalogs.generativeQuestions
| Methods | |
|---|---|
| list | GET /v2/{parent=projects/*/locations/*/catalogs/*}/generativeQuestionsReturns all questions for a given catalog. | 
REST Resource: v2.projects.locations.catalogs.models
| Methods | |
|---|---|
| create | POST /v2/{parent=projects/*/locations/*/catalogs/*}/modelsCreates a new model. | 
| delete | DELETE /v2/{name=projects/*/locations/*/catalogs/*/models/*}Deletes an existing model. | 
| get | GET /v2/{name=projects/*/locations/*/catalogs/*/models/*}Gets a model. | 
| list | GET /v2/{parent=projects/*/locations/*/catalogs/*}/modelsLists all the models linked to this event store. | 
| patch | PATCH /v2/{model.name=projects/*/locations/*/catalogs/*/models/*}Update of model metadata. | 
| pause | POST /v2/{name=projects/*/locations/*/catalogs/*/models/*}:pausePauses the training of an existing model. | 
| resume | POST /v2/{name=projects/*/locations/*/catalogs/*/models/*}:resumeResumes the training of an existing model. | 
| tune | POST /v2/{name=projects/*/locations/*/catalogs/*/models/*}:tuneTunes an existing model. | 
REST Resource: v2.projects.locations.catalogs.operations
| Methods | |
|---|---|
| get | GET /v2/{name=projects/*/locations/*/catalogs/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2/{name=projects/*/locations/*/catalogs/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2.projects.locations.catalogs.placements
| Methods | |
|---|---|
| predict | POST /v2/{placement=projects/*/locations/*/catalogs/*/placements/*}:predictMakes a recommendation prediction. | 
| search | POST /v2/{placement=projects/*/locations/*/catalogs/*/placements/*}:searchPerforms a search. | 
REST Resource: v2.projects.locations.catalogs.servingConfigs
| Methods | |
|---|---|
| addControl | POST /v2/{servingConfig=projects/*/locations/*/catalogs/*/servingConfigs/*}:addControlEnables a Control on the specified ServingConfig. | 
| create | POST /v2/{parent=projects/*/locations/*/catalogs/*}/servingConfigsCreates a ServingConfig. | 
| delete | DELETE /v2/{name=projects/*/locations/*/catalogs/*/servingConfigs/*}Deletes a ServingConfig. | 
| get | GET /v2/{name=projects/*/locations/*/catalogs/*/servingConfigs/*}Gets a ServingConfig. | 
| list | GET /v2/{parent=projects/*/locations/*/catalogs/*}/servingConfigsLists all ServingConfigs linked to this catalog. | 
| patch | PATCH /v2/{servingConfig.name=projects/*/locations/*/catalogs/*/servingConfigs/*}Updates a ServingConfig. | 
| predict | POST /v2/{placement=projects/*/locations/*/catalogs/*/servingConfigs/*}:predictMakes a recommendation prediction. | 
| removeControl | POST /v2/{servingConfig=projects/*/locations/*/catalogs/*/servingConfigs/*}:removeControlDisables a Control on the specified ServingConfig. | 
| search | POST /v2/{placement=projects/*/locations/*/catalogs/*/servingConfigs/*}:searchPerforms a search. | 
REST Resource: v2.projects.locations.catalogs.userEvents
| Methods | |
|---|---|
| collect | GET /v2/{parent=projects/*/locations/*/catalogs/*}/userEvents:collectWrites a single user event from the browser. | 
| import | POST /v2/{parent=projects/*/locations/*/catalogs/*}/userEvents:importBulk import of User events. | 
| purge | POST /v2/{parent=projects/*/locations/*/catalogs/*}/userEvents:purgeDeletes permanently all user events specified by the filter provided. | 
| rejoin | POST /v2/{parent=projects/*/locations/*/catalogs/*}/userEvents:rejoinStarts a user-event rejoin operation with latest product catalog. | 
| write | POST /v2/{parent=projects/*/locations/*/catalogs/*}/userEvents:writeWrites a single user event. | 
REST Resource: v2.projects.locations.operations
| Methods | |
|---|---|
| get | GET /v2/{name=projects/*/locations/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2/{name=projects/*/locations/*}/operationsLists operations that match the specified filter in the request. | 
REST Resource: v2.projects.operations
| Methods | |
|---|---|
| get | GET /v2/{name=projects/*/operations/*}Gets the latest state of a long-running operation. | 
| list | GET /v2/{name=projects/*}/operationsLists operations that match the specified filter in the request. |