Method: activities.list

Recupera un elenco di attività relative all'account e all'applicazione di un cliente specifico, ad esempio l'applicazione della Console di amministrazione o l'applicazione Google Drive. Per ulteriori informazioni, consulta le guide per gli amministratori e i report sulle attività di Google Drive. Per ulteriori informazioni sui parametri del report sulle attività, consulta le guide di riferimento sui parametri dell'attività.

Richiesta HTTP

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userKey or all

string

Rappresenta l'ID profilo o l'email dell'utente per cui i dati devono essere filtrati. Può essere all per tutte le informazioni o userKey per l'ID profilo Google Workspace univoco di un utente o il suo indirizzo email principale. Non deve essere un utente eliminato. Per un utente eliminato, chiama users.list nell'API Directory con showDeleted=true, quindi utilizza ID restituito come userKey.

applicationName

enum (ApplicationName)

Nome dell'applicazione per la quale è necessario recuperare gli eventi.

Parametri di query

Parametri
actorIpAddress

string

L'indirizzo IP (Internet Protocol) dell'host su cui è stato eseguito l'evento. Questo è un ulteriore modo per filtrare il riepilogo di un report utilizzando l'indirizzo IP dell'utente di cui viene segnalata l'attività. Questo indirizzo IP può riflettere o meno la posizione fisica dell'utente. Ad esempio, l'indirizzo IP può essere l'indirizzo del server proxy dell'utente o l'indirizzo di una rete privata virtuale (VPN). Questo parametro supporta le versioni degli indirizzi IPv4 e IPv6.

customerId

string

L'ID univoco del cliente per il quale recuperare i dati.

endTime

string

Imposta la fine dell'intervallo di tempo visualizzato nel report. La data è nel formato RFC 3339, ad esempio 2010-10-28T10:26:35.000Z. Il valore predefinito è l'ora approssimativa della richiesta API. Un report API prevede tre concetti di base temporali:

  • Data della richiesta di un report da parte dell'API: quando l'API ha creato e recuperato il report.
  • Ora di inizio del report: l'inizio dell'intervallo di tempo visualizzato nel report. startTime deve essere precedente al valore endTime (se specificato) e all'ora attuale in cui viene effettuata la richiesta, altrimenti l'API restituisce un errore.
  • Ora di fine del report: la fine dell'intervallo di tempo visualizzato nel report. Ad esempio, il periodo di tempo degli eventi riassunti in un report può iniziare ad aprile e terminare a maggio. Il report può essere richiesto ad agosto.
Se il valore endTime non è specificato, il report restituisce tutte le attività dal giorno startTime fino all'ora attuale o gli ultimi 180 giorni se il startTime risale a più di 180 giorni prima.

eventName

string

Il nome dell'evento sottoposto a query dall'API. Ogni eventName è correlato a una funzionalità o a un servizio specifico di Google Workspace che l'API organizza in tipi di eventi. Un esempio sono gli eventi di Google Calendar nei report dell'applicazione della Console di amministrazione. La struttura type delle impostazioni di Calendar ha tutte le attività eventName di Calendar segnalate dall'API. Quando un amministratore modifica un'impostazione di Calendar, l'API segnala questa attività nei parametri type e eventName delle impostazioni di Calendar. Per ulteriori informazioni sulle stringhe di query e sui parametri eventName, consulta l'elenco dei nomi di eventi per varie applicazioni in applicationName.

filters

string

La stringa di query filters è un elenco separato da virgole composto da parametri evento manipolati da operatori relazionali. Il formato dei parametri evento è {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Questi parametri evento sono associati a un valore eventName specifico. Se il parametro della richiesta non appartiene a eventName, viene restituito un report vuoto. Per ulteriori informazioni sui campi eventName disponibili per ogni applicazione e sui relativi parametri, vai alla tabella ApplicationName, quindi fai clic sulla pagina Eventi attività nell'Appendice relativa all'applicazione desiderata.

Nei seguenti esempi di attività di Drive, l'elenco restituito è costituito da tutti gli eventi edit in cui il valore del parametro doc_id corrisponde alle condizioni definite dall'operatore relazionale. Nel primo esempio, la richiesta restituisce tutti i documenti modificati con un valore doc_id uguale a 12345. Nel secondo esempio, il report restituisce tutti i documenti modificati in cui il valore doc_id è diverso da 98765. L'operatore <> è codificato nell'URL nella stringa di query della richiesta (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Una query filters supporta i seguenti operatori relazionali:

  • ==—"uguale a".
  • <>—"non uguale a". Deve essere codificato come URL (%3C%3E).
  • <: "minore di". Deve essere codificato nell'URL (%3C).
  • <=: "minore di o uguale a". Deve essere codificato nell'URL (%3C=).
  • >: "maggiore di". Deve essere codificato nell'URL (%3E).
  • >=: "maggiore o uguale a". Deve essere codificato nell'URL (%3E=).

Nota: l'API non accetta più valori per lo stesso parametro. Se un parametro viene fornito più di una volta nella richiesta API, l'API accetta solo l'ultimo valore di quel parametro. Inoltre, se nella richiesta API viene fornito un parametro non valido, l'API lo ignora e restituisce la risposta corrispondente ai parametri validi rimanenti. Se non vengono richiesti parametri, vengono restituiti tutti i parametri.

maxResults

integer

Determina il numero di record delle attività visualizzati in ciascuna pagina di risposta. Ad esempio, se la richiesta imposta maxResults=1 e il report ha due attività, avrà due pagine. La proprietà nextPageToken della risposta include il token per la seconda pagina. La stringa di query maxResults è facoltativa nella richiesta. Il valore predefinito è 1000.

orgUnitID

string

ID dell'unità organizzativa su cui generare il report. I record delle attività vengono mostrati solo per gli utenti che appartengono all'unità organizzativa specificata.

pageToken

string

Il token per specificare la pagina successiva. Un report con più pagine ha una proprietà nextPageToken nella risposta. Nella richiesta successiva per visualizzare la pagina successiva del report, inserisci il valore nextPageToken nella stringa di query pageToken.

startTime

string

Imposta l'inizio dell'intervallo di tempo visualizzato nel report. La data è nel formato RFC 3339, ad esempio 2010-10-28T10:26:35.000Z. Il report restituisce tutte le attività dal giorno startTime al giorno endTime. startTime deve essere precedente al valore endTime (se specificato) e all'ora attuale in cui viene effettuata la richiesta, altrimenti l'API restituisce un errore.

groupIdFilter

string

ID gruppo separati da virgole (offuscati) su cui vengono filtrate le attività utente. Ad esempio, la risposta conterrà solo le attività degli utenti che fanno parte di almeno uno degli ID gruppo indicati qui. Formato: "id:abc123,id:xyz456"

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Modello JSON per una raccolta di attività.

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

Rappresentazione JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Il tipo di risorsa API. Per un report di attività, il valore è reports#activities.

etag

string

ETag della risorsa.

items[]

object (Activity)

Ogni record di attività nella risposta.

nextPageToken

string

Token per il recupero della pagina successiva successiva del report. Il valore nextPageToken viene utilizzato nella stringa di query pageToken della richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ApplicationName

Enum
access_transparency

I report sulle attività di Access Transparency di Google Workspace restituiscono informazioni sui diversi tipi di eventi relativi alle attività di Access Transparency.

admin

I report sulle attività dell'applicazione della Console di amministrazione restituiscono informazioni sull'account relative a diversi tipi di eventi di attività dell'amministratore.

calendar

I report sulle attività dell'applicazione Google Calendar restituiscono informazioni su vari eventi relativi alle attività del calendario.

chat I report sull'attività di Chat restituiscono informazioni su vari eventi dell'attività di Chat.
drive

I report sulle attività dell'applicazione Google Drive restituiscono informazioni su vari eventi dell'attività di Google Drive. Il report Attività di Drive è disponibile solo per i clienti Google Workspace Business ed Enterprise.

gcp I report sulle attività dell'applicazione Google Cloud Platform restituiscono informazioni su vari eventi di attività di Google Cloud.
gplus I report sulle attività dell'applicazione Google+ restituiscono informazioni su vari eventi delle attività di Google+.
groups

I report sulle attività dell'applicazione Google Gruppi restituiscono informazioni su vari eventi di attività di Gruppi.

groups_enterprise

I report sulle attività di Enterprise Groups restituiscono informazioni su vari eventi di attività di gruppi aziendali.

jamboard I report sulle attività di Jamboard restituiscono informazioni su vari eventi relativi alle attività di Jamboard.
login

I report sulle attività dell'applicazione di accesso restituiscono informazioni sull'account relative a diversi tipi di eventi relativi all'attività di accesso.

meet Il report Attività del controllo di Meet restituisce informazioni sui diversi tipi di eventi relativi all'attività del controllo di Meet.
mobile Il report Attività del controllo dei dispositivi restituisce informazioni su diversi tipi di eventi relativi all'attività di controllo dei dispositivi.
rules

Il report sull'attività delle regole restituisce informazioni sui diversi tipi di eventi relativi all'attività delle regole.

saml

Il report sull'attività SAML restituisce informazioni sui diversi tipi di eventi di attività SAML.

token

I report sulle attività dell'applicazione token restituiscono informazioni sull'account relative a diversi tipi di eventi relativi all'attività dei token.

user_accounts

I report sulle attività dell'applicazione Account utente restituiscono informazioni sugli account relativi a diversi tipi di eventi attività degli account utente.

context_aware_access

I report Attività di accesso sensibile al contesto restituiscono informazioni sui eventi di accesso negato a causa di regole di accesso sensibile al contesto.

chrome

I report sulle attività di Chrome restituiscono informazioni sugli eventi del browser Chrome e di ChromeOS.

data_studio I report sulle attività di Data Studio restituiscono informazioni su vari tipi di eventi attività di Data Studio.
keep I report sulle attività dell'applicazione Keep restituiscono informazioni su vari eventi di attività di Google Keep. Il report sulle attività di Keep è disponibile solo per i clienti Google Workspace Business ed Enterprise.
vault I report sulle attività di Vault restituiscono informazioni sui vari tipi di eventi correlati alle attività di Vault.

Attività

Modello JSON per la risorsa attività.

Rappresentazione JSON
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}
Campi
kind

string

Il tipo di risorsa API. Per un report di attività, il valore è audit#activity.

etag

string

ETag della voce.

ownerDomain

string

Si tratta del dominio interessato dall'evento del report. ad esempio il dominio della Console di amministrazione o il proprietario dei documenti dell'applicazione Drive.

ipAddress

string

Indirizzo IP dell'utente che esegue l'azione. Si tratta dell'indirizzo IP (Internet Protocol) dell'utente quando accede a Google Workspace, che può riflettere o meno la posizione fisica dell'utente. Ad esempio, l'indirizzo IP può essere l'indirizzo del server proxy dell'utente o l'indirizzo di una rete privata virtuale (VPN). L'API supporta IPv4 e IPv6.

events[]

object

Eventi di attività nel report.

events[].type

string

Tipo di evento. Il servizio o la funzionalità di Google Workspace modificati da un amministratore viene identificato nella proprietà type che identifica un evento utilizzando la proprietà eventName. Per un elenco completo delle categorie type dell'API, vedi l'elenco dei nomi degli eventi per le varie applicazioni qui sopra in applicationName.

events[].name

string

Nome dell'evento. Questo è il nome specifico dell'attività riportata dall'API. Inoltre, ogni eventName è correlato a una funzionalità o a un servizio specifico di Google Workspace che l'API organizza in tipi di eventi.
Per i parametri della richiesta eventName in generale:

  • Se eventName non viene specificato, il report restituisce tutte le possibili istanze di un eventName.
  • Quando richiedi un eventName, la risposta dell'API restituisce tutte le attività che contengono quel eventName.

Per ulteriori informazioni sulle proprietà eventName, consulta l'elenco dei nomi degli eventi per le varie applicazioni in applicationName.

events[].parameters[]

object

Coppie di valori dei parametri per varie applicazioni. Per ulteriori informazioni sui parametri eventName, consulta l'elenco dei nomi degli eventi per le varie applicazioni qui sopra in applicationName.

events[].parameters[].messageValue

object

Coppie di valori parametro nidificate associate a questo parametro. Il tipo di valore complesso di un parametro viene restituito come un elenco di valori parametro. Ad esempio, il parametro indirizzo potrebbe avere il valore [{parameter: [{name: city, value: abc}]}]

events[].parameters[].messageValue.parameter[]

object (NestedParameter)

Valori parametro

events[].parameters[].name

string

Il nome del parametro.

events[].parameters[].value

string

Valore stringa del parametro.

events[].parameters[].multiValue[]

string

Valori stringa del parametro.

events[].parameters[].intValue

string (int64 format)

Valore intero del parametro.

events[].parameters[].multiIntValue[]

string (int64 format)

Valori interi del parametro.

events[].parameters[].boolValue

boolean

Valore booleano del parametro.

events[].parameters[].multiMessageValue[]

object

activity.list di messageValue oggetti.

events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Valori parametro

id

object

Identificatore univoco per ciascun record di attività.

id.time

string

L'ora in cui si è verificata l'attività. Il valore è espresso nel tempo dell'epoca UNIX in secondi.

id.uniqueQualifier

string (int64 format)

Qualificatore univoco se più eventi hanno lo stesso orario.

id.applicationName

string

Nome dell'applicazione a cui appartiene l'evento. Per i valori possibili, consulta l'elenco delle applicazioni riportato sopra in applicationName.

id.customerId

string

L'identificatore univoco di un account Google Workspace.

actor

object

Utente che esegue l'azione.

actor.profileId

string

L'ID profilo Google Workspace univoco dell'attore. Questo valore potrebbe non essere presente se l'attore non è un utente di Google Workspace oppure il numero 105250506097979753968 che funge da ID segnaposto.

actor.email

string

L'indirizzo email principale dell'attore. Potrebbe non essere presente se non esistono indirizzi email associati all'attore.

actor.callerType

string

Il tipo di attore.

actor.key

string

Presente solo quando callerType è KEY. Può essere il consumer_key del richiedente per le richieste API OAuth 2LO o un identificatore per gli account robot.