Les journaux d’audit permettent de fournir des détails sur l’activité des utilisateurs pour divers services et fonctionnalités. Chaque action enregistrée dans un journal contient des métadonnées qui indiquent le type d’action, la date et l’heure, l’ID d’e-mail de l’utilisateur ou de l’utilisatrice qui a exécuté l’action et des attributs supplémentaires liés au type d’action. Le /audit/events du point de terminaison Audit Query L’API vous permet de récupérer par programmation les données d’événement pour l’activité de votre entreprise dans Platform.
Prise en main
Le point d’entrée dʼAPI utilisé dans ce guide fait partie de lʼ Audit Query API. Avant de continuer, consultez le guide de prise en main pour obtenir des liens vers la documentation associée, un guide de lecture des exemples dʼappels API dans ce document et des informations importantes sur les en-têtes requis pour réussir des appels à nʼimporte quel API dʼExperience Platform.
Liste des événements de contrôle
Vous pouvez récupérer des données d’événements en envoyant une requête de GET à la variable /audit/events point de terminaison , en spécifiant les événements que vous souhaitez récupérer dans la payload.
Format d’API
GET /audit/events
Le Audit Query L’API prend en charge l’utilisation de paramètres de requête pour la page et le filtrage des résultats lors de la liste d’événements.
Paramètre
Description
limit
Nombre maximal d’enregistrements à renvoyer dans la réponse. La valeur par défaut limit est de 50.
start
Pointeur vers le premier élément pour les résultats de recherche renvoyés. Pour accéder à la page de résultats suivante, ce paramètre doit être incrémenté de la même quantité que celle indiquée par la limite. Exemple : Pour accéder à la page de résultats suivante pour une requête avec limit=50, utilisez le paramètre start=50, puis start=100 pour la page suivante, et ainsi de suite.
queryId
Lors de l’exécution d’une requête sur le point de terminaison /audit/events, la réponse inclut une propriété de chaîne queryId. Pour effectuer la même requête dans un appel distinct, vous pouvez inclure la valeur Id comme paramètre de requête unique au lieu de reconfigurer manuellement les paramètres de recherche.
Tableau dont les objets représentent chacun des événements spécifiés dans la requête. Chaque objet contient des informations sur la configuration du filtre et les données d’événement renvoyées.
userEmail
Adresse électronique de l’utilisateur qui a exécuté l’événement.
eventType
Type d’événement. Les types d’événements incluent : Core et Enhanced.
imsOrgId
ID de l’organisation sous laquelle l’événement a eu lieu.
permissionResource
Le produit ou la fonctionnalité qui a fourni l’autorisation effectue l’action. Une ressource peut être l’une des ressources suivantes :
Activation
ActivationAssociation
AnalyticSource
AudienceManagerSource
BizibleSource
CustomerAttributeSource
Dataset
EnterpriseSource
LaunchSource
MarketoSource
ProductProfile
ProfileConfig
Sandbox
Schema
Segment
StreamingSource
permissionType
Type d’autorisation associé à l’action.
assetType
Type de ressource Platform sur laquelle l’action a été effectuée.
assetId
Identifiant unique de la ressource Platform sur laquelle l’action a été effectuée.
assetName
Nom de la ressource Platform sur laquelle l’action a été effectuée.
action
Type d’action enregistrée pour l’événement. Une action peut être l’une des suivantes :
Add
Create
Dataset activate
Dataset remove
Delete
Disable for profile
Enable
Enable for profile
Profile activate
Profile remove
remove
reset
segment activate
segment remove
update
status
État de l’action. Un état peut être l’un des suivants :
