使用 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)
如需了解详情,请参阅插入/列出/更新/删除商品。
基本操作
您可以尝试提出以下一些基本请求。
使用
InsertCssProductInput
插入测试商品。 如需有关要发送的属性的帮助,请查看此示例代码。使用
ListCssProducts
列出您的所有商品。 请注意,插入商品与商品显示在商品详情中之间会存在短暂的处理延迟。如果您没有立即看到,请稍等几秒钟,然后重试。使用
cssproductinput.name
通过UpdateCssProductInput
更新单个商品。您只需发送需要更新的属性。如需查看示例,请参阅示例代码。使用
DeleteCssProductInpu
删除测试商品,并提供raw_provided_id
。
限制
插入或删除单个商品可能需要较长时间。如需提升性能,请参阅使用 Async 提升性能。 这样就可以并行调用 API。
列出账号并为其添加标签
借助 CSS API 中的标签管理功能,您可以使用自定义标签以编程方式整理客户 Merchant Center 账号。此功能可帮助您高效地对客户进行分类(例如,按类型或策略),从而更好地组织和简化运营。您可以使用该 API 对标签执行以下功能: