[ベータ版]{class="badge informative"}
セルフサービスソースの概要（ストリーミングSDK）
セルフサービスソース（ストリーミングSDK）を使用すると、独自のソースを統合して、ストリーミングデータをAdobe Experience Platformに取り込むことができます。 このドキュメントでは、Flow Service APIを呼び出す前に知っておく必要があるコアコンセプトについて説明します。
プロセスの概要
Experience Platformでソースを設定する手順の概要を以下に示します。
統合
- ストリーミング SDKの新しい接続仕様を作成します。
- 新しい接続仕様IDでストリーミングフロー仕様を更新します。
- ストリーミングソースをテストして送信。
ドキュメント
- ソースのドキュメント作成を開始するには、「 セルフサービス ソースのドキュメント作成の概要」を参照してください。
- GitHubを使用してドキュメントを作成する手順については、GitHub web インターフェイスの使用に関するガイドを参照してください。
- ローカルマシンを使用してドキュメントを作成する手順については、 テキストエディターの使用に関するガイドを参照してください。
- Streaming SDK API ドキュメントテンプレートを使用して、APIでソースをドキュメント化します。
- ストリーミング SDK UI ドキュメント テンプレートを使用して、UIでソースをドキュメント化します。
以下のドキュメントテンプレートをダウンロードすることもできます。
前提条件
セルフサービスソース（ストリーミング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）を使用した新しいソースの作成を開始するには、新しいソースの作成に関するチュートリアルを参照してください。