API Reports: rapport sur l'activité Drive

Le rapport "Activité Drive" fournit des informations sur les activités de vos utilisateurs activités lorsqu'ils gèrent, modifient et partagent des fichiers dans Google Drive dans Google Workspace. Par exemple, vous pouvez utiliser le rapport "Activité Drive" pour obtenir une liste de tous les documents Drive créés par un utilisateur donné une plage de dates spécifiée. Vous pouvez utiliser ces informations pour mieux comprendre d'une meilleure gestion des contenus et d'éventuelles fuites de données. Pour obtenir un rapport, utilisez la demande de base du point de terminaison du rapport avec des paramètres spécifiques au rapport, tels qu'un l'adresse e-mail d'un utilisateur ou un type spécifique de modification Google Drive. Les rapports peuvent inclure les données des 180 derniers jours au maximum.

Le rapport d'activité Google Drive ne peut être utilisé qu'à des fins légales dans les comptes : disposent d'une licence.

Pour en savoir plus sur les chaînes de requête de la requête et les propriétés de réponse, consultez la documentation de référence de l'API. Pour des informations sur des événements spécifiques liés à Google Drive, consultez Noms des événements Drive

Récupérer les événements Google Drive d'un domaine

Vous pouvez utiliser le rapport d'activité Drive pour répertorier des informations sur vos Documents Drive. Par exemple, vous pouvez demander la liste des rapports les 25 événements Drive les plus récents associés à votre compte, soit jusqu'à 180 jours. Pour obtenir ce rapport, vous devez vous procurer un jeton d'autorisation, comme décrit dans l'article guide relatif aux autorisations d'accès, puis utilisez la requête HTTP GET suivante:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

Vous pouvez consulter un exemple de réponse à cet appel d'API.

L'exemple suivant récupère un rapport sur tous les fichiers Drive événements au cours des 180 derniers jours, soit la période maximale.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

Récupérer les événements Google Drive par utilisateur

Pour récupérer un rapport sur les activités Google Drive d'un utilisateur donné, utilisez un requête HTTP GET avec le jeton d'autorisation décrit dans la guide relatif aux autorisations. Le champ userKey correspond à l'adresse e-mail principale de l'utilisateur dans le rapport. all pour tous les utilisateurs

L'exemple suivant récupère un rapport répertoriant toutes les modifications apportées par l'utilisateur spécifié. Pour obtenir un exemple de réponse de l'API, consultez la exemple de réponse JSON.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

Récupérer les événements Google Drive pour les Drive partagés

Vous pouvez récupérer un rapport des activités Google Drive pour un partage spécifique à l'aide d'une requête HTTP GET avec le jeton d'autorisation décrit dans la guide relatif aux autorisations. Spécifiez le paramètre l'adresse e-mail de l'utilisateur pour lequel vous souhaitez générer le rapport dans le champ userKey, ou spécifiez all pour exécuter le rapport sur tous les utilisateurs.

L'exemple suivant récupère un rapport de toutes les modifications apportées à un élément partagé spécifique en voiture. Pour obtenir un exemple de réponse d'API, consultez l'exemple de réponse JSON.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>

Pour récupérer les événements d'un Drive partagé, filtrez à l'aide du doc_type. La L'exemple suivant récupère les événements qui affectent tous les Drive partagés:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive

Pour récupérer les événements liés aux changements d'adhésion, spécifiez shared_drive_membership_change . L'exemple suivant récupère tous les ajouts de membres aux Drive partagés:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive

Récupérer les événements Google Drive par type d'événement

Pour récupérer un rapport sur toutes les instances d'un type d'événement spécifique, comme la création ou que vous modifiez un document, utilisez une requête HTTP GET avec l'autorisation décrit dans le guide relatif aux autorisations. Le champ userKey correspond à l'adresse e-mail principale de l'utilisateur dans le rapport. all pour tous les utilisateurs

L'exemple suivant récupère un rapport sur toutes les créations de documents de compte activités. Pour obtenir un exemple de réponse d'API, consultez l'exemple de réponse JSON:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create

Exemple de réponse JSON

Lorsque vous envoyez une requête HTTP GET à l'API, une réponse positive renvoie une Code d'état HTTP 200. Avec le code d'état, la réponse renvoie un rapport pour Drive. Ces rapports sont également disponibles dans dans la console d'administration Google. Pour en savoir plus, consultez les Centre d'aide pour les administrateurs Google Workspace. Pour en savoir plus sur eventName, consultez les Noms des événements Drive référence. Pour en savoir plus sur les chaînes de requête de la requête et sur les , consultez la documentation de référence de l'API.

{
 "kind": "reports#auditActivities",
 "nextPageToken": "next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2014-03-17T15:39:18.460Z",
    "uniqQualifier": "report's unique ID",
    "applicationName": "drive",
    "customerId": "ABC123xyz"
   },
   "actor": {
   "callerType": "USER",
   "email": "kim@example.com",
   "profileId": "user's unique Google Workspace profile ID",
   "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "domain of the source owner",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "access",
     "name": "edit",
     "parameters": [
      {
        "name": "primary_event",
        "boolValue": true
      },
      {
        "name": "owner_is_shared_drive",
        "boolValue": false
      },      {
        "name": "doc_id",
        "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
      },
      {
        "name": "doc_title",
        "value": "Meeting notes"
      },
      {
        "name": "doc_type",
        "value": "document"
      },
      {
        "name": "owner",
        "value": "mary@example.com"
      }
      ]
     }
    ]
   },
  ]
 }