Method: activity.query

Esegui una query su attività passate su Google Drive.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
consolidationStrategy

object (ConsolidationStrategy)

Dettagli su come consolidare le azioni correlate che compongono l'attività. Se non viene configurato, le azioni correlate non vengono consolidate.
pageSize

integer

Il numero minimo di attività desiderato nella risposta; il server tenta di restituire almeno questa quantità. Il server potrebbe anche restituire meno attività se ha una risposta parziale pronta prima del timeout della richiesta. Se non viene configurato, viene utilizzato un valore predefinito.
pageToken

string

Il token identifica la pagina di risultati da restituire. Impostalo sul valore nextPageToken restituito da una query precedente per ottenere la seguente pagina di risultati. Se il criterio non è impostato, viene restituita la prima pagina di risultati.
filter

string

Il filtro per gli elementi restituiti da questa richiesta di query. Il formato della stringa di filtro è una sequenza di espressioni, unite da un "AND" facoltativo, in cui ogni espressione è nel formato "field operator value".

Campi supportati:

  • time: utilizza operatori numerici per i valori delle date in termini di millisecondi dal 1° gennaio 1970 o in formato RFC 3339. Esempi:

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

  • detail.action_detail_case: utilizza l'operatore "has" (:) e un valore singolare o un elenco di tipi di azioni consentite racchiusi tra parentesi e separati da uno spazio. Per escludere un risultato dalla risposta, anteponi un trattino (-) all'inizio della stringa di filtro. Esempi:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Campo di unione key. Il criterio principale della query. Il valore predefinito è ancestorName = items/root, se non è specificata alcuna chiave. key può essere solo uno dei seguenti:
itemName

string

Restituisci le attività per questo elemento di Drive. Il formato è items/ITEM_ID.
ancestorName

string

Restituisci le attività per questa cartella di Drive, oltre a tutti i figli e i discendenti. Il formato è items/ITEM_ID.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per l'esecuzione di query sull'attività su Drive.

Rappresentazione JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Campi
activities[]

object (DriveActivity)

Elenco di attività richieste.
nextPageToken

string

Token per recuperare la pagina dei risultati successiva o vuoto se non ci sono altri risultati nell'elenco.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Guida alle autorizzazioni.

ConsolidationStrategy

Come vengono consolidate le singole attività. Se un insieme di attività è correlato, possono essere riunite in un'unica attività combinata, ad esempio un attore che esegue la stessa azione su più target oppure più attori che eseguono la stessa azione su un singolo target. La strategia definisce le regole relative alle attività correlate.

Rappresentazione 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.
}
Campi
Campo di unione strategy. Come vengono consolidate le singole attività. strategy può essere solo uno dei seguenti:
none

object (NoConsolidation)

Le singole attività non vengono consolidate.
legacy

object (Legacy)

Le singole attività vengono consolidate utilizzando la strategia precedente.

NoConsolidation

Una strategia che non include il consolidamento delle singole attività.

Legacy

Una strategia che consolida le attività utilizzando le regole di raggruppamento dell'API V1 Activity precedente. Le azioni simili che si verificano in un intervallo di tempo possono essere raggruppate su più target (ad esempio lo spostamento di un insieme di file contemporaneamente) o su più attori (ad esempio più utenti che modificano lo stesso elemento). Le regole di raggruppamento per questa strategia sono specifiche per ogni tipo di azione.