セルフサービスソースの概要(バッチSDK)
セルフサービスソース(バッチSDK)を使用すると、独自のREST ベースのソースを統合して、バッチデータをAdobe Experience Platformに取り込むことができます。 このドキュメントでは、Flow Service APIを呼び出す前に知っておく必要があるコアコンセプトについて説明します。
前提条件
セルフサービスソース(バッチSDK)を使用するには、Adobe Experience Platform ソースでプロビジョニングされた組織サンドボックスにアクセスできることを確認する必要があります。
このガイドでは、Adobe Experience Platformの次のコンポーネントについても理解する必要があります。
- ソース : Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
- サンドボックス : Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。
API 呼び出し例の読み取り
セルフサービスソース(バッチSDK)およびFlow Service API ドキュメントには、リクエストの書式設定方法を示すAPI呼び出しの例が記載されています。 これには、パス、必須ヘッダー、適切な形式のリクエストペイロードが含まれます。 また、API レスポンスで返されるサンプル JSON も示されています。 ドキュメントで使用される API 呼び出し例の表記について詳しくは、Experience Platform トラブルシューテングガイドのAPI 呼び出し例の読み方に関する節を参照してください。
必須ヘッダーの値の収集
Experience Platform API を呼び出すには、まず認証に関するチュートリアルを完了する必要があります。 次に示すように、すべての Experience Platform API 呼び出しに必要な各ヘッダーの値は認証チュートリアルで説明されています。
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Flow Serviceに属するリソースを含むExperience Platformのすべてのリソースは、特定のバーチャルサンドボックスに分離されます。 Experience Platform APIへのすべてのリクエストには、操作を実行するサンドボックスの名前を指定するヘッダーが必要です。
x-sandbox-name: {SANDBOX_NAME}
ペイロード(POST、PUT、PATCH)を含んだすべてのリクエストには、以下の追加ヘッダーが必要です。
Content-Type: application/json
次の手順
セルフサービスソース(バッチSDK)を使用した新しいソースの作成を開始するには、新しいソースの作成に関するチュートリアルを参照してください。