您需要拥有 Merchant Center 账号才能使用 Merchant API。您可以使用 Merchant Center 界面创建此类产品。
如果您需要管理多个账号,可以使用 Merchant API 创建子账号。
您可以在 Merchant Center 界面中或通过 API 配置账号(如后文所述)。
接受 Merchant Center 服务条款
所有商家都必须接受 Merchant Center 服务条款。如需接受您自己商家账号的《服务条款》,请按以下步骤操作:
调用
accounts.termsOfServiceAgreementStates.retrieveForApplication
可了解您的账号需要遵守哪些服务条款。以下是请求示例:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates:retrieveForApplication
以下是成功调用的示例响应:
{ "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{COUNTRY}", "regionCode": {COUNTRY}, "termsOfServiceKind": "MERCHANT_CENTER", "accepted": { "termsOfService": "termsOfService/{VERSION}", "acceptedBy": "accounts/{ACCOUNT_ID}" } }
拨打
termsOfService.accept
接受服务条款。以下是请求示例:
GET https://merchantapi.googleapis.com/accounts/v1beta/{name=termsOfService/{VERSION}}:accept
如果成功,则响应正文将为空。
我们建议您构建一个界面,用于向商家显示服务条款并要求他们接受。
使用商家的
regionCode
与termsOfService.retrieveLatest
一起查找商家需要接受的服务条款。以下是请求示例:
GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest
以下是成功调用的示例响应:
{ "name": "termsOfService/{VERSION}", "regionCode": "{COUNTRY}", "kind": "MERCHANT_CENTER", "fileUri": "{URI}" }
向商家显示
fileUri
中的服务条款。当商家在您的界面中接受服务条款时,请调用
termsOfService.accept
,并提供要接受的服务条款的name
。
商家接受服务条款后,您可以使用 Merchant API 设置其余的账号信息。如需详细了解您可以使用 Merchant Accounts API 管理哪些账号信息,请参阅 Account
资源。
声明网站所有权
您可以使用 Merchant Accounts API 添加和声明商家的 Homepage
。
- 如需向您的账号添加首页,请使用包含首页网址的
Homepage
资源调用accounts.updateHomepage
。 - 如需声明对首页的所有权,请使用
Hompeage
资源中的name
调用accounts.homepage.claim
。
您无法使用 Merchant API 验证您的首页。如需了解详情,请参阅验证您商店的网站并声明其所有权。
更新您的商家详情
您可以使用 Merchant Accounts API 修改商家 PostalAddress
、CusomerService
和 BusinessIdentity
。
商家身份:
- 如需查看您的商家身份,请调用
accounts.businessIdentity.getBusinessIdentity
。 - 如需修改商家身份,请致电
accounts.businessIdentity.updateBusinessIdentity
。