Method: activity.query

Esegui una query sull'attività passata 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 cerca di restituire almeno questa quantità. Il server potrebbe anche restituire un numero inferiore di 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 pagina di risultati successiva. Se non viene impostato, viene restituita la prima pagina dei 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, dove ogni espressione ha il formato "valore dell'operatore di campo".

Campi supportati:

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

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

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

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Campo unione key. I criteri principali 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

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

Corpo della risposta

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

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

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

object (DriveActivity)

Elenco delle attività richieste.
nextPageToken

string

Token per recuperare la pagina successiva dei risultati 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 all'autorizzazione.

ConsolidationStrategy

Il modo in cui vengono consolidate le singole attività. Se un insieme di attività è correlato, può essere raggruppato in un'unica attività combinata, ad esempio un attore che compie la stessa azione su più bersagli o più attori che eseguono la stessa azione su un singolo bersaglio. La strategia definisce le regole a cui sono correlate le attività.

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 unione strategy. Il modo in cui 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

Questo tipo non contiene campi.

Una strategia che non consolida le singole attività.

Legacy

Questo tipo non contiene campi.

Una strategia che consolida le attività utilizzando le regole di raggruppamento della precedente API V1 Activity. Azioni simili che si verificano in un intervallo di tempo possono essere raggruppate su più obiettivi (ad esempio spostare 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 ciascun tipo di azione.