- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- ApplicationName
- Activité <ph type="x-smartling-placeholder">
- Essayer
Récupère la liste des activités liées au compte et à l'application d'un client spécifique, telles que les applications de la console d'administration ou de Google Drive. Pour en savoir plus, consultez les guides sur les rapports d'activité pour les administrateurs et Google Drive. Pour en savoir plus sur les paramètres du rapport d'activité, consultez les guides de référence sur les paramètres d'activité.
Requête HTTP
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
userKey or all |
Représente l'ID du profil ou l'adresse e-mail de l'utilisateur pour lequel les données doivent être filtrées. Peut être |
applicationName |
Nom de l'application pour laquelle les événements doivent être récupérés. |
Paramètres de requête
Paramètres | |
---|---|
actorIpAddress |
Adresse IP (Internet Protocol) de l'hôte où l'événement s'est produit. Il s'agit d'un autre moyen de filtrer la synthèse d'un rapport à l'aide de l'adresse IP de l'utilisateur dont l'activité est signalée. Cette adresse IP peut ou non refléter la position géographique de l'utilisateur. Par exemple, l'adresse IP peut être l'adresse du serveur proxy de l'utilisateur ou celle d'un réseau privé virtuel (VPN). Ce paramètre est compatible avec les versions d'adresses IPv4 et IPv6. |
customerId |
Identifiant unique du client pour lequel récupérer les données. |
endTime |
Définit la fin de la période affichée dans le rapport. La date est au format RFC 3339, par exemple 2010-10-28T10:26:35.000Z. La valeur par défaut correspond à l'heure approximative de la requête API. Un rapport d'API comporte trois concepts de temps de base:
endTime n'est pas spécifié, le rapport renvoie toutes les activités depuis le startTime jusqu'à l'heure actuelle, ou les 180 derniers jours si la startTime date de plus de 180 jours.
|
eventName |
Nom de l'événement interrogé par l'API. Chaque |
filters |
La chaîne de requête Ces paramètres d'événement sont associés à un Dans les exemples d'activités Drive suivants, la liste renvoyée comprend tous les événements
Une requête
Remarque:L'API n'accepte pas plusieurs valeurs du même paramètre. Si un paramètre est fourni plusieurs fois dans la requête API, l'API n'accepte que la dernière valeur de ce paramètre. En outre, si un paramètre non valide est fourni dans la requête API, l'API ignore ce paramètre et renvoie la réponse correspondant aux autres paramètres valides. Si aucun paramètre n'est demandé, tous les paramètres sont renvoyés. |
maxResults |
Détermine le nombre d'enregistrements d'activité affichés sur chaque page de réponse. Par exemple, si la demande définit |
orgUnitID |
ID de l'unité organisationnelle concernée par le rapport. Les enregistrements d'activité ne seront affichés que pour les utilisateurs appartenant à l'unité organisationnelle spécifiée. |
pageToken |
Jeton pour spécifier la page suivante. Un rapport comportant plusieurs pages comporte une propriété |
startTime |
Définit le début de la période affichée dans le rapport. La date est au format RFC 3339, par exemple 2010-10-28T10:26:35.000Z. Le rapport renvoie toutes les activités entre le |
groupIdFilter |
ID de groupe séparés par une virgule (obscurcis) sur lesquels les activités des utilisateurs sont filtrées. Par exemple, la réponse ne contiendra que les activités des utilisateurs qui font partie d'au moins un des identifiants de groupe mentionnés ici. Format : "id:abc123,id:xyz456" |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Modèle JSON pour une collection d'activités.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
Champs | |
---|---|
kind |
Type de ressource d'API. Pour un rapport d'activité, la valeur est |
etag |
ETag de la ressource. |
items[] |
Chaque enregistrement d'activité dans la réponse. |
nextPageToken |
Jeton permettant de récupérer la page suivante du rapport. La valeur |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/admin.reports.audit.readonly
Pour en savoir plus, consultez le Guide relatif aux autorisations.
ApplicationName
Enums | |
---|---|
access_transparency |
Les rapports d'activité Access Transparency de Google Workspace renvoient des informations sur les différents types d'événements d'activité Access Transparency. |
admin |
Les rapports d'activité de l'application de la console d'administration renvoient des informations de compte relatives aux différents types d'événements liés aux activités d'administration. |
calendar |
Les rapports d'activité de l'application Google Agenda renvoient des informations sur divers événements d'activité dans Google Agenda. |
chat |
Les rapports "Activité Chat" renvoient des informations sur divers événements d'activité Chat. |
drive |
Les rapports d'activité de l'application Google Drive contiennent des informations sur divers événements d'activité Google Drive. Le rapport sur l'activité Drive n'est disponible que pour les clients Google Workspace Business et Enterprise. |
gcp |
Les rapports d'activité de l'application Google Cloud Platform renvoient des informations sur divers événements d'activité GCP. |
gplus |
Les rapports d'activité de l'application Google+ renvoient des informations sur divers événements d'activité Google+. |
groups |
Les rapports d'activité de l'application Google Groupes renvoient des informations sur divers événements d'activité Google Groupes. |
groups_enterprise |
Les rapports sur l'activité des groupes Enterprise renvoient des informations sur divers événements d'activité des groupes d'entreprise. |
jamboard |
Les rapports sur l'activité Jamboard renvoient des informations sur divers événements d'activité Jamboard. |
login |
Les rapports d'activité de l'application de connexion renvoient des informations de compte relatives à différents types d'événements de connexion. |
meet |
Le rapport sur les activités d'audit Meet contient des informations sur les différents types d'événements d'audit Meet. |
mobile |
Le rapport "Activité d'audit des appareils" contient des informations sur les différents types d'événements liés à l'audit des appareils. |
rules |
Le rapport "Activité liée aux règles" affiche des informations sur les différents types d'événements liés aux règles. |
saml |
Le rapport d'activité SAML renvoie des informations sur les différents types d'événements d'activité SAML. |
token |
Les rapports "Activité des jetons" renvoient des informations de compte sur les différents types d'événements liés à l'activité des jetons. |
user_accounts |
Les rapports d'activité de l'application Comptes utilisateur renvoient des informations sur les différents types d'événements liés à l'activité des comptes utilisateur. |
context_aware_access |
Les rapports d'activité d'accès contextuel renvoient des informations sur l'état Accès refusé en raison des règles d'accès contextuel |
chrome |
Les rapports d'activité Chrome renvoient des informations sur les événements du navigateur Chrome et de Chrome OS. |
data_studio |
Les rapports sur l'activité Data Studio renvoient des informations sur les différents types d'événements Data Studio. |
keep |
Les rapports d'activité de l'application Keep contiennent des informations sur divers événements d'activité Google Keep. Le rapport sur l'activité Keep est uniquement disponible pour les clients Google Workspace Business et Enterprise. |
vault |
Les rapports sur l'activité Vault renvoient des informations sur les différents types d'événements d'activité Vault. |
Activité
Modèle JSON pour la ressource d'activité.
Représentation JSON |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
Champs | |
---|---|
kind |
Type de ressource d'API. Pour un rapport d'activité, la valeur est |
etag |
ETag de l'entrée. |
ownerDomain |
Il s'agit du domaine concerné par l'événement du rapport. (par exemple, le domaine de la console d'administration ou le propriétaire des documents de l'application Drive). |
ipAddress |
Adresse IP de l'utilisateur effectuant l'action. Il s'agit de l'adresse IP (Internet Protocol) de l'utilisateur lorsqu'il se connecte à Google Workspace, qui peut ou non correspondre à sa position géographique. Par exemple, l'adresse IP peut être l'adresse du serveur proxy de l'utilisateur ou celle d'un réseau privé virtuel (VPN). L'API est compatible avec IPv4 et IPv6. |
events[] |
Événements d'activité dans le rapport. |
events[].type |
Type d'événement. La fonctionnalité ou le service Google Workspace modifié par un administrateur est identifié dans la propriété |
events[].name |
Nom de l'événement. Il s'agit du nom spécifique de l'activité signalée par l'API. Chaque
Pour en savoir plus sur les propriétés eventName , consultez la liste des noms d'événements pour différentes applications ci-dessus dans applicationName .
|
events[].parameters[] |
Paires valeur/paramètre pour diverses applications. Pour en savoir plus sur les paramètres |
events[].parameters[].messageValue |
Paires de valeurs de paramètres imbriquées associées à ce paramètre. Un type de valeur complexe pour un paramètre est renvoyé sous la forme d'une liste de valeurs de paramètres. Par exemple, le paramètre d'adresse peut avoir la valeur |
events[].parameters[].messageValue.parameter[] |
Valeurs de paramètres |
events[].parameters[].name |
Nom du paramètre. |
events[].parameters[].value |
Valeur de chaîne du paramètre. |
events[].parameters[].multiValue[] |
Valeurs de chaîne du paramètre. |
events[].parameters[].intValue |
Valeur entière du paramètre. |
events[].parameters[].multiIntValue[] |
Valeurs entières du paramètre. |
events[].parameters[].boolValue |
Valeur booléenne du paramètre. |
events[].parameters[].multiMessageValue[] |
activités.list de |
events[].parameters[].multiMessageValue[].parameter[] |
Valeurs de paramètres |
id |
Identifiant unique pour chaque enregistrement d'activité. |
id.time |
Heure à laquelle l'activité s'est produite. Elle correspond à l'epoch UNIX, exprimée en secondes. |
id.uniqueQualifier |
Qualificatif unique si plusieurs événements ont la même heure. |
id.applicationName |
Nom de l'application à laquelle appartient l'événement. Pour connaître les valeurs possibles, consultez la liste des applications ci-dessus dans |
id.customerId |
Identifiant unique d'un compte Google Workspace. |
actor |
Utilisateur effectuant l'action. |
actor.profileId |
ID de profil Google Workspace unique de l'acteur. Cette valeur peut être absente si l'acteur n'est pas un utilisateur Google Workspace, ou il peut s'agir du numéro 105250506097979753968, qui sert d'ID d'espace réservé. |
actor.email |
Adresse e-mail principale de l'acteur. Peut être absente si aucune adresse e-mail n'est associée à l'acteur. |
actor.callerType |
Type d'acteur. |
actor.key |
Présent uniquement lorsque |