Merchant API 严格要求进行身份验证。您可以使用 OAuth 2.0 凭证、服务账号或应用默认凭证 (ADC)(通常用于测试和本地开发)进行身份验证。
您可以使用服务账号授权 Merchant API 访问您自己的 Merchant Center 账号。如果您的应用需要访问客户的 Merchant Center 账号,请参阅授权第三方应用访问 Merchant Center 账号。
服务账号是一种通常由应用(而非个人)使用的特殊账号。服务账号由其专属的邮箱标识。
您必须先拥有 Merchant Center 账号,然后才能完成这些步骤。
创建服务账号
生成服务账号凭证,或访问您已生成的公开凭证,然后创建 OAuth 2.0 客户端 ID:
- 转到 Google API 控制台。
- 在页面顶部的下拉菜单中选择一个项目,或点击新建项目创建一个项目。
- 在 Google API 列表中搜索 Merchant API,并确保已为此项目启用该 API。
- 点击管理。
- 在左侧边栏中,选择凭证。您可能需要点击页面左上角的向左箭头才能看到凭据。
- 依次选择创建凭证和服务账号。
- 为服务账号命名。这是服务账号 ID 的默认用户名。保存服务账号 ID(包括“@”字符后面的部分),以备日后使用。
点击创建,完成可选步骤以授予对项目和用户的访问权限,然后点击完成。
获取 JSON 私钥
在 Google API 控制台中为您的服务账号生成 JSON 私钥:
- 点击该服务账号,然后选择密钥标签页。
- 依次点击添加密钥 > 创建新密钥。
- 选择 JSON 作为密钥类型。
- 点击创建以下载私钥。注意:您只能在创建私钥时下载私钥。您之后无法返回此步骤。
向服务账号授予对 Merchant Center 账号的访问权限
将新服务账号作为用户添加到您的 Merchant Center 账号:
- 登录 Merchant Center。
- 点击设置 settings。
- 在下拉菜单中,点击访问权限和服务。
- 在“用户和访问权限”标签页下,点击添加用户。
输入您的服务账号 ID 作为新用户的邮箱。
如果您没有保存服务账号 ID,请前往服务账号管理页面,然后选择您的项目。
指定服务账号的用户访问权限和电子邮件通知偏好设置。
点击添加用户以保存并返回用户列表。 现在,该服务账号 ID 应已列出,并具有所选的用户角色。
您可以对需要访问 Merchant Center 账号数据的所有服务账号重复这些步骤。
常见问题解答
- 我可以使用服务账号登录 Merchant Center 界面吗?
- 不能,服务账号不是常规 Google 账号,无法访问 Merchant Center 界面。
- 我需要多久刷新一次服务账号访问令牌?
- 访问令牌会在 Google OAuth 2.0 授权服务器颁发一小时后过期。访问令牌到期后,应用应使用客户端库获取另一个访问令牌。如需手动刷新令牌,请删除
stored-token.json文件并重新进行身份验证。