开始使用购物比较服务 (CSS)

使用 API 执行基本操作是开始使用该 API 的好方法。

前提条件

在开始之前，请完成以下步骤：

  • 确保您拥有有效的 CSS Center 账号。
  • 注册 API 开发者。
  • 验证权限设置是否正确。
  • 验证您是否已启用 CSS API。
  • 验证您是否已为您的环境安装客户端库。

如需了解详情，请参阅快速入门。

启用 CSS API

如需注册成为开发者以使用 CSS API，您必须使用开发者注册方法关联您的 CSS Center 账号和 Google Cloud 项目，具体操作如下：

关联 CSS Center 和您的 Google Cloud 项目：系统会自动建立关联，因为调用者有权根据访问令牌或 API 密钥访问 Google Cloud 项目，并且是 CSS Center 账号的授权用户。

注册 API 开发者

向 CSS 中心账号添加 API 开发者用户：如果用户已存在，系统只会向其授予新的“API 开发者”访问权限类型。如果是新用户，他们会收到 CSS Center 电子邮件邀请。

注册后，您可以使用 GetDeveloperRegistration 查看注册状态，也可以使用 UnregisterGCP 取消注册。您可以使用以下注册调用：

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

请求成功运行后，您会收到以下响应：

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

CSS 产品

与 Products 子 API 类似，CSS API 会区分 CssProductInput 和 ListCssProduct。插入具有 InsertCssProductInput 的商品。

我们的内部系统处理完商品后（这可能需要几分钟时间），使用 ListCssProducts 检索该商品。

使用 raw_provided_id 识别您的商品。我们建议您使用自己系统中已在使用的标识符。或者，创建此类文件的常用方法包括使用以下任一工具：

  • 全局唯一标识符 (GUID)
  • 通用唯一标识符 (UUID)
  • 串联的唯一商品属性（例如 brand_model_color_size）

如需了解详情，请参阅插入/列出/更新/删除商品。

基本操作

您可以尝试提出以下一些基本请求。

  1. 使用 InsertCssProductInput 插入测试商品。 如需有关要发送的属性的帮助，请查看此示例代码。

  2. 使用 ListCssProducts 列出您的所有商品。 请注意，插入商品与商品显示在商品详情中之间会存在短暂的处理延迟。如果您没有立即看到，请稍等几秒钟，然后重试。

  3. 使用 cssproductinput.name 通过 UpdateCssProductInput 更新单个商品。您只需发送需要更新的属性。如需查看示例，请参阅示例代码。

  4. 使用 DeleteCssProductInpu 删除测试商品，并提供 raw_provided_id。

限制

插入或删除单个商品可能需要较长时间。如需提升性能，请参阅使用 Async 提升性能。 这样就可以并行调用 API。

列出账号并为其添加标签

借助 CSS API 中的标签管理功能，您可以使用自定义标签以编程方式整理客户 Merchant Center 账号。此功能可帮助您高效地对客户进行分类（例如，按类型或策略），从而更好地组织和简化运营。您可以使用该 API 对标签执行以下功能：