- 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
Commencez à recevoir des notifications concernant les activités du compte. Pour en savoir plus, consultez la section Recevoir des notifications push.
Requête HTTP
POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
userKey or all |
Représente l'ID de profil ou l'adresse e-mail de l'utilisateur pour lesquels les données doivent être filtrées. Il peut s'agir de |
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 moyen supplémentaire de filtrer le récapitulatif d'un rapport à l'aide de l'adresse IP de l'utilisateur dont l'activité est signalée. Cette adresse IP peut refléter ou non la position géographique de l'utilisateur. Il peut s'agir, par exemple, de l'adresse du serveur proxy d'un utilisateur ou de celle d'un réseau privé virtuel (VPN). Ce paramètre est compatible avec les adresses IPv4 et IPv6. |
customerId |
Identifiant unique du client pour lequel extraire 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 est l'heure approximative de la requête API. Un rapport d'API comporte trois concepts de base concernant le temps:
endTime n'est pas spécifié, le rapport renvoie toutes les activités depuis le startTime jusqu'à l'heure actuelle ou les 180 jours les plus récents si startTime remonte à 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 est constituée de tous les événements
Une requête
Remarque:L'API n'accepte pas plusieurs valeurs pour le 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. De plus, si un paramètre non valide est fourni dans la requête API, l'API l'ignore et renvoie la réponse correspondant aux paramètres valides restants. Si aucun paramètre n'est demandé, tous les paramètres sont renvoyés. |
maxResults |
Détermine le nombre d'enregistrements d'activité à afficher sur chaque page de réponse. Par exemple, si la demande définit |
orgUnitID |
ID de l'unité organisationnelle à inclure dans le rapport. Les enregistrements d'activité ne sont affichés que pour les utilisateurs appartenant à l'unité organisationnelle spécifiée. |
pageToken |
Jeton permettant de 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 du |
groupIdFilter |
ID des groupes (obscurcis) séparés par une virgule sur lesquels les activités de l'utilisateur sont filtrées. La réponse ne contiendra alors les activités que pour les utilisateurs faisant partie d'au moins l'un des identifiants de groupe mentionnés ici. Format: "id:abc123,id:xyz456" |
Corps de la requête
Le corps de la requête contient une instance SubscriptionChannel
.
Corps de la réponse
Canal de notification utilisé pour surveiller les modifications des ressources.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string } |
Champs | |
---|---|
id |
UUID ou chaîne unique similaire identifiant ce canal. |
token |
Chaîne arbitraire transmise à l'adresse cible avec chaque notification transmise sur ce canal. Facultatif. |
expiration |
Date et heure d'expiration du canal de notification, exprimées en horodatage Unix, en millisecondes. Facultatif. |
type |
Type de mécanisme de diffusion utilisé pour ce canal. La valeur doit être définie sur |
address |
Adresse à laquelle les notifications sont envoyées pour cette chaîne. |
payload |
Valeur booléenne indiquant si la charge utile est souhaitée. Une charge utile est une donnée envoyée dans le corps d’un message HTTP POST, PUT ou PATCH qui contient des informations importantes sur la requête. Facultatif. |
params |
Paramètres supplémentaires contrôlant le comportement des canaux de diffusion. Facultatif. Objet contenant une liste de paires |
resourceId |
ID opaque qui identifie la ressource surveillée sur ce canal. Stable dans différentes versions de l'API. |
resourceUri |
Identifiant spécifique à la version pour la ressource surveillée. |
kind |
Identifie ceci comme un canal de notification utilisé pour surveiller les modifications apportées à une ressource, qui est " |
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
Nom de l'application pour laquelle les événements doivent être récupérés.
Enums | |
---|---|
access_transparency |
Les rapports d'activité Access Transparency de Google Workspace renvoient des informations sur les différents types d'événements liés aux activités Access Transparency. |
admin |
Les rapports d'activité de l'application de la console d'administration affichent des informations sur le compte concernant les différents types d'événements liés aux activités de l'administrateur. |
calendar |
Les rapports d'activité de l'application Google Agenda renvoient des informations sur différents événements d'activité de Google Agenda. |
chat |
Les rapports d'activité Chat contiennent des informations sur divers événements d'activité Chat. |
drive |
Les rapports d'activité de l'application Google Drive renvoient des informations sur divers événements d'activité Google Drive. Le rapport d'activité Drive n'est disponible que pour les clients Google Workspace Business et Google Workspace Enterprise. |
gcp |
Les rapports d'activité de l'application Google Cloud Platform renvoient des informations sur différents é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é Groupes. |
groups_enterprise |
Les rapports d'activité des groupes d'entreprise contiennent des informations sur différents événements d'activité des groupes d'entreprise. |
jamboard |
Les rapports d'activité Jamboard renvoient des informations sur divers événements liés à l'activité Jamboard. |
login |
Les rapports d'activité de l'application Login renvoient des informations sur le compte concernant les différents types d'événements liés à l'activité de connexion. |
meet |
Le rapport d'activité d'audit Meet renvoie des informations sur les différents types d'événements d'audit Meet. |
mobile |
Le rapport "Activité d'audit des appareils" renvoie des informations sur les différents types d'événements d'audit des appareils. |
rules |
Le rapport sur l'activité des règles renvoie des informations sur les différents types d'événements liés à l'activité des 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 d'activité de l'application de jetons renvoient des informations sur le compte concernant 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 sur l'activité de l'accès contextuel renvoient des informations sur les événements d'accès refusé des utilisateurs en raison des règles d'accès contextuel. |
chrome |
Les rapports d'activité Chrome fournissent des informations sur les événements liés au navigateur Chrome et à Chrome OS. |
data_studio |
Les rapports d'activité Data Studio renvoient des informations sur différents types d'événements d'activité Data Studio. |
keep |
Les rapports d'activité de l'application Keep renvoient des informations sur différents événements d'activité Google Keep. Le rapport d'activité Keep n'est disponible que pour les clients Google Workspace Business et Google Workspace Enterprise. |