这是 Recommendations AI、Retail Search 和新的 Retail 控制台的文档。

管理目录信息

本页面介绍如何在将目录导入 Retail API 后管理商品信息。您可以读取、写入和删除目录中的商品。

要使目录随商品信息变化而保持最新状态,请按照首次导入的方式导入目录。如需导入目录方面的帮助,请参阅导入目录信息

教程:创建/获取/更新/删除商品

本教程介绍如何使用 Retail API 商品服务方法,这些方法将执行以下操作:

  • 创建商品
  • 获取商品
  • 更新商品
  • 删除商品

如需在 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": "Shoes & Accessories > Shoes"
    }' \
    "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": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "product title",
  "availability": "IN_STOCK"
}

Java

public static Product createProduct(Product productToCreate, String productId)
    throws IOException {
  return getProductServiceClient().createProduct(
      DEFAULT_BRANCH_NAME, productToCreate, productId
  );
}

更新商品信息

当您的产品目录发生变化时,您可以通过实时上传产品变化情况(例如新产品、价格和库存状态)来刷新目录。您只能上传已添加或更改的产品;无需重新加载整个目录。

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": [
    "Shoes & Accessories > Shoes"
  ],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Java

public static Product updateProduct(Product productToUpdate) throws IOException {
  return getProductServiceClient().updateProduct(productToUpdate, FieldMask.getDefaultInstance());
}

删除商品信息

虽然 Retail API 提供了一种从目录中删除商品的方法,但请注意,如果您记录与已删除的商品项相关的用户事件,Retail 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

public static void deleteProduct(String productName) throws IOException {
  getProductServiceClient().deleteProduct(productName);
}

检索商品

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": [
      "Shoes & Accessories \u003e Shoes"
    ],
    "title": "product title",
    "availability": "IN_STOCK"
}

Java

public static Product getProduct(String productName) throws IOException {
  return getProductServiceClient().getProduct(productName);
}

查看有关目录的汇总信息

您可以在“Retail 数据”页面的“目录”标签页中查看有关您的目录的汇总信息并预览上传的产品项。

更改商品类型

导入商品时,您可以指定商品的类型是主项、变体还是集合。如果商品类型更改或未正确指定,您必须删除商品并使用指定的更新后类型创建商品

商品的类型可以设置为 TYPE_UNSPECIFIEDPRIMARYVARIANTCOLLECTION。如需了解详情,请参阅参考文档中的 product.Type

更改产品级配置

使用 Merchant Center 导入目录时,您必须指定商品是主项还是变体。如果这些商品级别发生了更改或未正确指定,请按照以下步骤更正其配置。您必须具有 Retail Admin IAM 角色才能完成此过程。

  1. 确保在重新配置商品级别时没有执行任何导入操作。这样可确保数据不会在错误的级别上传。

  2. 删除所有产品项。请参阅 products.delete。 目录必须完全为空,才能继续下一步。

  3. 重新导入数据即可更改商品级配置。

    此过程取决于您的导入方式。按照导入目录信息中的相应程序将商品级别设置为新配置。

  4. 按照您在导入目录信息中选择的流程,完成导入修改后的级别配置的新目录。

  5. 调整所有现有模型。

    如需调整模型,请转到“模型”页面,点击模型名称以查看其详情页面,然后点击按钮栏中的手动调整

    转到“Retail 模型”页面

    如需了解调整费用详情,请参阅价格