プライマリアプリケーション内で実行される基本プロファイルフロー basic-profiles-flow-primary-application

IMPORTANT
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeの最新ライセンスが必要です。 無許可の使用は許可されていません。
IMPORTANT
REST API V2 の実装については、 スロットルメカニズムのドキュメントで制限されています。

Adobe Pass認証使用権内の プロファイルフロー により、ストリーミングアプリケーションはアクティブなユーザーログインに関する情報にアクセスできます。

基本プロファイルフローを使用すると、次のシナリオについてクエリを実行できます。

プロファイルの取得 retrieve-profiles

前提条件 prerequisites-retrieve-profiles

プロファイルを取得する前に、次の前提条件が満たされていることを確認します。

  • ストリーミングアプリケーションは、すべての通常のプロファイルを取得しようとしています。

ワークフロー workflow-retrieve-profiles

次の図に示すように、プライマリ・アプリケーション内で実行される基本プロファイル取得フローを実装するには、次の手順に従います。

プロファイルの取得

プロファイルの取得

  1. プロファイルの取得: ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信することで、すべてのプロファイル情報を取得するために必要なすべてのデータを収集します。

    note important
    IMPORTANT
    次について詳しくは、 プロファイルの取得API ドキュメントを参照してください。
    • serviceProvider のようなすべての 必須 パラメーター
    • AuthorizationAP-Device-Identifier などのすべての 必須 ヘッダー
    • すべての オプション パラメーターおよびヘッダー
  2. 通常のプロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて、有効なすべてのプロファイルを識別します。

  3. 通常のプロファイルに関する情報を返す: プロファイルエンドポイント応答には、受信したパラメーターとヘッダーに関連付けられた、見つかったプロファイルに関する情報が含まれます。

    note important
    IMPORTANT
    プロファイル応答で提供される情報について詳しくは、 プロファイルの取得API ドキュメントを参照してください。
    プロファイルエンドポイントは、基本条件が満たされていることを確認するために、リクエストデータを検証します。
    • required パラメーターおよびヘッダーは有効である必要があります。
    検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。
  4. プロファイルを選択し、決定フローを続行: プロファイルエンドポイント応答にプロファイルが含まれている場合、ストリーミングアプリケーションは(最終的にエンドユーザーとやり取りすることで)内部ロジックを使用して、使用可能なプロファイルの 1 つを選択し、後続の決定フローを続行します。

  5. 新しい基本認証フローを指定: プロファイルエンドポイント応答にプロファイルが含まれていない場合、ストリーミングアプリケーションは新しい基本認証フローを開始するようにユーザーに指示します。

特定の mvpd のプロファイルの取得 retrieve-profile-for-specific-mvpd

前提条件 prerequisites-retrieve-profile-for-specific-mvpd

特定のMVPDのプロファイルを取得する前に、次の前提条件が満たされていることを確認します。

  • 選択されたまたはキャッシュされた mvpd ID を持つストリーミングアプリケーションは、特定のMVPDの通常のプロファイルを取得したいと考えています。

ワークフロー workflow-retrieve-profile-for-specific-mvpd

次の図に示すように、プライマリ・アプリケーション内で実行される特定のMVPDの基本的なプロファイル取得フローを実装するには、次の手順に従います。

特定の mvpd のプロファイルを取得

特定の mvpd のプロファイルを取得

  1. 特定の mvpd のプロファイルを取得: ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信して、その特定のMVPDのプロファイル情報を取得するために必要なすべてのデータを収集します。

    note important
    IMPORTANT
    次について詳しくは、 特定の mvpd のプロファイルを取得API ドキュメントを参照してください。
    • serviceProvidermvpd など、すべての 必須 パラメーター
    • AuthorizationAP-Device-Identifier などのすべての 必須 ヘッダー
    • すべての オプション パラメーターおよびヘッダー
  2. 標準プロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。

  3. 通常のプロファイルに関する情報を返す: プロファイルエンドポイント応答には、受信したパラメーターとヘッダーに関連付けられた、見つかったプロファイルに関する情報が含まれます。

    note important
    IMPORTANT
    プロファイル応答で提供される情報について詳しくは、 特定の mvpd のプロファイルを取得API ドキュメントを参照してください。
    プロファイルエンドポイントは、基本条件が満たされていることを確認するために、リクエストデータを検証します。
    • required パラメーターおよびヘッダーは有効である必要があります。
    • 指定した serviceProvidermvpd の統合はアクティブである必要があります。
    検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。
  4. 決定フローで続行: プロファイルエンドポイント応答にプロファイルが含まれている場合、ストリーミングアプリケーションはプロファイル情報を使用して、後続の決定フローを続行します。

  5. 新しい基本認証フローを指定: プロファイルエンドポイント応答にプロファイルが含まれていない場合、ストリーミングアプリケーションは新しい基本認証フローを開始するようにユーザーに指示します。

特定のコードのプロファイルの取得 retrieve-profile-for-specific-code

前提条件 prerequisites-retrieve-profile-for-specific-code

特定の認証コードのプロファイルを取得する前に、次の前提条件が満たされていることを確認します。

  • MVPDでインタラクティブ認証を実行するために使用される code ールを持つストリーミングアプリケーションは、特定の認証コードのプロファイルを取得したいと考えています。

ワークフロー workflow-retrieve-profile-for-specific-code

次の図に示すように、プライマリ・アプリケーション内で実行される特定の認証コードに対して基本プロファイル取得フローを実装するには、次の手順に従います。

特定のコードのプロファイルを取得

特定のコードのプロファイルを取得

  1. 特定のコードのプロファイルを取得: ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信して、その特定の認証コードのプロファイル情報を取得するために必要なすべてのデータを収集します。

    note important
    IMPORTANT
    次について詳しくは、 特定のコードのプロファイルの取得API ドキュメントを参照してください。
    • serviceProvidercode など、すべての 必須 パラメーター
    • Authorization のようなすべての 必須 ヘッダー
    • すべての オプション パラメーターおよびヘッダー
  2. 標準プロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。

  3. 通常のプロファイルに関する情報を返す: プロファイルエンドポイント応答には、受信したパラメーターとヘッダーに関連付けられた、見つかったプロファイルに関する情報が含まれます。

    note important
    IMPORTANT
    プロファイル応答で提供される情報について詳しくは、 特定のコードのプロファイルの取得API ドキュメントを参照してください。
    プロファイルエンドポイントは、基本条件が満たされていることを確認するために、リクエストデータを検証します。
    • required パラメーターおよびヘッダーは有効である必要があります。
    検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。
  4. 決定フローで続行: プロファイルエンドポイント応答にプロファイルが含まれている場合、ストリーミングアプリケーションはプロファイル情報を使用して、後続の決定フローを続行します。

  5. 新しい基本認証フローを指定: プロファイルエンドポイント応答にプロファイルが含まれていない場合、プライマリアプリケーションは新しい基本認証フローを開始するようにユーザーに指示します。

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b