APIオンボーディング
プライム・Video API  Help Topics  APIオンボーディング

APIオンボーディング

最終更新日 2026-01-26

    Prime Videoは、コンテンツ管理の合理化と、貴重なビジネスインサイトの提供のために設計された、2つの包括的なAPIスイートをパートナー様に提供しています。このガイドは、コンテンツAPIスイートとアナリティクスAPIスイートの双方のためのオンボーディングプロセスのすべてを概説し、そこには認証要件、技術設定、両者の主な違いなどが含まれます。

    コンテンツAPIスイートへのオンボーディング

    ステップ1: アクセス権をリクエストして認証情報を生成する

    コンテンツAPIスイートでのアクセス権をリクエストするには、Prime Videoの連絡先に連絡するか、「お問い合わせ」からアクセス権リクエストを伝えてください。

    ステップ2: 認証情報を生成して送信する

    アクセスリクエストが承認されたら、環境ごとにプライベートキーと証明書署名リクエスト(CSR)を生成し、指定されたPrime Video連絡先と共有してください。

    CSRを生成する
    CSRの生成には、どの証明書ツールも使用可能です。OpenSSLを使用したい場合は、次の2つのコマンドを実行できます:

    Prime Video連絡先にCSRを送信する
    CSRには、API証明書を生成するために必要なすべての情報が含まれています。これは、オンボーディングリクエストの一部として連絡先に送信するファイルです。Prime VideoがCSRを受け取ったら、このファイルはもう必要ありません。

    注意: プライベートキーファイルは安全に保管し、Prime Videoを含めて誰とも共有しないことは、非常に重要です。当社がこのファイルを求めることは決してありません。ファイルは後で当社にAPI呼び出しを行うときに使用します。

    ステップ3: 認証情報を受け取る

    リクエストが承認されると、次の情報を伴うPrime Videoチームからのメールが届きます:

    • お客様が当社に電話をかける際に使用するパブリック証明書。
    • リクエストヘッダーのAPIキー
    • API呼び出しのURLエンドポイント。
    • 貴社が証明書により構成される対象のTPSに関する情報。

    ステップ4: 統合を構成する

    お知らせします。 これで、プライベートキー、パブリック証明書、およびAPIキーを使用してAPIを呼び出せるようになりました。ここでは、さまざまなテクノロジーを使用した統合の例をいくつか紹介します:

    Bash

    Python

    Node.js

    ステップ5: 統合をテストする

    アベイルAPIにおいて当社は、API経由でのアベイルの送信、更新、期限終了を正常に行えることを確かめるテストサポートを提供しています。これらの作業は(データ取得だけでなく)アセットに直接影響するため、当社はすべてのパートナー様が統合を徹底的にテストすることを強くお勧めします。オファーステータスおよびアセットステータスAPIは読み取り専用なので、プロダクションアカウントを使ってテストできます。

    ステップ6: APIの使用を開始する

    お知らせします。 テストが完了し、認証されました。これで、プロダクション認証情報によりプロダクション環境を使用し、Prime Videoでコンテンツを管理できるようになりました。統合が準備完了し、コンテンツ運用を合理化し、カタログをリアルタイムで可視化できます。

    コンテンツAPIに関するよくある質問

    アナリティクスAPIスイートへのオンボーディング

    ステップ1: セキュリティプロファイルを作成する

    このステップの一環として、Amazonの開発者コンソールを通して、アプリケーション認証情報の設定と、認証設定の構成を行ないます。

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

    1. Amazon開発者コンソールに移動して登録プロセスを開始してください
    2. 既存のAmazon開発者アカウントでサインインするか、アカウントを持っていない場合は新しいアカウントを作成してください
    3. 「新しいセキュリティプロファイルを作成」をクリックして、アプリケーションの認証設定の構成を開始してください
    Login to AmazonDeveloper.png

    プロファイルを構成する

    1. セキュリティプロファイル: 構成を明確に識別できるわかりやすい名前を選んでください(例:「パフォーマンスデータ統合」や「アナリティクスAPIアクセス」)
    2. 説明: アプリケーションがどのような目的を持ち、アナリティクスAPIをどのように使用するかを明確に説明してください
    3. プライバシー規約URL: アプリケーションがユーザーのデータをどのように処理し保護するかをユーザーに説明するURLを含めてください
    4. 「保存」をクリックするとセキュリティプロファイルができあがります
    5. 正しく設定すると、完了したことを示すメッセージが届きます
    Security Profile Management.png

    リダイレクトURLを設定する

    1. プロファイルに移動し、新しく作成したセキュリティプロファイルの「セキュリティプロファイル」タブで「管理」を選択してください:
    2. 次に、「ウェブ設定」を選択して、アプリケーションのリダイレクト動作を構成してください
    3. リダイレクトURLを追加してください。これはアプリケーションを承認した後にユーザーが移動する安全なエンドポイントとなります(ローカル開発にはhttps://かhttps://localhostを使用する必要があります)
    Security Profile Management 2.png

    重要: このURLは安全に保存してください。次のステップで認証コードを生成するときに、このURLを正確に使用する必要があります。

    認証情報を受け取る

    1. 「ウェブ設定」タブに移動して、アプリケーション認証情報にアクセスしてください
    2. クライアントID(アプリケーションの一意の識別子となります)とクライアントシークレット(アプリケーションのパスワードとなります)をコピーしてください
    3. 両方の認証情報を組織のシークレット管理システムに安全に保管してください。これらはすべてのAPIリクエストの認証に使用されます

    ステップ2: アプリケーションを承認する

    このステップの一環として、組織に代わってアプリケーションにPrime Video Slateへのアクセスを許可し、APIを通してパフォーマンスデータや分析情報を取得するために必要な権限を設定します。

    Slateにアプリケーションを追加する

    1. 組織の認証情報を使ってPrime Video Slateアカウントにサインインしてください
    2. 右上隅の「アカウント設定」に移動し、ドロップダウンメニューから「アプリケーション」を選択してください
    Slate Applications.png

    1. 「アプリケーションを追加」をクリックして認証プロセスを開始してください
    Add applications.png

    1. 表示されたフィールドにクライアントID(ステップ1から)を入力してください
    2. 「レポーティング」チェックボックスを選択して、アプリケーションにパフォーマンスデータとレポートへのアクセスを許可してください
    3. 「アプリケーションを追加」をクリックしてSlateでの登録を完了してください

    認証コードを生成する

    1. 括弧で囲まれたプレースホルダーをステップ1の実際の認証情報に置き換えて、認証URLを作成してください:

    1. このURLをウェブブラウザで開き、認証フローを開始してください
    2. プロンプトが表示されたら、Slateアカウントの認証情報でサインインしてください
    3. アプリケーションが要求している権限を確認し、「許可」をクリックしてアクセスを許可してください
    4. 認証後、指定したリダイレクトURLにリダイレクトされます。URLのクエリ文字列(以下のように表示されます: から認証コードをコピーしてください

    ベストプラクティス: APIアクセスに特化して最低限必要な権限を持つ専用Slateアカウント(例: api_access@yourcompany.com)を作成することをおすすめします。これによりセキュリティが強化され、組織全体のAPI使用状況の管理と監査が容易になります。

    注意: 認証ユーザーのレポート使用権限を削除すると、アプリケーションはレポート使用権限の取り消しも行います。

    ステップ3: アクセストークンをリクエストする

    このステップの一環として、認証コードを使用して、認証済みAPIの呼び出しに必要なトークンを取得します。アクセストークンを使用すると、アプリケーションはパフォーマンスデータを取得でき、リフレッシュトークンを使用すると、認証プロセスを繰り返さずに新しいアクセストークンを生成できます。

    認証コードは、1回限りのトークンです。access_tokenの取得に使用されると、次のaccess_tokenの取得に使用できるrefresh_tokenを返します。次のセクションでは、最初のrefresh_tokenの取得について説明します。

    最初のトークンリクエスト(初回のみ):
    トークンをリクエストするには:

    1. client_id、client_secret、authorization_code、grant_type をURLエンコード済みフォームデータとして入力してください。
    2. HTTPリクエストを行ってください。
      authorization_codeからトークンを生成するcurlコマンドの例を以下に示します。

    アクセストークンのリフレッシュ:
    最初のトークンリクエスト後のすべてのセッションでは、リフレッシュトークンを使用して新しいアクセストークンを取得してください:

    ステップ4: アプリケーションを構成する

    お知らせします。 これで、パフォーマンスAPIを呼び出すために必要なすべての認証情報が揃いました。このステップの一環として、各APIリクエストの認証ヘッダーにアクセストークンを含めるためアプリケーションを構成します。これにより、コンテンツのサブスクリプションデータ、パフォーマンスメトリクス、および分析情報を取得できるようになります。

    サンプルAPIリクエスト:


    この例は、リクエストを認証する方法を示しています。 を、ステップ3で受け取った実際のアクセストークンに置き換えてください。これで、この認証パターンを使って、使用可能なすべてのパフォーマンスAPIエンドポイントにアクセスし、分析パイプライン用の詳細なデータを含む追加専用データセットファイルを取得できるようになりました。

    ステップ5: テスト統合

    すべてのパートナー様には、パフォーマンスデータに必ず信頼あるアクセスができるように、統合を徹底的にテストすることを強くお勧めします。このステップの一環として、認証フローが正しく機能すること、API呼び出しが期待されるデータを返すこと、および、エラー処理が適切に構成されていることを検証します。

    ステップ6: 使用開始

    テストが完了し、統合が確実に機能することを確認したら、プロダクション環境を使用してPrime Videoのコンテンツのパフォーマンスデータと分析情報をリアルタイムで取得できます。データパイプラインでは、追加専用データセットファイルを使用して、組織が必要とする詳細な分析を実行できるようになりました。

    アナリティクスAPIデータフレームワークの詳細については、こちらをご覧ください:

    1. パフォーマンスデータセット
    2. レポーティング
    3. 財務諸表
    4. サブスクリプションイベントログ

    アナリティクスAPIに関するよくある質問

    まだヘルプが必要ですか？

    お問い合わせ


    Errore interno del server. Riprova tra qualche istante.
    La tua sessione è scaduta

    Accedi per continuare

    Accedi
    edit