Method: activity.query

Esegui query sull'attività passata in 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 impostato, le azioni correlate non vengono consolidate.
pageSize

integer

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

string

Il token identifica la pagina dei risultati da restituire. Imposta questo valore sul valore nextPageToken restituito da una query precedente per ottenere la pagina successiva dei risultati. 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, in cui ogni espressione ha la forma "field operator value".

Campi supportati:

  • time: utilizza operatori numerici sui valori di data in termini di millisecondi a partire 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 l'operatore "ha" (:) e un valore singolo o un elenco di tipi di azione consentiti racchiusi tra parentesi, separati da uno spazio. Per escludere un risultato dalla risposta, aggiungi 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 unione key. I criteri principali nella query. Se non viene specificata alcuna chiave, il valore predefinito è ancestorName = items/root. key può essere solo uno dei seguenti:
itemName

string

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

string

Restituisce le attività per questa cartella di Drive, più tutti i figli e i discendenti. Il formato è items/ITEM_ID.

Corpo della risposta

Messaggio di risposta per l'interrogazione dell'attività di 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 di risultati o vuoto se non sono presenti 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

Come vengono consolidate le singole attività. Se un insieme di attività è correlato, può essere consolidato in un'unica attività combinata, ad esempio un attore che esegue la stessa azione su più target o più attori che eseguono la stessa azione su un singolo target. La strategia definisce le regole per le 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 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

Questo tipo non contiene campi.

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

Legacy

Questo tipo non contiene campi.

Una strategia che consolida le attività utilizzando le regole di raggruppamento dell'API Activity v1 legacy. Azioni simili che si verificano in un determinato periodo di tempo possono essere raggruppate in più target (ad esempio, lo spostamento di un insieme di file contemporaneamente) o 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.