本页介绍了如何在将目录导入 Vertex AI Search 零售解决方案后管理商品信息。您可以读取、写入和删除目录中的商品。
要使目录随商品信息变化而保持最新状态,请按照首次导入的方式导入目录。如需导入目录方面的帮助,请参阅导入目录信息。
教程:创建/获取/更新/删除商品
本教程介绍了如何使用 方法,从而执行以下操作:
- 创建产品
- 获取商品
- 更新商品
- 删除商品
如需遵循有关此任务的分步指导,请直接在 Cloud Shell Editor 中点击操作演示:
教程:创建商品
本教程介绍了如何创建单个商品。
如需遵循有关此任务的分步指导,请直接在 Cloud Shell Editor 中点击操作演示:
教程:获取商品
本教程介绍了如何检索商品项。
如需遵循有关此任务的分步指导,请直接在 Cloud Shell Editor 中点击操作演示:
教程:更新商品
本教程介绍了如何更新清单中的商品。
如需遵循有关此任务的分步指导,请直接在 Cloud Shell Editor 中点击操作演示:
教程:删除商品
本教程介绍了如何从清单中删除商品。
如需遵循有关此任务的分步指导,请直接在 Cloud Shell Editor 中点击操作演示:
上传商品
curl
使用products.create
REST 方法创建单个产品项。
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "title": "PRODUCT_TITLE", "categories": "CATEGORY" }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productId=PRODUCT_ID"
如果请求成功,则会返回商品对象,如以下示例所示。
{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID", "id": "PRODUCT_ID", "primaryProductId": "PRODUCT_ID", "type": "PRIMARY", "categories": [ "CATEGORY" ], "title": "PRODUCT_TITLE", "availability": "IN_STOCK" }
Java
更新商品信息
当您的产品目录发生变化时,您可以通过实时上传产品变化情况(例如新产品、价格和库存状态)来刷新目录。您只能上传已添加或更改的产品;无需重新加载整个目录。
curl
使用products.patch
方法更新商品信息。
以下示例更新特定产品的标题:
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ "title": "new-title-value" }" \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID?updateMask=title"
如果请求成功,则会返回商品对象,如以下示例所示。
{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID", "id": "PRODUCT_ID", "primaryProductId": "PRODUCT_ID", "type": "PRIMARY", "categories": [ "Parent category > Child category" ], "title": "new product title", "availability": "IN_STOCK" }
Java
删除商品信息
尽管该 API 提供了一种 请注意,如果您记录了与产品相关的用户事件 商品,则 API 无法处理用户 相应活动,它可能会被删除此外,添加历史目录数据可以提高模型的质量,对于优质的推荐和搜索结果至关重要。
您应该将过时商品的 availability
设置为 OUT_OF_STOCK
,而不是将其删除。
curl
使用 delete
方法删除商品,将 PRODUCT_ID 替换为要删除的商品的 ID。
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
Java
检索商品项
curl
要检索商品项,请向 products
端点发出 GET
请求,并将 PRODUCT_ID 替换为要检索的商品的 ID:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
您将看到如下所示的输出:
{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID" "id": "PRODUCT_ID", "primaryProductId": "PRODUCT_ID", "type": "PRIMARY", "categories": [ "Parent category > Child category" ], "title": "product title", "availability": "IN_STOCK" }
Java
查看目录的汇总信息
您可以查看有关目录的汇总信息以及上传的预览 Search for Retail 控制台数据页面的目录标签页中的商品。
评估目录数据质量
如需评估目录数据的质量,请执行以下操作:
前往 Search for Retail 控制台中的数据质量页面。
前往“数据质量”页面数据质量页面可评估您是否需要更新目录数据,以提高搜索结果的质量并解锁搜索效果层级。
如需详细了解如何检查搜索数据质量和查看搜索效果层级,请参阅解锁搜索效果层级。
如需查看可用目录指标的摘要,请参阅 目录质量指标。
更改商品类型
导入商品时,您可以指定商品的类型是主项、变体还是集合。如果商品类型更改或未正确指定,您必须删除商品并使用指定的更新后类型创建商品。
商品的类型可以设置为 TYPE_UNSPECIFIED
、PRIMARY
、VARIANT
或 COLLECTION
。如需了解详情,请参阅参考文档中的 product.Type
。
更改商品级别配置
使用 Merchant Center 导入目录时,您必须指定商品是主项还是变体。如果这些商品级别发生了更改或未正确指定,请按照以下步骤更正其配置。您必须具有 Retail Admin IAM 角色才能完成此过程。
确保在重新配置商品级别时没有执行任何导入操作。这样可确保数据不会在错误的级别上传。
删除所有产品项。请参阅
products.delete
。 目录必须完全为空,才能继续下一步。重新导入数据即可更改商品级配置。
此过程取决于您的导入方式。请按照 导入清单信息,将商品级别设置为 新配置
使用以下命令完成包含修改后的级别配置的新目录导入: 在导入目录信息中选择的流程。
调整所有现有模型。
如需调整模型,请转到“模型”页面,点击模型名称以查看其详情页面,然后点击按钮栏中的手动调整。
如需了解调整费用详情,请参阅价格。