Amazon 販売パートナーの統合 API

Amazon Selling Partner API (SP-API) を介してデータにアクセスするには、次のアクションを実行する必要があります。

1. SP API開発者として登録する

2. SP-API ロールをリクエストする

3. アプリケーションを登録する

4. アプリケーションの認証モデルを選択する

5. SP- に接続するAPI

SP APIデベロッパーとして登録する

SP-API アプリケーションを登録する前に、Amazon デベロッパーアカウントを作成し、SP-API デベロッパーとして登録する必要があります。開発者登録プロセスの包括的な概要については、SP-API ドキュメントの SP- 登録の概要を参照してください。API

SP-API ロールをリクエストする

SP-API ロールは、デベロッパーまたはアプリケーションが特定のオペレーションまたはリソースにアクセスできるかどうかを決定します。デベロッパーは、特定のロールをリクエストして認定する必要があります。そうしないと、そのロールでグループ化されたオペレーションとリソースにアクセスできなくなります。

ロールは、個人を特定できる情報 (PII) やその他の機密データへのアクセスを保護します。データアクセスを制限して、デベロッパーがアプリケーションに必要なデータにのみアクセスできるようにします。これにより、顧客データを保護し、顧客の信頼を維持できます。

ブランド分析レポートで使用できるデータにアクセスするには、ブランド分析ロール が必要です。ロールへのアクセスのリクエストの詳細については、SP-API ドキュメントの「ロールのリクエスト方法と認定方法」を参照してください。

アプリケーションを登録する

登録プロセスは、アプリケーションタイプによって異なります。登録の目的で、アプリケーションは次のいずれかのタイプに分類されます。

• パブリックアプリケーションとプライベート販売アプリケーション – これらは、公開されており、販売者またはベンダーによって認可されているアプリケーション、または組織でのみ利用可能で、自己認可されている販売者アプリケーションです。

• プライベートベンダーアプリケーション – これらは、組織でのみ利用可能で、自己承認のベンダーアプリケーションです。

詳細については、SP-API ドキュメントの「アプリケーションの登録」を参照してください。

アプリケーションの認証モデルを選択する

販売パートナーの認可モデルは、Amazon 2.0 の実装である Login with Amazon OAuth APIに基づいています。アプリケーションは、Amazon およびウェブサイトに表示されるページとのやり取りを通じて承認されます。ウェブブラウザは、販売パートナーアクションごとにウェブサイトと Amazon の間でパラメータを渡すユーザーエージェントです。OAuth 認証を実装するには、Amazon が渡すパラメータを受け入れて処理するようにウェブサイトを設定する必要があります。また、ウェブブラウザをリダイレクトし、パラメータを Amazon に渡すようにウェブサイトを設定する必要があります。認可の詳細については、SP-API ドキュメントの「販売パートナーAPIアプリケーションの認可」を参照してください。

アプリケーション認証を理解する

承認の目的で、アプリケーションには 3 種類あります。

• 販売者向けのパブリックアプリケーション – これらのアプリケーションは公開されており、販売者によって承認されています。次のいずれかの承認ワークフローを選択できます。

  • 販売パートナー Appstore 認証ワークフロー – 販売パートナー Appstore の詳細ページから開始されるOAuth認証ワークフロー。

  • ウェブサイト認証ワークフロー – 独自のウェブサイトから開始されるOAuth認証ワークフロー。

• ベンダーのパブリックアプリケーション – これらのアプリケーションは公開されており、ベンダーによって承認されています。ウェブサイト認証ワークフロー を使用できます。これは、独自のウェブサイトから開始されるOAuth認証ワークフローです。

• 販売者またはベンダー向けのプライベートアプリケーション – これらのアプリケーションは、組織でのみ使用できます。これらは、販売者またはベンダーのアプリケーションです。自己認証アプローチを使用できます。自分の組織のプライベートアプリケーションを作成すると、アカウント情報へのアクセスを自己許可できます。アプリケーションをドラフトステータスで自己承認できます。プライベートアプリケーションを公開する理由はありません。販売者およびベンダーアプリケーションからの自己承認を取り消す方法については、SP-API ドキュメントの「自己承認を取り消す」を参照してください。

アプリケーションアクセスのベンダーグループを承認する

Selling Partner APIアプリケーションがデータにアクセスすることを承認した場合、Vendor Central アカウントのサインイン認証情報に関連付けられているベンダーグループへのアクセスを許可します。拡張により、ベンダーグループに存在するすべてのベンダーコードへのアクセス権を付与します。したがって、販売パートナーAPIの統合には、適切な Vendor Central 認証情報とベンダーグループを使用することが重要です。

ベンダーグループは、ログインするアカウントです。ビジネス契約、オペレーションモデル、その他の要因に応じて、ベンダーグループには 1 つ以上のベンダーコードを含めることができます。各ベンダーコードを使用すると、特定のカテゴリの製品を一覧表示したり、特定のブランドの 1 つのベンダーコードなど、必要なビジネス契約を含めることができます。

ベンダーグループごとに複数の承認を持つことも、すべてのベンダーコードを含む単一のベンダーグループを作成することもできます。プロファイルに関連付けられている複数のベンダーグループを使用するオプションを使用すると、異なるベンダーグループで同じベンダーコードを持つアプリケーションを使用できます。このオプションでは、ベンダーグループごとに複数のベンダーデベロッパーアプリケーションを送信する必要はありません。

詳細については、SP-API ドキュメントの「アプリケーションアクセスのベンダーグループの承認」を参照してください。

SP- に接続するAPI

アプリケーションを登録して承認したら、リクエストを開始できます。詳細については、SP-API ドキュメントの「販売パートナーへの接続API」を参照してください。