Method: activities.list

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.

enum (ApplicationName)

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

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.

string

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

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 à la durée 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 à laquelle la requête est effectuée, 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.

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.

string

La chaîne de requête filters est une liste de paramètres d'événement séparés par une virgule et manipulés par des opérateurs relationnels. Les paramètres d'événement se présentent sous la forme {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 de 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.

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.

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.

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 complémentaire pour obtenir la page suivante du rapport, saisissez la valeur nextPageToken dans la chaîne de requête pageToken.

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

 Pour les demandes concernant Gmail, startTime et endTime doivent être fournis, et la différence ne doit pas dépasser 30 jours.

string

ID de groupe (masqués) séparés par une virgule sur lesquels les activités des utilisateurs sont filtrées. En d'autres termes, 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"

string

Facultatif. La chaîne de requête resourceDetailsFilter est une liste séparée par des AND, composée de champs Détails de la ressource manipulés par des opérateurs relationnels.

Les filtres de détails des ressources sont au format {resourceDetails.field1}{relational operator}{field1 value} AND {resourceDetails.field2}{relational operator}{field2 value}....

Tous les champs internes sont parcourus à l'aide de l'opérateur ., comme indiqué dans l'exemple suivant :

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId"

La requête resourceDetailsFilter est compatible avec les opérateurs relationnels suivants :

• = : "égal à".
• != : "différent de".
• : : "exists". Cela permet de filtrer les champs répétés.

Les types FieldValue qui se répètent par nature utilisent l'opérateur exists pour le filtrage.
 Les types FieldValue suivants sont répétés :

• TextListValue
• SelectionListValue
• UserListValue

Par exemple, dans le filtre suivant, SelectionListValue est un champ répété. Le filtre vérifie si SelectionListValue contient selection_id :

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId" AND resourceDetails.appliedLabels.fieldValue.type =
"SELECTION_LIST_VALUE" AND
resourceDetails.appliedLabels.fieldValue.selectionListValue.id: "id"

Utilisation

GET...&resourceDetailsFilter=resourceDetails.id = "resourceId" AND
resourceDetails.appliedLabels.id = "appliedLabelId"
GET...&resourceDetailsFilter=resourceDetails.id=%22resourceId%22%20AND%20resourceDetails.appliedLabels.id=%22appliedLabelId%22

Remarques :

• Vous devez encoder l'URL de la chaîne de requête avant d'envoyer la requête.

• L'API accepte un maximum de cinq champs séparés par l'opérateur AND.

• Lorsque vous filtrez des niveaux plus profonds (par exemple, AppliedLabel, FieldValue), les ID de tous les niveaux précédents de la hiérarchie doivent être inclus dans le filtre. Par exemple, le filtrage sur FieldValue nécessite la présence de l'ID AppliedLabel et de l'ID resourceDetails.
  Exemple de requête :

  resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id = "appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id = "fieldValueId"

• Le filtrage des types FieldValue internes tels que longTextValue et textValue nécessite la présence de resourceDetails.appliedLabels.fieldValue.type.

• Seul le filtrage sur un seul ID AppliedLabel et un seul ID FieldValue est pris en charge.

string

Facultatif. Permet de filtrer le champ regionCode présent dans le message NetworkInfo.

Utilisation

GET...&networkInfoFilter=regionCode="IN"
GET...&networkInfoFilter=regionCode=%22IN%22

string

Facultatif. Permet de filtrer le champ statusCode présent dans le message Status.

Utilisation

GET...&statusFilter=statusCode="200"
GET...&statusFilter=statusCode=%22200%22

string

Facultatif. Permet de filtrer le champ oAuthClientId présent dans le message ApplicationInfo.

Utilisation

GET...&applicationInfoFilter=oAuthClientId="clientId"
GET...&applicationInfoFilter=oAuthClientId=%22clientId%22

boolean

Facultatif. Lorsqu'il est défini sur true, ce champ permet d'inclure du contenu sensible généré par les utilisateurs dans les journaux d'audit renvoyés. Ce paramètre n'est compatible qu'avec les applications Règles (PPD), Chat et Workspace Studio. Si vous l'utilisez avec une autre application, une erreur d'autorisation s'affichera.

string

Facultatif. Filtres sur les champs d'informations sur l'agent dans l'activité. Ce filtre est appliqué en même temps(AND) que les autres filtres. Exemple : "agentInfoFilter=agentId="agent-id" AND agentName="agent-name" AND agentOwnerEmail="agent-owner-email""

string

Facultatif. Permet de filtrer les champs présents dans le message UserDeviceInfo, tels que deviceId, deviceType et deviceOsVersion.

Utilisation

GET...&deviceFilter=deviceId="123"
GET...&deviceFilter=deviceType="ANDROID"
GET...&deviceFilter=deviceOsVersion="14.0"

string

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

string

ETag de l'entrée.

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.

string

Adresse IP de l'utilisateur qui effectue l'action. Il s'agit de l'adresse Internet Protocol (IP) de l'utilisateur lorsqu'il se connecte à Google Workspace. Elle peut refléter ou non 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). L'API est compatible avec IPv4 et IPv6.

object

Événements d'activité dans le rapport.

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.

string

Nom de l'événement. Il s'agit du nom spécifique de l'activité signalée 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.
Pour les paramètres de requête eventName en général :

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

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.

object

Paires clé/valeur 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 la valeur [{parameter: [{name: city, value: abc}]}].

object (NestedParameter)

Valeurs de paramètres

string

Nom du paramètre.

string

Valeur de chaîne du paramètre.

string

Valeurs de chaîne du paramètre.

string (int64 format)

Valeur entière du paramètre.

string (int64 format)

Valeurs entières du paramètre.

boolean

Valeur booléenne du paramètre.

object

activities.list de messageValue objets.

object (NestedParameter)

Valeurs de paramètres

object

Inclut des paires de valeurs de paramètres sensibles pour différentes applications.

object

Paires clé/valeur 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 la valeur [{parameter: [{name: city, value: abc}]}].

object (NestedParameter)

Valeurs de paramètres

string

Nom du paramètre.

string

Valeur de chaîne du paramètre.

string

Valeurs de chaîne du paramètre.

string (int64 format)

Valeur entière du paramètre.

string (int64 format)

Valeurs entières du paramètre.

boolean

Valeur booléenne du paramètre.

object

activities.list de messageValue objets.

object (NestedParameter)

Valeurs de paramètres

string

ID de ressources associés à l'événement.

object (Status)

État de l'événement. Remarque : Tous les événements n'ont pas d'état.

object

Identifiant unique pour chaque enregistrement d'activité.

string

Heure à laquelle l'activité s'est produite. Il s'agit d'un code temporel UNIX en secondes.

string (int64 format)

Qualificateur unique si plusieurs événements ont lieu au même moment.

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.

string

Identifiant unique d'un compte Google Workspace.

object

Utilisateur effectuant l'action.

string

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 peut être le nombre 105250506097979753968, qui sert d'ID d'espace réservé.

string

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

string

Type d'acteur.

string

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

object

Informations sur l'application qui a été l'acteur de l'activité.

string

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

string

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

boolean

Indique si l'application a usurpé l'identité d'un utilisateur.

object (AgentAttributionInfo)

Détails sur l'agent d'IA qui a effectué l'activité.

object (NetworkInfo)

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

object (ResourceDetails)

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

boolean

Indique si l'activité a été effectuée par un agent.

object (UserDeviceInfo)

Informations sur l'appareil de l'utilisateur qui effectue l'action. Ce champ n'est exposé que pour les applications contacts, gemini_in_workspace_apps, keep, meet_hardware, meet, chat, chrome, directory_sync, drive, groups, rules, data_studio et saml.

integer

Adresse IP de l'utilisateur ayant effectué l'action.

string

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

string

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

string

Identifiant de la ressource, tel qu'un doc_id pour un document Drive, un conference_id pour une conférence Meet ou un "gaia_id/rfc2822_message_id" pour un e-mail.

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.

string

Type de ressource : document, e-mail, message de chat

object (AppliedLabel)

activities.list of labels applied on the resource

string

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

object (OwnerDetails)

Informations sur le propriétaire de la ressource.

string

Identifiant du libellé : seul l'ID du libellé, et non le nom de ressource OnePlatform complet.

string

Titre du libellé

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.

object (Reason)

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

string

Identifiant du champ

string

Nom à afficher du champ

string

Type du champ

object (Reason)

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

boolean

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

string

Définition d'une valeur de texte longue.

string

Définition d'une valeur de texte.

object (TextListValue)

Définition d'une valeur de liste de texte.

object (SelectionValue)

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

object (SelectionListValue)

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

string (int64 format)

Définition d'une valeur entière.

object (UserValue)

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

object (UserListValue)

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

object (Date)

Définir une valeur de date.

string

activities.list des valeurs de texte.

string

Identifiant de la sélection.

string

Nom à afficher de la sélection.

boolean

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

object (SelectionValue)

activities.list of selections.

string

Adresse e-mail de l'utilisateur.

object (UserValue)

activities.list of users.

integer

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

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.

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.

string

Type de motif.

string

Type de propriétaire de la ressource.

object (OwnerIdentity)

Informations sur l'identité du ou des propriétaires de la ressource.

object (CustomerIdentity)

Identité du client Google Workspace propriétaire de la ressource.

object (UserIdentity)

Identité de l'utilisateur propriétaire de la ressource.

object (GroupIdentity)

Identité du groupe propriétaire de la ressource.

object (SharedDriveIdentity)

Identité du Drive partagé propriétaire de la ressource.

string

Numéro client.

string

ID Gaia de l'utilisateur.

string

Adresse e-mail de l'utilisateur.

string

ID Gaia du groupe.

string

Adresse e-mail de groupe.

string

ID Gaia du Drive partagé.

string

Nom du Drive partagé.

string

Uniquement en sortie. ID de l'appareil de l'utilisateur.

string

Uniquement en sortie. Type d'appareil de l'utilisateur.

string

Uniquement en sortie. Version de l'OS de l'appareil de l'utilisateur.