Method: activities.list

string

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 all pour toutes les informations, ou userKey pour l'ID de profil Google Workspace unique d'un utilisateur ou son adresse e-mail principale. Il ne doit pas s'agir d'un compte utilisateur 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 (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.

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 à l'heure approximative de la requête API. Un rapport d'API comporte trois concepts de temps 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 indiquée dans le rapport. La valeur startTime doit être antérieure à la valeur endTime (si spécifiée) et à l'heure actuelle à laquelle la requête est effectuée. Dans le cas contraire, l'API renvoie une erreur.
• Heure de fin du rapport: fin de la période indiquée dans le rapport. Par exemple, la période des événements résumés dans un rapport peut commencer en avril et se terminer en mai. Le rapport en lui-même sera disponible au mois d'août.

string

Nom de l'événement interrogé 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. C'est le cas, par exemple, des événements Google Agenda affichés 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 d'Agenda signalées par l'API. Lorsqu'un administrateur modifie un paramètre Agenda, l'API signale cette activité dans les paramètres type et eventName des paramètres Agenda. Pour en savoir plus sur les chaînes et les paramètres de requête 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 d'éléments séparés par une virgule 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 demande n'appartient pas à eventName. Pour en savoir plus sur les champs eventName disponibles pour chaque application et les paramètres associés, accédez au tableau ApplicationName, puis à la page "Activity Events" (Événements d'activité) de l'annexe de l'application souhaitée.

Dans les exemples d'activités Drive suivants, la liste renvoyée comprend tous les événements edit pour lesquels 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 avec une valeur doc_id égale à 12345. Dans le deuxième exemple, le rapport renvoie tous les documents modifiés pour lesquels la valeur doc_id n'est pas égale à 98765. L'opérateur <> est encodé en 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 accepte 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 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.

integer

Détermine le nombre d'enregistrements d'activité affichés sur chaque page de réponse. Par exemple, si la demande 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 concernée par le rapport. Les enregistrements d'activité ne seront affichés que pour les utilisateurs appartenant à l'unité organisationnelle spécifiée.

string

Jeton pour spécifier la page suivante. Un rapport comportant plusieurs pages comporte une propriété nextPageToken dans la réponse. Dans votre demande de suivi visant à 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. La valeur startTime doit être antérieure à la valeur endTime (si spécifiée) et à l'heure actuelle à laquelle la requête est effectuée. Dans le cas contraire, l'API renvoie une erreur.

string

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"

{
  "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)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}

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 le propriétaire des documents de l'application Drive).

string

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.

object

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

string

Type d'événement. La fonctionnalité ou le service Google Workspace modifié par un administrateur 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 différentes 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écifique 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'une eventName.
• Lorsque vous demandez un eventName, la réponse de l'API renvoie toutes les activités qui contiennent ce eventName.

object

Paires valeur/paramètre 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 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 [{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

activités.list de messageValue objets.

object (NestedParameter)

Valeurs de paramètres

object

Identifiant unique pour chaque enregistrement d'activité.

string

Heure à laquelle l'activité s'est produite. Elle correspond à l'epoch UNIX, exprimée en secondes.

string (int64 format)

Qualificatif unique si plusieurs événements ont la même heure.

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 il peut s'agir du numéro 105250506097979753968, qui sert d'ID d'espace réservé.

string

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

string

Type d'acteur.

string

Présent uniquement lorsque callerType est défini sur KEY. Peut correspondre au consumer_key du demandeur pour les requêtes API OAuth 2LO ou à un identifiant pour les comptes robots.