Method: activity.query

Interroger l'activité passée dans Google Drive

Requête HTTP

POST https://driveactivity.googleapis.com/v2/activity:query

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
Champs
consolidationStrategy

object (ConsolidationStrategy)

Détails sur la façon de regrouper les actions associées qui constituent l'activité. Si cette valeur n'est pas définie, les actions associées ne sont pas consolidées.
pageSize

integer

Nombre minimal d'activités souhaitées dans la réponse. Le serveur tente de renvoyer au moins cette quantité. Le serveur peut également renvoyer moins d'activités s'il dispose d'une réponse partielle prête avant l'expiration de la requête. Si elle n'est pas définie, une valeur par défaut est utilisée.
pageToken

string

Le jeton identifie la page de résultats à renvoyer. Définissez ce paramètre sur la valeur nextPageToken renvoyée par une requête précédente pour obtenir la page de résultats suivante. Si cette option n'est pas définie, la première page de résultats est renvoyée.
filter

string

Filtrage des éléments renvoyés par cette requête. Le format de la chaîne de filtre est une séquence d'expressions, jointes par un opérateur "AND" facultatif, où chaque expression se présente au format "valeur d'opérateur de champ".

Champs compatibles:

  • time: utilise des opérateurs numériques sur les valeurs de date en nombre de millisecondes depuis le 1er janvier 1970 ou au format RFC 3339. Exemples :

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case : utilise l'opérateur "a" (:) et une valeur unique ou une liste de types d'actions autorisés entre parenthèses, séparés par un espace. Pour exclure un résultat de la réponse, ajoutez un trait d'union (-) au début de la chaîne de filtre. Exemples :

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Champ d'union key. Critères principaux de la requête. La valeur par défaut est ancestorName = items/root, si aucune clé n'est spécifiée. La key ne peut être qu'un des éléments suivants :
itemName

string

Renvoie les activités pour cet élément Drive. Il a le format suivant : items/ITEM_ID.
ancestorName

string

Afficher les activités pour ce dossier Drive, ainsi que pour tous les enfants et descendants. Il a le format suivant : items/ITEM_ID.

Corps de la réponse

Message de réponse pour une demande d'activité dans Drive.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Champs
activities[]

object (DriveActivity)

Liste de l'activité demandée.
nextPageToken

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

Pour en savoir plus, consultez le Guide relatif aux autorisations.

ConsolidationStrategy

Comment les activités individuelles sont consolidées. Si un ensemble d'activités est lié, il peut être regroupé dans une activité combinée, par exemple lorsqu'un acteur effectue la même action sur plusieurs cibles ou que plusieurs acteurs effectuent la même action sur une seule cible. La stratégie définit les règles auxquelles les activités sont associées.

Représentation JSON 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
Champs
Champ d'union strategy. Comment les activités individuelles sont-elles regroupées ? strategy ne peut être qu'un des éléments suivants :
none

object (NoConsolidation)

Les activités individuelles ne sont pas regroupées.
legacy

object (Legacy)

Les activités individuelles sont consolidées à l'aide de l'ancienne stratégie.

NoConsolidation

Ce type ne comporte aucun champ.

Stratégie qui ne consolide pas les activités individuelles.

Ancien

Ce type ne comporte aucun champ.

Une stratégie qui regroupe les activités à l'aide des règles de regroupement de l'ancienne API Activity version 1. Les actions similaires qui se produisent dans un intervalle de temps donné peuvent être regroupées pour plusieurs cibles (par exemple, le déplacement d'un ensemble de fichiers en même temps) ou plusieurs acteurs (par exemple, plusieurs utilisateurs qui modifient le même élément). Les règles de regroupement de cette stratégie sont spécifiques à chaque type d'action.