監査クエリ APIの概要
Adobe Experience Platformでは、監査イベントログの形式で、さまざまなサービスと機能に対するユーザーアクティビティを監査できます。 ログに記録される各アクションには、アクションのタイプ、日時、アクションを実行したユーザーの電子メール ID、アクションのタイプに関連する追加の属性を示すメタデータが含まれます。
監査クエリ APIを使用すると、監査イベントログの形式で、さまざまなサービスと機能に対するユーザーアクティビティを監査できます。 このドキュメントでは、監査クエリ APIを呼び出す前に知っておく必要があるコアコンセプトについて説明します。
前提条件
監査イベントを管理するには、ユーザーアクティビティログの表示 アクセス制御権限が付与されている必要があります( データガバナンス カテゴリにあります)。 Experience Platform機能の個別の権限を管理する方法については、 アクセス制御ドキュメント を参照してください。
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}
Experience Platform のすべてのリソースは、特定の仮想サンドボックスに分離されています。 Experience Platform APIへのすべてのリクエストには、操作を実行するサンドボックスの名前を指定するヘッダーが必要です。 Experience Platform のサンドボックスについて詳しくは、サンドボックスの概要に関するドキュメントを参照してください。
x-sandbox-name: {SANDBOX_NAME}
ペイロード(POST、PUT、PATCH)を含むすべてのリクエストには、次の追加のヘッダーが必要です。
- Content-Type: application/json
次の手順
Audit Query APIを使用して呼び出しを開始するには、 イベントエンドポイントガイド および エクスポートエンドポイントガイド を参照してください。