プロファイルシステムジョブエンドポイント(削除要求)
Adobe Experience Platform を使用すると、複数のソースからデータを取得し、個々の顧客に対して堅牢なプロファイルを構築できます。Experience Platformに取り込まれたデータはData Lakeに保存され、データセットがプロファイルに対して有効になっている場合、そのデータもReal-Time Customer Profile データストアに保存されます。 場合によっては、不要になったデータやエラーで追加されたデータを削除するために、プロファイルストアからデータセットに関連付けられたプロファイルデータを削除する必要があります。 これには、Real-Time Customer Profile APIを使用してProfile システムジョブまたは「delete リクエスト」を作成する必要があります。
はじめに
このガイドで使用する API エンドポイントは、Real-Time Customer Profile API の一部です。先に進む前に、はじめる前にを参照し、関連ドキュメントへのリンク、このドキュメントのサンプル API 呼び出しを読み取るためのガイドおよび任意の Experience Platform API を正常に呼び出すために必要なヘッダーに関する重要な情報を確認してください。
削除リクエストの表示 view
削除リクエストは長時間実行される非同期プロセスです。つまり、組織が複数の削除リクエストを一度に実行している場合があります。組織で現在実行中のすべての削除リクエストを表示するには、/system/jobs エンドポイントに対して GET リクエストを実行できます。
また、オプションのクエリーパラメーターを使用して、応答で返される削除リクエストのリストをフィルタリングすることもできます。複数のパラメーターを使用するには、アンパサンド (&)を使用して各パラメーターを分離します。
API 形式
GET /system/jobs
GET /system/jobs?{QUERY_PARAMETERS}
startstart=4limitlimit=10pagepage=2sortasc)または降順(desc)で並べ替えます。複数のページの結果を返す場合、並べ替えパラメーターは機能しません。sort=batchId:ascリクエスト
| accordion | ||
|---|---|---|
| システムジョブを表示するためのサンプルリクエスト。 | ||
|
| note important |
|---|
| IMPORTANT |
このエンドポイントをAWSで使用する場合、では リクエストヘッダーの代わりにx-sandbox-id リクエストヘッダーを使用する必要があります。x-sandbox-name |
| accordion | ||
|---|---|---|
| システムジョブを表示するためのサンプルリクエスト。 | ||
|
応答
応答が成功すると、リクエストの詳細を含む各削除リクエストに対するオブジェクトを持つ「子」配列が含まれます。
| accordion | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 削除要求を表示するための正常な応答 | ||||||||||||||||
|
応答が成功すると、各システムリクエストのオブジェクトを含む配列が返されます。
| accordion | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| システムリクエストを表示するための正常な応答 | ||||||||||||||
|
削除リクエストの作成 create-a-delete-request
新しい削除リクエストの開始は、/systems/jobs エンドポイントへの POST リクエストを通じて行われます。このエンドポイントでは、削除するデータセットまたはバッチの ID がリクエストの本文に表示されます。
データセットと関連プロファイルデータの削除
データセットと、そのデータセットに関連付けられたすべてのプロファイルデータをプロファイルストアから削除するには、データセット IDをPOST リクエストの本文に含める必要があります。 この操作により、特定のデータセットのすべてのデータが削除されます。Experience Platformを使用すると、レコードと時系列の両方のスキーマに基づいてデータセットを削除できます。
API 形式
POST /system/jobs
リクエスト
| accordion | ||
|---|---|---|
| データセットを削除するサンプルリクエスト。 | ||
|
| table 0-row-2 1-row-2 | |
|---|---|
| プロパティ | 説明 |
dataSetId |
削除するデータセットのID。 |
| note important |
|---|
| IMPORTANT |
このエンドポイントをAWSで使用する場合、では リクエストヘッダーの代わりにx-sandbox-id リクエストヘッダーを使用する必要があります。x-sandbox-name |
| accordion | ||
|---|---|---|
| データセットを削除するサンプルリクエスト。 | ||
|
| table 0-row-2 1-row-2 | |
|---|---|
| プロパティ | 説明 |
dataSetId |
削除するデータセットのID。 |
応答
正常な応答は、新しく作成された削除リクエストの詳細を返します。この詳細には、システムで生成された一意の読み取り専用 ID が含まれます。これは、リクエストを検索し、そのステータスを確認するために使用できます。作成時のリクエストの status は、処理が開始されるまで "NEW" です。応答内の dataSetId は、リクエストで送信された dataSetId と一致する必要があります。
| accordion | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 削除リクエストを作成するための応答が成功しました。 | ||||||||||
|
応答が成功すると、新しく作成したシステムリクエストの詳細が返されます。
| accordion | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 削除リクエストを作成するための応答が成功しました。 | ||||||||||||||
|
バッチの削除
バッチを削除するには、バッチ ID を POST リクエストの本文に含める必要があります。レコードスキーマに基づくデータセットのバッチは削除できません。時系列スキーマに基づくデータセットのバッチのみが削除できます。
レコードと時系列動作について詳しくは、の概要のXDM データ動作XDM Systemの節を参照してください。
API 形式
POST /system/jobs
リクエスト
| accordion | ||
|---|---|---|
| バッチを削除するためのサンプルリクエスト。 | ||
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| プロパティ | 説明 |
datasetId |
削除するバッチのデータセットのID。 |
batchId |
削除するバッチのID。 |
| note important |
|---|
| IMPORTANT |
このエンドポイントをAWSで使用する場合、では リクエストヘッダーの代わりにx-sandbox-id リクエストヘッダーを使用する必要があります。x-sandbox-name |
| accordion | ||
|---|---|---|
| バッチを削除するためのサンプルリクエスト。 | ||
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| プロパティ | 説明 |
datasetId |
削除するバッチのデータセットのID。 |
batchId |
削除するバッチのID。 |
応答
正常な応答は、新しく作成された削除リクエストの詳細を返します。この詳細には、システムで生成された一意の読み取り専用 ID が含まれます。これは、リクエストを検索し、そのステータスを確認するために使用できます。作成時のリクエストの "status" は、処理が開始されるまで "NEW" です。応答の"batchId"値は、リクエストで送信された"batchId"値と一致する必要があります。
| accordion | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 削除リクエストを作成するための応答が成功しました。 | ||||||||||||
|
応答が成功すると、新しく作成したシステムリクエストの詳細が返されます。
| accordion | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 削除リクエストを作成するための応答が成功しました。 | ||||||||||||||
|
レコードデータセットバッチの削除リクエストを開始しようとすると、次のような 400 レベルのエラーが発生します。
{
"requestId": "bc4eb29f-63a8-4653-9133-71238884bb81",
"errors": {
"400": [
{
"code": "500",
"message": "Batch can only be specified for EE type 'a294e36d382649dab2cc6ad64a41b674'"
}
]
}
}
特定の削除リクエストの表示 view-a-specific-delete-request
特定の削除リクエスト(ステータスなどの詳細を含む)を表示するには、/system/jobs エンドポイントに対してルックアップ(GET)リクエストを実行し、削除リクエストの ID をパスに含めることができます。
API 形式
GET /system/jobs/{DELETE_REQUEST_ID}
{DELETE_REQUEST_ID}リクエスト
| accordion | ||
|---|---|---|
| プロファイルジョブを表示するためのサンプルリクエスト。 | ||
|
| note important |
|---|
| IMPORTANT |
このエンドポイントをAWSで使用する場合、では リクエストヘッダーの代わりにx-sandbox-id リクエストヘッダーを使用する必要があります。x-sandbox-name |
| accordion | ||
|---|---|---|
| プロファイルジョブを表示するためのサンプルリクエスト。 | ||
|
応答
応答には、更新されたステータスを含む、削除リクエストの詳細が表示されます。応答の削除リクエストのID ("id"値)は、リクエストパスで送信されたIDと一致する必要があります。
| accordion | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 削除リクエストを表示するための応答が成功しました。 | ||||||||||||
|
応答が成功すると、指定したシステムリクエストの詳細が返されます。
| accordion | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 削除リクエストを表示するための応答が成功しました。 | ||||||||||||||
|
削除要求のステータスが"COMPLETED"になると、Data Access APIを使用して削除されたデータにアクセスしようとすることで、データが削除されたことを確認できます。 データアクセス API を使用してデータセットやバッチにアクセスする手順については、データアクセスのドキュメントを参照してください。
削除リクエストの削除
Experience Platformを使用すると、以前のリクエストを削除できます。これは、削除ジョブが完了しなかったか、処理段階で停止した場合など、さまざまな理由で役立つ可能性があります。 削除リクエストを削除するには、/system/jobs エンドポイントに対して DELETE リクエストを実行し、削除する削除リクエストの ID をリクエストパスに含めます。
API 形式
DELETE /system/jobs/{DELETE_REQUEST_ID}
リクエスト
curl -X POST https://platform.adobe.io/data/core/ups/system/jobs/9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
応答
削除リクエストが成功すると、HTTP ステータス 200(OK)と空の応答本文が返されます。GET リクエストを実行して ID で削除リクエストを表示すると、リクエストが削除されたことを確認できます。削除リクエストが削除されたことを示す HTTP ステータス 404(不検知)が返されます。
次の手順
Profile store内のExperience Platformからデータセットとバッチを削除する手順を理解したので、誤って追加されたデータや組織が不要になったデータを安全に削除できます。 削除リクエストは元に戻せないので、今は不要で将来は不要になると確信しているデータのみを削除するようにしてください。