Merchant API を使用するには、Merchant Center アカウントが必要です。Merchant Center の管理画面を使用して作成できます。
複数のアカウントを管理する必要がある場合は、Merchant API を使用してサブアカウントを作成できます。
アカウントは、Merchant Center の管理画面で設定するか、後述の API を使用して設定できます。
Merchant Center 利用規約に同意する
すべての販売者は、Merchant Center 利用規約に同意する必要があります。販売アカウントの利用規約に同意する方法は次のとおりです。
accounts.v1beta.accounts.termsOfServiceAgreementStates.retrieveForApplication
を呼び出して、アカウントに必要な利用規約を確認します。accounts.v1beta.termsOfService.accept
を呼び出して、利用規約に同意します。
販売者に利用規約を表示し、同意を求める UI を作成することをおすすめします。
- ビジネスの
regionCode
を使用してaccounts.v1beta.termsOfService.retrieveLatest
を実行し、販売者が同意する必要がある利用規約を確認します。 fileUri
の利用規約を販売者に表示します。- 販売者が UI で利用規約に同意したら、同意する利用規約の
name
を指定してaccounts.v1beta.termsOfService.accept
を呼び出します。
販売者が利用規約に同意したら、Merchant API を使用して残りのアカウント情報を設定できます。Merchant Accounts API で管理できるアカウント情報の詳細については、Account
リソースをご覧ください。
ウェブサイトを申請する
Merchant Accounts API を使用して、ビジネスの Homepage
を追加して登録できます。
- ホームページをアカウントに追加するには、ホームページの URL を含む
Homepage
リソースを指定してaccounts.v1beta.accounts.updateHomepage
を呼び出します。 - ホームページの所有権を主張するには、
Hompeage
リソースのname
を指定してaccounts.v1beta.accounts.homepage.claim
を呼び出します。
Merchant API を使用してホームページを確認することはできません。詳しくは、ショップのウェブサイトの所有権の証明と申請を行うをご覧ください。
ビジネスの詳細を更新する
Merchant Accounts API を使用して、ビジネスの PostalAddress
、CusomerService
、BusinessIdentity
を編集できます。
ビジネス情報:
- ビジネス情報を表示するには、
accounts.v1beta.accounts.getBusinessInfo
を呼び出します。 - ビジネス情報を編集するには、
accounts.v1beta.accounts.updateBusinessInfo
を呼び出します。
ビジネスの身元:
- ビジネス アイデンティティを表示するには、
accounts.v1beta.accounts.getBusinessIdentity
を呼び出します。 - ビジネス アイデンティティを編集するには、
accounts.v1beta.accounts.updateBusinessIdentity
を呼び出します。
次のステップ
- サブアカウントを作成、管理する方法を学習する。
- 販売アカウント間の関係の仕組みについては、アカウント間の関係をご覧ください。