- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ApplicationName
- Attività
- Prova!
Recupera un elenco di attività per l'account e l'applicazione di un cliente specifico, ad esempio l'applicazione della Console di amministrazione o Google Drive. Per ulteriori informazioni, consulta le guide per i report sulle attività degli amministratori e di Google Drive. Per ulteriori informazioni sui parametri del report sulle attività, consulta le guide di riferimento sui parametri 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 |
Rappresenta l'ID profilo o l'indirizzo email dell'utente per cui i dati devono essere filtrati. Può essere |
applicationName |
Nome dell'applicazione per cui devono essere recuperati gli eventi. |
Parametri di ricerca
Parametri | |
---|---|
actorIpAddress |
L'indirizzo IP (Internet Protocol) dell'host in 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ò rispecchiare 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 |
L'ID univoco del cliente per il quale recuperare i dati. |
endTime |
Imposta la fine dell'intervallo di tempo visualizzato nel report. Il formato della data è 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 relativi al tempo:
endTime non è specificato, il report restituisce tutte le attività a partire dal giorno startTime fino all'ora corrente o agli ultimi 180 giorni se il valore del campo startTime è superiore a 180 giorni nel passato.
|
eventName |
Il nome dell'evento su cui l'API esegue la query. Ogni |
filters |
La stringa di query Questi parametri evento sono associati a un Nei seguenti esempi di attività di Drive, l'elenco restituito è composto da tutti gli eventi
Una query
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 ignora quel parametro e restituisce la risposta corrispondente ai restanti parametri validi. Se non vengono richiesti parametri, vengono restituiti tutti i parametri. |
maxResults |
Determina il numero di record di attività visualizzati in ogni pagina di risposta. Ad esempio, se la richiesta imposta |
orgUnitID |
ID dell'unità organizzativa su cui generare il report. I record delle attività verranno mostrati solo per gli utenti che appartengono all'unità organizzativa specificata. |
pageToken |
Il token per specificare la pagina successiva. Un report con più pagine ha una proprietà |
startTime |
Imposta l'inizio dell'intervallo di tempo visualizzato nel report. Il formato della data è RFC 3339, ad esempio 2010-10-28T10:26:35.000Z. Il report restituisce tutte le attività dal giorno |
groupIdFilter |
ID gruppi separati da virgole (offuscati) in base ai quali vengono filtrate le attività utente, ovvero la risposta conterrà attività solo per gli utenti che fanno parte di almeno uno degli ID gruppo menzionati 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 ( |
Campi | |
---|---|
kind |
Il tipo di risorsa API. Per un report sulle attività, il valore è |
etag |
ETag della risorsa. |
items[] |
Ogni attività viene registrata nella risposta. |
nextPageToken |
Token per recuperare la pagina successiva del report. Il valore |
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 su 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 relativi alle attività degli amministratori. |
calendar |
I report sulle attività dell'applicazione Google Calendar restituiscono informazioni su diversi eventi di attività di Calendar. |
chat |
I report sull'attività di Chat restituiscono informazioni su vari eventi di attività di Chat. |
drive |
I report sulle attività dell'applicazione Google Drive restituiscono informazioni su diversi eventi relativi alle attività di Google Drive. Il report sull'attività di Drive è disponibile solo per i clienti Google Workspace Business ed Enterprise. |
gcp |
I report sulle attività dell'applicazione della piattaforma Google Cloud restituiscono informazioni su diversi eventi di attività Google Cloud. |
gplus |
I rapporti sulle attività dell'applicazione Google+ restituiscono informazioni su diversi eventi di attività di Google+. |
groups |
I report sull'attività dell'applicazione Google Gruppi restituiscono informazioni su diversi eventi relativi alle attività di Gruppi. |
groups_enterprise |
I report sulle attività dei gruppi aziendali restituiscono informazioni su vari eventi relativi alle attività dei gruppi aziendali. |
jamboard |
I report sulle attività di Jamboard restituiscono informazioni su vari eventi di attività di Jamboard. |
login |
I report sulle attività dell'applicazione di accesso restituiscono informazioni sull'account relative a diversi tipi di eventi relativi alle attività di accesso. |
meet |
Il report sull'attività di controllo di Meet restituisce informazioni su diversi tipi di eventi relativi all'attività di controllo di Meet. |
mobile |
Il report sull'attività di controllo dei dispositivi restituisce informazioni su diversi tipi di eventi relativi all'attività di controllo dei dispositivi. |
rules |
Il report Attività delle regole restituisce informazioni su diversi tipi di eventi di attività delle regole. |
saml |
Il report sulle attività SAML restituisce informazioni su diversi tipi di eventi relativi alle attività SAML. |
token |
I report sull'attività dell'applicazione token restituiscono informazioni sull'account relative a diversi tipi di eventi di attività dei token. |
user_accounts |
I report sull'attività dell'applicazione degli account utente restituiscono informazioni sull'account relative a diversi tipi di eventi relativi all'attività degli account utente. |
context_aware_access |
I report Attività di accesso sensibile al contesto restituiscono informazioni sugli eventi di accesso negato da parte degli utenti a causa delle 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 diversi eventi di attività di Google Keep. Il report 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 relativi alle attività di Vault. |
Attività
Modello JSON per la risorsa dell'attività.
Rappresentazione JSON |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
Campi | |
---|---|
kind |
Il tipo di risorsa API. Per un report sulle attività, il valore è |
etag |
ETag della voce. |
ownerDomain |
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 |
Indirizzo IP dell'utente che esegue l'azione. Si tratta dell'indirizzo IP (Internet Protocol) dell'utente quando esegue l'accesso a Google Workspace, che può indicare 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[] |
Eventi di attività nel report. |
events[].type |
Tipo di evento. La funzionalità o il servizio di Google Workspace modificato da un amministratore viene identificato nella proprietà |
events[].name |
Il nome dell'evento. Si tratta del nome specifico dell'attività riportata dall'API. Inoltre, ogni
Per ulteriori informazioni sulle proprietà eventName , consulta l'elenco dei nomi degli eventi per varie applicazioni riportato sopra in applicationName .
|
events[].parameters[] |
Coppie di valori dei parametri per varie applicazioni. Per ulteriori informazioni sui parametri |
events[].parameters[].messageValue |
Coppie di valori di parametri nidificati associate a questo parametro. Il tipo di valore complesso di un parametro viene restituito sotto forma di elenco di valori. Ad esempio, il parametro indirizzo può avere un valore pari a |
events[].parameters[].messageValue.parameter[] |
Valori parametro |
events[].parameters[].name |
Il nome del parametro. |
events[].parameters[].value |
Valore stringa del parametro. |
events[].parameters[].multiValue[] |
Valori stringa del parametro. |
events[].parameters[].intValue |
Valore intero del parametro. |
events[].parameters[].multiIntValue[] |
Valori interi del parametro. |
events[].parameters[].boolValue |
Valore booleano del parametro. |
events[].parameters[].multiMessageValue[] |
activity.list di |
events[].parameters[].multiMessageValue[].parameter[] |
Valori parametro |
id |
Identificatore univoco per record di attività. |
id.time |
Ora in cui si è verificata l'attività. Il tempo di epoca UNIX è espresso in secondi. |
id.uniqueQualifier |
Qualificatore univoco se più eventi hanno lo stesso tempo. |
id.applicationName |
Nome dell'applicazione a cui appartiene l'evento. Per i valori possibili, consulta l'elenco delle applicazioni riportato sopra in |
id.customerId |
L'identificatore univoco di un account Google Workspace. |
actor |
L'utente esegue l'azione. |
actor.profileId |
L'ID profilo univoco di Google Workspace dell'attore. Questo valore potrebbe non essere presente se l'attore non è un utente di Google Workspace oppure potrebbe essere il numero 105250506097979753968, che funge da ID segnaposto. |
actor.email |
L'indirizzo email principale dell'attore. Potrebbe non essere presente se non esiste un indirizzo email associato all'attore. |
actor.callerType |
Il tipo di attore. |
actor.key |
Presente solo quando |