Représente l'ID de profil ou l'adresse e-mail de l'utilisateur pour lequel les données doivent être filtrées. Peut être all pour toutes les informations ou userKey pour l'ID de profil Google Workspace unique ou l'adresse e-mail principale d'un utilisateur. Ne doit pas s'agir d'un utilisateur supprimé. Pour un utilisateur supprimé, appelez users.list dans l'API Directory avec showDeleted=true, puis utilisez le ID renvoyé comme userKey.
date
string
Représente la date à laquelle l'utilisation a eu lieu, en fonction de l'heure UTC-8:00 (heure normale du Pacifique). Le code temporel est au format ISO 8601, yyyy-mm-dd.
Paramètres de requête
Paramètres
customerId
string
Identifiant unique du client pour lequel vous souhaitez récupérer des données.
filters
string
La chaîne de requête filters est une liste de paramètres d'événement d'une application séparés par une virgule, où la valeur du paramètre est manipulée par un opérateur relationnel. La chaîne de requête filters inclut le nom de l'application dont l'utilisation est renvoyée dans le rapport. Les valeurs d'application pour le rapport sur l'utilisation des utilisateurs incluent accounts, chat, docs et gmail.
Les filtres sont au format [application name]:[parameter
name][relational operator][parameter value],....
Dans cet exemple, l'opérateur <> "n'est pas égal à" est encodé en URL dans la chaîne de requête de la requête (%3C%3E):
GET
https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time
&filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z
Les opérateurs relationnels incluent les suivants:
== : "égal à".
<> : "différent de". Il est encodé au format URL (%3C%3E).
< : "inférieur à". Il est encodé au format URL (%3C).
<= : "inférieur ou égal à". Il est encodé au format URL (%3C=).
> : "supérieur à". Il est encodé au format URL (%3E).
>= : "supérieur ou égal à". Il est encodé au format URL (%3E=).
Détermine le nombre d'enregistrements d'activité affichés sur chaque page de réponse. Par exemple, si la requête définit maxResults=1 et que le rapport comporte deux activités, le rapport comporte deux pages. La propriété nextPageToken de la réponse contient le jeton de la deuxième page. La chaîne de requête maxResults est facultative.
orgUnitID
string
ID de l'unité organisationnelle à inclure dans le rapport. L'activité des utilisateurs ne s'affiche que pour les utilisateurs appartenant à l'unité organisationnelle spécifiée.
pageToken
string
Jeton permettant de spécifier la page suivante. Un rapport comportant plusieurs pages contient une propriété nextPageToken dans la réponse. Dans la requête de suivi permettant d'obtenir la page suivante du rapport, saisissez la valeur nextPageToken dans la chaîne de requête pageToken.
parameters
string
La chaîne de requête parameters est une liste de paramètres d'événement séparés par des virgules qui affinent les résultats d'un rapport. Le paramètre est associé à une application spécifique. Les valeurs d'application du rapport "Utilisation par les clients" incluent accounts, app_maker, apps_scripts, calendar, chat, classroom, cros, docs, gmail, gplus, device_management, meet et sites. Une chaîne de requête parameters se présente au format CSV sous la forme app_name1:param_name1, app_name2:param_name2.
groupIdFilter
string
ID de groupe (masqués) sur lesquels les activités des utilisateurs sont filtrées, c'est-à-dire que la réponse ne contiendra que les activités des utilisateurs appartenant à au moins l'un des ID 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
Si la requête aboutit, le corps de la réponse contient une instance de UsageReports.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2026/03/09 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2026/03/09 (UTC)."],[],[]]