Method: activities.list

Récupère la liste des activités pour un compte et une application client spécifiques, comme la console d'administration ou Google Drive. Pour en savoir plus, consultez les guides sur les rapports d'activité des administrateurs et de Google Drive. Pour en savoir plus sur les paramètres du rapport sur l'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

string

Représente l'ID du profil ou l'adresse e-mail de l'utilisateur pour lesquels les données doivent être filtrées. Peut être all pour toutes les informations, ou userKey pour l'ID de profil Google Workspace unique d'un utilisateur ou son adresse e-mail principale. L'utilisateur ne doit pas avoir été supprimé. Pour un utilisateur supprimé, appelez users.list dans l'API Directory avec showDeleted=true, puis utilisez le ID renvoyé comme userKey.
applicationName

enum (ApplicationName)

Nom de l'application pour laquelle les événements doivent être récupérés.

Paramètres de requête

Paramètres
actorIpAddress

string

Adresse IP de l'hôte sur lequel l'événement a été effectué. 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 ou non refléter l'emplacement physique de l'utilisateur. Par exemple, l'adresse IP peut être celle du serveur proxy de l'utilisateur ou celle d'un réseau privé virtuel (VPN). Ce paramètre est compatible avec les versions d'adresse IPv4 et IPv6.
customerId

string

Identifiant unique du client pour lequel récupérer les données.
endTime

string

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 temporels de base :

  • Date de la demande de rapport de l'API : date à laquelle l'API a créé et récupéré le rapport.
  • Heure de début du rapport : début de la période affichée dans le rapport. Le startTime doit être antérieur au endTime (le cas échéant) et à l'heure actuelle au moment de l'envoi de la requête. Sinon, l'API renvoie une erreur.
  • Heure de fin du rapport : fin de la période affichée dans le rapport. Par exemple, la période des événements récapitulés dans un rapport peut commencer en avril et se terminer en mai. Le rapport lui-même peut être demandé en août.
 Si endTime n'est pas spécifié, le rapport renvoie toutes les activités à partir de startTime jusqu'à l'heure actuelle ou les 180 derniers jours si startTime remonte à plus de 180 jours.

 Pour les demandes Gmail, startTime et endTime doivent être fournis, et la différence ne doit pas être supérieure à 30 jours.
eventName

string

Nom de l'événement interrogé par l'API. Chaque eventName est associé à un service ou une fonctionnalité Google Workspace spécifiques, que l'API organise en types d'événements. Par exemple, les événements Google Agenda dans les rapports de l'application de la console d'administration. La structure type des paramètres d'agenda contient toutes les activités eventName de l'agenda signalées par l'API. Lorsqu'un administrateur modifie un paramètre Agenda, l'API signale cette activité dans les paramètres Agenda type et eventName. Pour en savoir plus sur les chaînes de requête et les paramètres eventName, consultez la liste des noms d'événements pour différentes applications ci-dessus dans applicationName.
filters

string

La chaîne de requête filters est une liste séparée par des virgules, composée de paramètres d'événement manipulés par des opérateurs relationnels. Les paramètres d'événement sont au format {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},....

Ces paramètres d'événement sont associés à un eventName spécifique. Un rapport vide est renvoyé si le paramètre de la requête n'appartient pas à eventName. Pour en savoir plus sur les champs eventName disponibles pour chaque application et leurs paramètres associés, accédez au tableau ApplicationName, puis cliquez sur la page "Événements d'activité" dans l'annexe de l'application de votre choix.

Dans les exemples d'activité Drive suivants, la liste renvoyée se compose de tous les événements edit où la valeur du paramètre doc_id correspond aux conditions définies par l'opérateur relationnel. Dans le premier exemple, la requête renvoie tous les documents modifiés dont la valeur doc_id est égale à 12345. Dans le deuxième exemple, le rapport renvoie tous les documents modifiés dont la valeur doc_id n'est pas égale à 98765. L'opérateur <> est encodé au format URL dans la chaîne de requête de la requête (%3C%3E) :

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Une requête filters est compatible avec les opérateurs relationnels suivants :

  • == : "égal à".
  • <> : "différent de". Doit être encodé au format URL (%3C%3E).
  • < : "inférieur à". Doit être encodé au format URL (%3C).
  • <= : "inférieur ou égal à". Doit être encodé au format URL (%3C=).
  • > : "supérieur à". Doit être encodé au format URL (%3E).
  • >= : "supérieur ou égal à". Doit être encodé au format URL (%3E=).

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

integer

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, il 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 dans la requête. La valeur par défaut est 1 000.
orgUnitID

string

ID de l'unité organisationnelle sur laquelle générer le rapport. Les journaux d'activité ne s'affichent 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 possède une propriété nextPageToken dans la réponse. Dans votre demande de récupération de la page suivante du rapport, saisissez la valeur nextPageToken dans la chaîne de requête pageToken.
startTime

string

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 startTime et endTime. Le startTime doit être antérieur au endTime (le cas échéant) et à l'heure actuelle au moment de l'envoi de la requête. Sinon, l'API renvoie une erreur.

 Pour les demandes Gmail, startTime et endTime doivent être fournis, et la différence ne doit pas être supérieure à 30 jours.
groupIdFilter

string

ID de groupe (masqués) séparés par une virgule sur lesquels les activités des utilisateurs sont filtrées. Autrement dit, la réponse ne contiendra que les activités des utilisateurs qui font partie d'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

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 (Activity)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Type de ressource d'API. Pour un rapport sur l'activité, la valeur est reports#activities.
etag

string

ETag de la ressource.
items[]

object (Activity)

Chaque enregistrement d'activité dans la réponse.
nextPageToken

string

Jeton permettant de récupérer la page suivante du rapport. La valeur nextPageToken est utilisée dans la chaîne de requête pageToken de la requête.

Niveaux d'accès des autorisations

Requiert l'habilitation OAuth suivante :

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Pour en savoir plus, consultez le guide d'autorisation.

ApplicationName

Enums
access_transparency

Les rapports sur les activités Access Transparency de Google Workspace fournissent des informations sur 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 renvoient des informations sur les comptes pour différents types d'événements d'activité des administrateurs.
calendar

Les rapports d'activité de l'application Google Agenda fournissent des informations sur différents événements d'activité Agenda.
chat Les rapports sur l'activité Chat fournissent des informations sur différents événements d'activité Chat.
drive

Les rapports d'activité de l'application Google Drive fournissent des informations sur différents événements d'activité Google Drive. Le rapport sur l'activité dans Drive n'est disponible que pour les clients Google Workspace Business et Enterprise.
gcp Les rapports sur l'activité de l'application Google Cloud Platform fournissent des informations sur divers événements d'activité GCP.
gmail Les rapports d'activité de l'application Gmail fournissent des informations sur différents événements d'activité Gmail.
gplus Les rapports d'activité de l'application Google+ renvoient des informations sur différents événements d'activité Google+.
groups

Les rapports d'activité de l'application Google Groupes renvoient des informations sur différents événements d'activité des groupes.
groups_enterprise

Les rapports sur l'activité des groupes Enterprise fournissent des informations sur différents événements d'activité des groupes Enterprise.
jamboard Les rapports sur l'activité Jamboard fournissent des informations sur différents événements d'activité Jamboard.
login

Les rapports d'activité de l'application de connexion renvoient des informations de compte sur différents types d'événements d'activité de connexion.
meet Le rapport sur l'activité d'audit Meet renvoie des informations sur différents types d'événements d'activité d'audit Meet.
mobile Le rapport d'activité "Audit des appareils" fournit des informations sur différents types d'événements d'activité d'audit des appareils.
rules

Le rapport sur l'activité des règles renvoie des informations sur différents types d'événements d'activité des règles.
saml

Le rapport sur l'activité SAML renvoie des informations sur différents types d'événements d'activité SAML.
token

Les rapports d'activité de l'application Token renvoient des informations sur les différents types d'événements d'activité Token.
user_accounts

Les rapports d'activité de l'application Comptes utilisateur renvoient des informations sur différents types d'événements d'activité des comptes utilisateur.
context_aware_access

Les rapports sur l'activité d'accès contextuel fournissent des informations sur les événements d'accès refusé aux utilisateurs en raison des règles d'accès contextuel.
chrome

Les rapports sur l'activité Chrome fournissent des informations sur les événements du navigateur Chrome et de ChromeOS.
data_studio Les rapports sur l'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 sur l'activité Keep n'est disponible que pour les clients Google Workspace Business et Enterprise.
vault Les rapports sur l'activité Vault renvoient des informations sur différents types d'événements d'activité Vault.
gemini_in_workspace_apps Les rapports sur l'activité Gemini pour Workspace renvoient des informations sur différents types d'événements d'activité Gemini effectués par les utilisateurs dans une application Workspace.
classroom Les rapports sur l'activité Classroom fournissent des informations sur différents types d'événements d'activité Classroom.

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 (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
Champs
kind

string

Type de ressource d'API. Pour un rapport sur l'activité, la valeur est audit#activity.
etag

string

ETag de l'entrée.
ownerDomain

string

Il s'agit du domaine concerné par l'événement du rapport. Par exemple, le domaine de la console d'administration ou du propriétaire du document de l'application Drive.
ipAddress

string

Adresse IP de l'utilisateur qui effectue l'action. Il s'agit de l'adresse IP de l'utilisateur lorsqu'il se connecte à Google Workspace. Elle peut ou non refléter sa position physique. Par exemple, l'adresse IP peut être celle du serveur proxy de l'utilisateur ou celle d'un réseau privé virtuel (VPN). L'API est compatible avec IPv4 et IPv6.
events[]

object

Événements d'activité dans le rapport.
events[].type

string

Type d'événement. Le service ou la fonctionnalité Google Workspace qu'un administrateur modifie est identifié dans la propriété type, qui identifie un événement à l'aide de la propriété eventName. Pour obtenir la liste complète des catégories type de l'API, consultez la liste des noms d'événements pour diverses applications ci-dessus dans applicationName.
events[].name

string

Nom de l'événement. Nom spécifique de l'activité signalée par l'API. Chaque eventName est associé à un service ou une fonctionnalité Google Workspace spécifique que l'API organise en types d'événements.
Pour les paramètres de requête eventName en général :

  • Si aucune eventName n'est fournie, le rapport renvoie toutes les instances possibles d'une eventName.
  • Lorsque vous demandez un eventName, la réponse de l'API renvoie toutes les activités qui contiennent ce eventName.

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[]

object

Paires de valeurs de paramètres pour diverses applications. Pour en savoir plus sur les paramètres eventName, consultez la liste des noms d'événements pour différentes applications ci-dessus dans applicationName.
events[].parameters[].messageValue

object

Paires de valeurs de paramètres imbriquées associées à ce paramètre. Les types de valeurs complexes pour un paramètre sont renvoyés sous forme de liste de valeurs de paramètres. Par exemple, le paramètre d'adresse peut avoir une valeur telle que [{parameter: [{name: city, value: abc}]}].
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

Valeurs de paramètres
events[].parameters[].name

string

Nom du paramètre.
events[].parameters[].value

string

Valeur de chaîne du paramètre.
events[].parameters[].multiValue[]

string

Valeurs de chaîne du paramètre.
events[].parameters[].intValue

string (int64 format)

Valeur entière du paramètre.
events[].parameters[].multiIntValue[]

string (int64 format)

Valeurs entières du paramètre.
events[].parameters[].boolValue

boolean

Valeur booléenne du paramètre.
events[].parameters[].multiMessageValue[]

object

activities.list d'objets messageValue.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Valeurs de paramètres
events[].resourceIds[]

string

ID de ressource associés à l'événement.
id

object

Identifiant unique de chaque enregistrement d'activité.
id.time

string

Heure à laquelle l'activité s'est produite. Il s'agit d'une heure d'époque UNIX en secondes.
id.uniqueQualifier

string (int64 format)

Qualificateur unique si plusieurs événements ont lieu à la même heure.
id.applicationName

string

Nom de l'application à laquelle appartient l'événement. Pour connaître les valeurs possibles, consultez la liste des applications ci-dessus dans applicationName.
id.customerId

string

Identifiant unique d'un compte Google Workspace.
actor

object

Utilisateur effectuant l'action.
actor.profileId

string

ID unique du profil Google Workspace de l'acteur. Cette valeur peut être absente si l'acteur n'est pas un utilisateur Google Workspace, ou peut être le nombre 105250506097979753968 qui sert d'ID d'espace réservé.
actor.email

string

Adresse e-mail principale de l'acteur. Peut être absent si aucune adresse e-mail n'est associée à l'acteur.
actor.callerType

string

Type d'acteur.
actor.key

string

N'est présent que lorsque callerType est défini sur KEY. Il peut s'agir du consumer_key du demandeur pour les requêtes d'API OAuth 2LO ou d'un identifiant pour les comptes de robots.
actor.applicationInfo

object

Détails de l'application qui a été l'acteur de l'activité.
actor.applicationInfo.oauthClientId

string

ID client OAuth de l'application tierce utilisée pour effectuer l'action.
actor.applicationInfo.applicationName

string

Nom de l'application utilisée pour effectuer l'action.
actor.applicationInfo.impersonation

boolean

Indique si l'application usurpait l'identité d'un utilisateur.
networkInfo

object (NetworkInfo)

Informations sur le réseau de l'utilisateur qui effectue l'action.
resourceDetails[]

object (ResourceDetails)

Détails de la ressource sur laquelle l'action a été effectuée.

NetworkInfo

Informations sur le réseau de l'utilisateur qui effectue l'action.

Représentation JSON 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
Champs
ipAsn[]

integer

Adresse IP de l'utilisateur qui effectue l'action.
regionCode

string

Code de région ISO 3166-1 alpha-2 de l'utilisateur qui effectue l'action.
subdivisionCode

string

Code région ISO 3166-2 (États et provinces) pour les pays de l'utilisateur effectuant l'action.

ResourceDetails

Détails de la ressource sur laquelle l'action a été effectuée.

Représentation JSON 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string
}
Champs
id

string

Identifiant de la ressource.
title

string

Titre de la ressource. Par exemple, dans le cas d'un document Drive, il s'agit du titre du document. Dans le cas d'un e-mail, il s'agit de l'objet.
type

string

Type de la ressource : document, e-mail, message de chat
appliedLabels[]

object (AppliedLabel)

activities.list of labels applied on the resource
relation

string

Définit la relation entre la ressource et les événements.

AppliedLabel

Détails du libellé appliqué à la ressource.

Représentation JSON 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
Champs
id

string

Identifiant du libellé (ID uniquement, et non le nom complet de la ressource OnePlatform).
title

string

Titre du libellé
fieldValues[]

object (FieldValue)

activities.list des champs qui font partie du libellé et qui ont été définis par l'utilisateur. Si un libellé comporte un champ qui n'a pas été défini par l'utilisateur, il ne figurera pas dans cette liste.
reason

object (Reason)

Raison pour laquelle le libellé a été appliqué à la ressource.

FieldValue

Détails de la valeur de champ définie par l'utilisateur pour le libellé concerné.

Représentation JSON 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  // Union field value can be only one of the following:
  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Champs
id

string

Identifiant du champ
displayName

string

Nom à afficher du champ
type

string

Type du champ
reason

object (Reason)

Raison pour laquelle le champ a été appliqué au libellé.
Champ d'union value. Les valeurs stockées dans le champ value ne peuvent être que l'une des suivantes :
unsetValue

boolean

Si le champ n'est pas défini, la valeur est "true".
longTextValue

string

Définir une valeur de texte longue.
textValue

string

Définir une valeur de texte.
textListValue

object (TextListValue)

Définir une valeur de liste de texte.
selectionValue

object (SelectionValue)

Définir une valeur de sélection en sélectionnant une seule valeur dans une liste déroulante.
selectionListValue

object (SelectionListValue)

Définir une valeur de liste de sélection en sélectionnant plusieurs valeurs dans un menu déroulant.
integerValue

string (int64 format)

Définir une valeur entière.
userValue

object (UserValue)

Définir une valeur utilisateur en sélectionnant un seul utilisateur.
userListValue

object (UserListValue)

Définir une valeur de liste d'utilisateurs en sélectionnant plusieurs utilisateurs.
dateValue

object (Date)

Définir une valeur de date.

TextListValue

Définir une valeur de liste de texte.

Représentation JSON 
{
  "values": [
    string
  ]
}
Champs
values[]

string

activities.list of text values.

SelectionValue

Définir une valeur de sélection en sélectionnant une seule valeur dans une liste déroulante.

Représentation JSON 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
Champs
id

string

Identifiant de la sélection.
displayName

string

Nom à afficher de la sélection.
badged

boolean

Indique si la sélection est associée à un badge.

SelectionListValue

Définir une valeur de liste de sélection en sélectionnant plusieurs valeurs dans un menu déroulant.

Représentation JSON 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
Champs
values[]

object (SelectionValue)

activities.list of selections.

UserValue

Définir une valeur utilisateur en sélectionnant un seul utilisateur.

Représentation JSON 
{
  "email": string
}
Champs
email

string

Adresse e-mail de l'utilisateur.

UserListValue

Définir une valeur de liste d'utilisateurs en sélectionnant plusieurs utilisateurs.

Représentation JSON 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
Champs
values[]

object (UserValue)

activities.list of users.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Elle peut être représentée par l'un des éléments suivants :

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour nuls ;
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés :

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.
day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif.

Motif

Raison pour laquelle le libellé/champ a été appliqué.

Représentation JSON 
{
  "reasonType": string
}
Champs
reasonType

string

Type de motif.