ドキュメントExperience Platformソースコネクタガイド

セルフサービスソースの概要(バッチ SDK)

最終更新日: 2025年4月4日
  • トピック:

作成対象:

  • 開発者

セルフサービスソース(バッチ 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}
メモ
Experience Platformのサンドボックスについて詳しくは、 サンドボックスのドキュメントを参照してください。

ペイロード(POST、PUT、PATCH)を含むすべてのリクエストには、次のような追加ヘッダーが必要です。

  • Content-Type: application/json

次の手順

セルフサービスソース(バッチ SDK)を使用した新しいソースの作成を開始するには、 新しいソースの作成に関するチュートリアルを参照してください。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089