你必須擁有 Merchant Center 帳戶才能使用 Merchant API。你可以使用 Merchant Center UI 建立這類產品。
如需管理多個帳戶,可以使用 Merchant API 建立子帳戶。
你可以在 Merchant Center UI 中或透過 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
如果成功,回應主體會空白。
建議您建構 UI,向商家顯示 TOS,並請他們接受。
使用
termsOfService.retrieveLatest
與商家的regionCode
搭配,找出商家需要接受的 TOS。以下是要求範例:
GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest
以下是成功呼叫的回應範例:
{ "name": "termsOfService/{VERSION}", "regionCode": "{COUNTRY}", "kind": "MERCHANT_CENTER", "fileUri": "{URI}" }
向商家顯示
fileUri
的 TOS。當商家在 UI 中接受 TOS 時,請呼叫
termsOfService.accept
,並傳入要接受的 TOSname
。
商家接受 TOS 後,您就可以使用 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
。