Merchant API を使用するには、Merchant Center アカウントが必要です。Merchant Center の UI を使用して作成できます。
複数のアカウントを管理する必要がある場合は、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
成功すると、レスポンスの本文は空になります。
販売者に利用規約を表示し、同意を求める UI を作成することをおすすめします。
ビジネスの
regionCode
を使用してtermsOfService.retrieveLatest
を実行し、販売者が同意する必要がある利用規約を確認します。リクエストの例を次に示します。
GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest
呼び出しが成功した場合のレスポンスの例を次に示します。
{ "name": "termsOfService/{VERSION}", "regionCode": "{COUNTRY}", "kind": "MERCHANT_CENTER", "fileUri": "{URI}" }
fileUri
の利用規約を販売者に表示します。販売者が UI で利用規約に同意したら、同意する利用規約の
name
を指定してtermsOfService.accept
を呼び出します。
販売者が利用規約に同意したら、Merchant API を使用して残りのアカウント情報を設定できます。Merchant Accounts API で管理できるアカウント情報の詳細については、Account
リソースをご覧ください。
ウェブサイトを申請する
Merchant Accounts API を使用して、ビジネスの Homepage
を追加して登録できます。
- ホームページをアカウントに追加するには、ホームページの URL を含む
Homepage
リソースを指定してaccounts.updateHomepage
を呼び出します。 - ホームページの所有権を主張するには、
Hompeage
リソースのname
を指定してaccounts.homepage.claim
を呼び出します。
Merchant API を使用してホームページを確認することはできません。詳しくは、ショップのウェブサイトの所有権の証明と申請を行うをご覧ください。
ビジネスの詳細を更新する
Merchant Accounts API を使用すると、ビジネスの PostalAddress
、CusomerService
、BusinessIdentity
を編集できます。
ビジネスの身元:
- ビジネス アイデンティティを表示するには、
accounts.businessIdentity.getBusinessIdentity
を呼び出します。 - ビジネス アイデンティティを編集するには、
accounts.businessIdentity.updateBusinessIdentity
を呼び出します。
次のステップ
- サブアカウントを作成、管理する方法を学習する。
- 販売アカウント間の関係の仕組みについては、アカウント間の関係をご覧ください。