ソースの送信

最終更新日： 2025年10月14日

トピック：
Sources

作成対象：

Developer

セルフサービスソース（バッチSDK）を使用して新しいソースをAdobe Experience Platformに統合する最後の手順は、検証のためにソースをテストすることです。成功したら、Adobe担当者に連絡して新しいソースを送信できます。

次のドキュメントでは、Flow Service APIを使用してソースをテストおよびデバッグする手順について説明します。

はじめに

Experience Platform APIの呼び出しを正常に行う方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。
Experience Platform APIの資格情報を生成する方法について詳しくは、Experience Platform APIの認証とアクセスに関するチュートリアルを参照してください。
Experience Platform API用のPostmanの設定方法について詳しくは、開発者向けコンソールの設定および Postmanに関するチュートリアルを参照してください。
テストとデバッグのプロセスを支援するには、セルフサービスソース検証のコレクションと環境をダウンロードし、次の手順に従います。

ソースをテストする

ソースをテストするには、ソースに関連する適切な環境変数を指定しながら、Postmanでセルフサービスソース検証コレクションと環境を実行する必要があります。

テストを開始するには、まずPostmanにコレクションと環境を設定する必要があります。次に、テストする接続仕様IDを指定します。

`authSpecName`を指定

接続仕様IDを入力したら、ベース接続に使用するauthSpecNameを指定する必要があります。選択に応じて、これはOAuth 2 Refresh CodeまたはBasic Authenticationのいずれかになります。 authSpecNameを指定したら、必要な資格情報を環境に含める必要があります。例えば、authSpecNameをOAuth 2 Refresh Codeとして指定する場合、hostとaccessTokenのOAuth 2に必要な資格情報を指定する必要があります。

`sourceSpec`を指定

認証仕様パラメーターを追加したら、次にソース仕様から必要なプロパティを追加する必要があります。必要なプロパティはsourceSpec.spec.propertiesにあります。以下のMailChimp Membersの例の場合、必要なプロパティはlistIdのみです。つまり、listIdであり、Postman環境に対応するID値です。

"spec": {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "description": "Define user input parameters to fetch resource values.",
  "properties": {
    "listId": {
      "type": "string",
      "description": "listId for which members need to fetch."
    }
  }
}

認証とソース仕様パラメーターを指定したら、残りの環境変数の入力を開始できます。参照用に次の表を参照してください。

NOTE

以下の例の変数はすべて、更新する必要があるプレースホルダー値です。ただし、flowSpecificationIdとtargetConnectionSpecIdは固定値です。

パラメーター

説明

例

x-api-key

Experience Platform APIへの呼び出しを認証するために使用される一意のID。 x-api-keyの取得方法について詳しくは、Experience Platform APIの認証とアクセスに関するチュートリアルを参照してください。

c8d9a2f5c1e03789bd22e8efdd1bdc1b

x-gw-ims-org-id

製品やサービスを所有またはライセンス供与し、そのメンバーへのアクセスを許可できる法人。 x-gw-ims-org-id情報の取得方法については、開発者向けコンソールの設定と Postmanに関するチュートリアルを参照してください。

ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg

authorizationToken

Experience Platform APIへの呼び出しを完了するために必要な認証トークン。 authorizationTokenの取得方法について詳しくは、Experience Platform APIの認証とアクセスに関するチュートリアルを参照してください。

Bearer authorizationToken

schemaId

ソースデータをExperience Platformで使用するには、必要に応じてソースデータを構造化するターゲットスキーマを作成する必要があります。ターゲット XDM スキーマの作成手順について詳しくは、 API を使用したスキーマの作成に関するチュートリアルを参照してください。

https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b

schemaVersion

スキーマに対応する一意のバージョン。

application/vnd.adobe.xed-full-notext+json; version=1

schemaAltId

新しいスキーマの作成時にschemaIdと一緒に返されるmeta:altIdです。

_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b

dataSetId

ターゲットデータセットの作成手順について詳しくは、 API を使用したデータセットの作成に関するチュートリアルを参照してください。

5f3c3cedb2805c194ff0b69a

mappings

マッピングセットを使用すると、ソーススキーマ内のデータと宛先スキーマのデータとのマッピング方法を定義できます。マッピングの作成方法について詳しくは、APIを使用したマッピングセットの作成に関するチュートリアルを参照してください。

[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]

mappingId

マッピングセットに対応する一意のID。

bf5286a9c1ad4266baca76ba3adc9366

connectionSpecId

ソースに対応する接続仕様ID。これは、新しい接続仕様を作成した後に生成したIDです。

2e8580db-6489-4726-96de-e33f5f60295f

flowSpecificationId

フロー指定ID RestStorageToAEP。 これは固定値です。

6499120c-0b15-42dc-936e-847ea3c24d72

targetConnectionSpecId

取り込んだデータが格納されるデータレイクのターゲット接続ID。 これは固定値です。

c604ff05-7f1a-43c0-8e18-33bf874cb11c