Method: activity.query

Interrogez 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,

  "itemName": string,
  "ancestorName": string
}
Champs
consolidationStrategy

object (ConsolidationStrategy)

Détails sur la façon de regrouper les actions associées qui composent l'activité. Si elle n'est pas définie, les actions associées ne sont pas regroupé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 avant l'expiration du délai de la requête. Si aucune valeur n'est définie, une valeur par défaut est utilisée.
pageToken

string

Le jeton identifie la page de résultats à renvoyer. Définissez cette valeur 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 "AND" facultatif, où chaque expression est de la forme "field operator value".

Champs acceptés :

  • time : utilise des opérateurs numériques sur les valeurs de date, soit en millisecondes depuis le 1er janvier 1970, soit 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 "has" (:) 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 tiret (-) 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ère principal 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

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

Corps de la réponse

Message de réponse pour l'interrogation de l'activité 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 des activités demandées.
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 d'autorisation.

ConsolidationStrategy

La façon dont les activités individuelles sont consolidées. Si un ensemble d'activités est lié, il peut être regroupé en une seule activité combinée, par exemple un acteur effectuant la même action sur plusieurs cibles ou plusieurs acteurs effectuant la même action sur une seule cible. La stratégie définit les règles pour les activités associées.

Représentation JSON 
{

  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
}
Champs
Champ d'union strategy. La façon dont les activités individuelles sont consolidées. strategy ne peut être qu'un des éléments suivants :
none

object (NoConsolidation)

Les activités individuelles ne sont pas consolidé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.

Stratégie qui consolide les activités à l'aide des règles de regroupement de l'ancienne API Activity V1. Les actions similaires qui se produisent dans un laps de temps donné peuvent être regroupées sur plusieurs cibles (par exemple, le déplacement d'un ensemble de fichiers à la fois) ou plusieurs acteurs (par exemple, plusieurs utilisateurs modifiant le même élément). Les règles de regroupement de cette stratégie sont spécifiques à chaque type d'action.