View a markdown version of this page

Amazon Selling Partner API の統合 - AWS 規範ガイダンス
SP-API 開発者として登録するSP-API ロールをリクエストするアプリケーションを登録する認可モデルを選択するSP-API に接続する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Selling Partner 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 ドキュメントの「アプリケーションの登録」を参照してください。

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

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

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

認可の目的で、アプリケーションには 3 つのタイプがあります。

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

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

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

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

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

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

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

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

SP-API に接続する

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