- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ApplicationName
- Attività
- Prova!
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 |
Rappresenta l'ID profilo o l'email dell'utente per cui i dati devono essere filtrati. Può essere |
applicationName |
Nome dell'applicazione per la quale è necessario recuperare gli eventi. |
Parametri di query
Parametri | |
---|---|
actorIpAddress |
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 |
L'ID univoco del cliente per il quale recuperare i dati. |
endTime |
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:
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 |
Il nome dell'evento sottoposto a query dall'API. Ogni |
filters |
La stringa di query Questi parametri evento sono associati a un valore Nei seguenti esempi di attività di Drive, l'elenco restituito è costituito 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 lo ignora e restituisce la risposta corrispondente ai parametri validi rimanenti. Se non vengono richiesti parametri, vengono restituiti tutti i parametri. |
maxResults |
Determina il numero di record delle attività visualizzati in ciascuna pagina di risposta. Ad esempio, se la richiesta imposta |
orgUnitID |
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 |
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. La data è nel formato RFC 3339, ad esempio 2010-10-28T10:26:35.000Z. Il report restituisce tutte le attività dal giorno |
groupIdFilter |
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 ( |
Campi | |
---|---|
kind |
Il tipo di risorsa API. Per un report di attività, il valore è |
etag |
ETag della risorsa. |
items[] |
Ogni record di attività nella risposta. |
nextPageToken |
Token per il recupero della pagina successiva 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 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 ( |
Campi | |
---|---|
kind |
Il tipo di risorsa API. Per un report di 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 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[] |
Eventi di attività nel report. |
events[].type |
Tipo di evento. Il servizio o la funzionalità di Google Workspace modificati da un amministratore viene identificato nella proprietà |
events[].name |
Nome dell'evento. Questo è il nome specifico dell'attività riportata dall'API. Inoltre, ogni
Per ulteriori informazioni sulle proprietà eventName , consulta l'elenco dei nomi degli eventi per le varie applicazioni in applicationName .
|
events[].parameters[] |
Coppie di valori dei parametri per varie applicazioni. Per ulteriori informazioni sui parametri |
events[].parameters[].messageValue |
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 |
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 ciascun record di attività. |
id.time |
L'ora in cui si è verificata l'attività. Il valore è espresso nel tempo dell'epoca UNIX in secondi. |
id.uniqueQualifier |
Qualificatore univoco se più eventi hanno lo stesso orario. |
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 |
Utente che esegue l'azione. |
actor.profileId |
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 |
L'indirizzo email principale dell'attore. Potrebbe non essere presente se non esistono indirizzi email associati all'attore. |
actor.callerType |
Il tipo di attore. |
actor.key |
Presente solo quando |