プロファイルシステムジョブエンドポイント(削除リクエスト)
Adobe Experience Platform を使用すると、複数のソースからデータを取得し、個々の顧客に対して堅牢なプロファイルを構築できます。Platform に取り込まれたデータは Data Lake に格納されます。データセットがプロファイルに対して有効になっている場合、そのデータは Real-Time Customer Profile データストアにも格納されます。 不要になったデータやエラーで追加されたデータを削除するには、プロファイルストアからデータセットに関連付けられたプロファイルデータを削除する必要が生じる場合があります。 これには、Real-Time Customer Profile API を使用して、必要に応じて変更、監視、削除できる Profile システムジョブ(delete request
)を作成する必要があります。
はじめに
このガイドで使用する API エンドポイントは、Real-Time Customer Profile API の一部です。先に進む前に、はじめる前にを参照し、関連ドキュメントへのリンク、このドキュメントのサンプル API 呼び出しを読み取るためのガイドおよび任意の Experience Platform API を正常に呼び出すために必要なヘッダーに関する重要な情報を確認してください。
削除リクエストの表示
削除リクエストは長時間実行される非同期プロセスです。つまり、組織が複数の削除リクエストを一度に実行している場合があります。組織で現在実行中のすべての削除リクエストを表示するには、/system/jobs
エンドポイントに対して GET リクエストを実行できます。
また、オプションのクエリーパラメーターを使用して、応答で返される削除リクエストのリストをフィルタリングすることもできます。複数のパラメーターを使用するには、アンパサンド(&
)を使用して各パラメーターを区切ります。
API 形式
GET /system/jobs
GET /system/jobs?{QUERY_PARAMETERS}
start
start=4
limit
limit=10
page
page=2
sort
asc
)または降順(desc
)で並べ替えます。結果の複数ページを返す場合、並べ替えパラメーターは機能しません。例:sort=batchId:asc
リクエスト
curl -X GET \
https://platform.adobe.io/data/core/ups/system/jobs \
-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}' \
応答
応答には、各削除リクエストのオブジェクトを持つ「子」配列が含まれ、そのリクエストの詳細が含まれます。
{
"_page": {
"count": 100,
"next": "K1JJRDpFaWc5QUwyZFgtMEpBQUFBQUFBQUFBPT0jUlQ6MSNUUkM6MiNGUEM6QWdFQUFBQVFBQWZBQUg0Ly9yL25PcmpmZndEZUR3QT0="
},
"children": [
{
"id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
"imsOrgId": "{ORG_ID}",
"batchId": "8d075b5a178e48389126b9289dcfd0ac",
"jobType": "DELETE",
"status": "COMPLETED",
"metrics": "{\"recordsProcessed\":5,\"timeTakenInSec\":1}",
"createEpoch": 1559026134,
"updateEpoch": 1559026137
},
{
"id": "3f225e7e-ac8c-4904-b1d5-0ce79e03c2ec",
"imsOrgId": "{ORG_ID}",
"dataSetId": "5c802d3cd83fc114b741c4b5",
"jobType": "DELETE",
"status": "PROCESSING",
"metrics": "{\"recordsProcessed\":0,\"timeTakenInSec\":15}",
"createEpoch": 1559025404,
"updateEpoch": 1559025406
}
]
}
_page.count
_page.next
"next"
値に置き換えて、結果の次のページを表示します。jobType
"DELETE"
が返されます。status
"NEW"
、"PROCESSING"
、"COMPLETED"
、"ERROR"
です。metrics
"recordsProcessed"
)、リクエストが処理された時間(秒)、またはリクエストが完了するまでにかかった時間("timeTakenInSec"
)を含むオブジェクト。削除リクエストの作成 create-a-delete-request
新しい削除リクエストの開始は、/systems/jobs
エンドポイントへの POST リクエストを通じて行われます。このエンドポイントでは、削除するデータセットまたはバッチの ID がリクエストの本文に表示されます。
データセットおよび関連するプロファイルデータの削除
データセットとそれに関連付けられたすべてのプロファイルデータをプロファイルストアから削除するには、データセット ID をPOSTリクエストの本文に含める必要があります。 この操作により、特定のデータセットのすべてのデータが削除されます。レコ Experience Platform ドと時系列の両方のスキーマに基づいてデータセットを削除できます。
API 形式
POST /system/jobs
リクエスト
curl -X POST \
https://platform.adobe.io/data/core/ups/system/jobs \
-H 'Content-Type: application/json' \
-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}' \
-d '{
"dataSetId": "5c802d3cd83fc114b741c4b5"
}'
dataSetId
応答
正常な応答は、新しく作成された削除リクエストの詳細を返します。この詳細には、システムで生成された一意の読み取り専用 ID が含まれます。これは、リクエストを検索し、そのステータスを確認するために使用できます。作成時のリクエストの status
は、処理が開始されるまで "NEW"
です。応答内の dataSetId
は、リクエストで送信された dataSetId
と一致する必要があります。
{
"id": "3f225e7e-ac8c-4904-b1d5-0ce79e03c2ec",
"imsOrgId": "{ORG_ID}",
"dataSetId": "5c802d3cd83fc114b741c4b5",
"jobType": "DELETE",
"status": "NEW",
"createEpoch": 1559025404,
"updateEpoch": 1559025406
}
id
dataSetId
バッチの削除
バッチを削除するには、バッチ ID を POST リクエストの本文に含める必要があります。レコードスキーマに基づくデータセットのバッチは削除できません。時系列スキーマに基づくデータセットのバッチのみが削除できます。
レコードと時系列の動作について詳しくは、XDM System の概要の XDM データの動作に関する節を参照してください。
API 形式
POST /system/jobs
リクエスト
curl -X POST \
https://platform.adobe.io/data/core/ups/system/jobs \
-H 'Content-Type: application/json' \
-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}' \
-d '{
"batchId": "8d075b5a178e48389126b9289dcfd0ac"
}'
batchId
応答
正常な応答は、新しく作成された削除リクエストの詳細を返します。この詳細には、システムで生成された一意の読み取り専用 ID が含まれます。これは、リクエストを検索し、そのステータスを確認するために使用できます。作成時のリクエストの "status"
は、処理が開始されるまで "NEW"
です。応答の "batchId"
値は、リクエストで送信された "batchId"
値と一致する必要があります。
{
"id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
"imsOrgId": "{ORG_ID}",
"batchId": "8d075b5a178e48389126b9289dcfd0ac",
"jobType": "DELETE",
"status": "NEW",
"createEpoch": 1559026131,
"updateEpoch": 1559026132
}
id
batchId
レコードデータセットバッチの削除リクエストを開始しようとすると、次のような 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}
リクエスト
curl -X GET \
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}' \
応答
応答には、更新されたステータスを含む、削除リクエストの詳細が表示されます。応答内の削除リクエストの ID ("id"
値)は、リクエストパスで送信された ID と一致する必要があります。
{
"id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
"imsOrgId": "{ORG_ID}",
"batchId": "8d075b5a178e48389126b9289dcfd0ac",
"jobType": "DELETE",
"status": "COMPLETED",
"metrics": "{\"recordsProcessed\":5,\"timeTakenInSec\":1}",
"createEpoch": 1559026134,
"updateEpoch": 1559026137
}
jobType
"DELETE"
を返します。status
"NEW"
、"PROCESSING"
、"COMPLETED"
、"ERROR"
。metrics
"recordsProcessed"
)、リクエストが処理された時間(秒)、またはリクエストが完了するまでにかかった時間("timeTakenInSec"
)を含む配列。削除リクエストステータスが "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(不検知)が返されます。
次の手順
Experience Platform 内の Profile store からデータセットとバッチを削除する手順がわかったので、誤って追加されたデータや、組織が必要としなくなったデータを安全に削除できます。 削除リクエストは元に戻せないので、今は不要で将来は不要になると確信しているデータのみを削除するようにしてください。