- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ApplicationName
- Attività
- ResourceDetails
- AppliedLabel
- FieldValue
- TextListValue
- SelectionValue
- SelectionListValue
- UserValue
- UserListValue
- Data
- Motivo
- Prova!
Recupera un elenco di attività per l'account e l'applicazione di un cliente specifico, ad esempio l'applicazione Console di amministrazione o l'applicazione Google Drive. Per saperne di più, consulta le guide per i report sulle attività degli amministratori e di Google Drive. Per saperne di più sui parametri del report sulle attività, consulta le guide di riferimento dei parametri di 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 devono essere filtrati i dati. Può essere |
applicationName |
Nome dell'applicazione per cui devono essere recuperati gli eventi. |
Parametri di query
Parametri | |
---|---|
actorIpAddress |
L'indirizzo IP (Internet Protocol) dell'host in cui è stato eseguito l'evento. Si tratta di un modo aggiuntivo per filtrare il riepilogo di un report utilizzando l'indirizzo IP dell'utente di cui viene registrata l'attività. Questo indirizzo IP può o meno riflettere la posizione fisica dell'utente. Ad esempio, l'indirizzo IP può essere l'indirizzo del server proxy dell'utente o un indirizzo di rete privata virtuale (VPN). Questo parametro supporta sia le versioni di indirizzi IPv4 che IPv6. |
customerId |
L'ID univoco del cliente per cui recuperare i dati. |
endTime |
Imposta la fine dell'intervallo di tempo visualizzato nel report. La data è in formato RFC 3339, ad esempio 2010-10-28T10:26:35.000Z. Il valore predefinito è l'ora approssimativa della richiesta dell'API. Un report dell'API ha tre concetti di tempo di base:
endTime non è specificato, il report restituisce tutte le attività dal giorno startTime fino all'ora corrente o agli ultimi 180 giorni se startTime è più lontano di 180 giorni nel passato.
|
eventName |
Il nome dell'evento su cui viene eseguita la query dall'API. Ogni |
filters |
La stringa di query Questi parametri evento sono associati a un Nei seguenti esempi di attività di Drive, l'elenco restituito è costituito da tutti gli eventi
Una query
Nota: l'API non accetta più valori dello 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 dell'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à da mostrare in ogni pagina di risposta. Ad esempio, se la richiesta imposta |
orgUnitID |
L'ID dell'unità organizzativa per 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. La data è in formato RFC 3339, ad esempio 2010-10-28T10:26:35.000Z. Il report restituisce tutte le attività dal giorno |
groupIdFilter |
ID gruppo (oscurati) separati da virgola su cui vengono filtrate le attività utente, ovvero la risposta conterrà le 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 record di attività 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 trasparenza degli accessi. |
admin |
I report sulle attività dell'applicazione 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 all'attività di Calendar. |
chat |
I report Attività di Chat restituiscono informazioni su vari eventi di attività di Chat. |
drive |
I report sull'attività dell'applicazione Google Drive restituiscono informazioni su vari eventi di attività di Google Drive. Il report Attività su Drive è disponibile solo per i clienti Google Workspace Business ed Enterprise. |
gcp |
I report sull'attività dell'applicazione Google Cloud Platform restituiscono informazioni su vari eventi di attività della piattaforma Google Cloud. |
gplus |
I report sulle attività dell'applicazione Google+ restituiscono informazioni su vari eventi relativi all'attività di Google+. |
groups |
I report sulle attività dell'applicazione Google Gruppi restituiscono informazioni su vari eventi relativi all'attività di gruppi. |
groups_enterprise |
I report sulle attività di Groups Enterprise restituiscono informazioni su vari eventi di attività di gruppi Enterprise. |
jamboard |
I report sull'attività di Jamboard restituiscono informazioni su vari eventi di attività di Jamboard. |
login |
I report sull'attività dell'applicazione di accesso restituiscono informazioni sull'account relative a diversi tipi di eventi di attività di accesso. |
meet |
Il report Attività di controllo di Meet restituisce informazioni su diversi tipi di eventi di attività di controllo di Meet. |
mobile |
Il report Attività di controllo del dispositivo restituisce informazioni su diversi tipi di eventi di attività di controllo del dispositivo. |
rules |
Il report Attività delle regole restituisce informazioni su diversi tipi di eventi Attività delle regole. |
saml |
Il report Attività SAML restituisce informazioni su diversi tipi di eventi di 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 Account utente restituiscono informazioni sull'account relative a diversi tipi di eventi Attività dell'account utente. |
context_aware_access |
I report Attività di accesso sensibile al contesto restituiscono informazioni sugli eventi di accesso negato 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 Chrome OS. |
data_studio |
I report sulle attività di Data Studio restituiscono informazioni su vari tipi di eventi di attività di Data Studio. |
keep |
I report sulle attività dell'applicazione Keep restituiscono informazioni su vari eventi di attività di Google Keep. Il report Attività di Keep è disponibile solo per i clienti di Google Workspace Business ed Enterprise. |
vault |
I report sulle attività di Vault restituiscono informazioni su vari tipi di eventi di 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 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 del documento 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ò o meno riflettere la posizione fisica dell'utente. Ad esempio, l'indirizzo IP può essere l'indirizzo del server proxy dell'utente o un indirizzo di 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 è identificato nella proprietà |
events[].name |
Nome dell'evento. Si tratta del nome specifico dell'attività registrata 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 parametro per varie applicazioni. Per ulteriori informazioni sui parametri |
events[].parameters[].messageValue |
Coppie di valori dei parametri nidificati associati a questo parametro. Il tipo di valore complesso per un parametro viene restituito come elenco di valori del parametro. Ad esempio, il parametro indirizzo potrebbe avere un valore come |
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[] |
activities.list di oggetti |
events[].parameters[].multiMessageValue[].parameter[] |
Valori parametro |
events[].resourceIds[] |
ID risorsa associati all'evento. |
id |
Identificatore univoco per ogni record di attività. |
id.time |
Ora di occorrenza dell'attività. Si tratta del tempo UNIX epoch 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 possibili valori, consulta l'elenco delle applicazioni 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 potrebbe essere il numero 105250506097979753968 che funge da ID segnaposto. |
actor.email |
L'indirizzo email principale dell'attore. Può essere assente se non è presente alcun indirizzo email associato all'attore. |
actor.callerType |
Il tipo di attore. |
actor.key |
Presente solo quando |
actor.applicationInfo |
Dettagli dell'applicazione che è stata l'attore dell'attività. |
actor.applicationInfo.oauthClientId |
ID client OAuth dell'applicazione di terze parti utilizzata per eseguire l'azione. |
actor.applicationInfo.applicationName |
Nome dell'applicazione utilizzata per eseguire l'azione. |
actor.applicationInfo.impersonation |
Indica se l'applicazione ha rubato l'identità di un utente. |
resourceDetails[] |
Dettagli della risorsa su cui è stata eseguita l'azione. |
ResourceDetails
Dettagli della risorsa su cui è stata eseguita l'azione.
Rappresentazione JSON |
---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
Campi | |
---|---|
id |
Identificatore della risorsa. |
title |
Titolo della risorsa. Ad esempio, nel caso di un documento di Drive, si tratta del titolo del documento. Nel caso di un'email, si tratta dell'oggetto. |
type |
Tipo di risorsa: documento, email, messaggio di chat |
appliedLabels[] |
activities.list delle etichette applicate alla risorsa |
relation |
Definisce la relazione della risorsa con gli eventi |
AppliedLabel
Dettagli dell'etichetta applicata alla risorsa.
Rappresentazione JSON |
---|
{ "id": string, "title": string, "fieldValues": [ { object ( |
Campi | |
---|---|
id |
Identificatore dell'etichetta: solo l'ID etichetta, non il nome completo della risorsa OnePlatform. |
title |
Titolo dell'etichetta |
fieldValues[] |
activities.list di campi che fanno parte dell'etichetta e sono stati impostati dall'utente. Se l'etichetta ha un campo che non è stato impostato dall'utente, non sarà presente in questo elenco. |
reason |
Il motivo per cui l'etichetta è stata applicata alla risorsa. |
FieldValue
Dettagli del valore del campo impostato dall'utente per la determinata etichetta.
Rappresentazione JSON |
---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
Campi | |
---|---|
id |
Identificatore del campo |
displayName |
Nome visualizzato del campo |
type |
Tipo di campo |
reason |
Il motivo per cui il campo è stato applicato all'etichetta. |
Campo unione value . Memorizza i valori memorizzati nel campo value può essere solo uno dei seguenti: |
|
unsetValue |
Se il campo non è impostato, il valore sarà true. |
longTextValue |
Impostazione di un valore di testo lungo. |
textValue |
Impostazione di un valore di testo. |
textListValue |
Impostazione di un valore dell'elenco di testo. |
selectionValue |
Impostazione di un valore di selezione selezionando un singolo valore da un elenco a discesa. |
selectionListValue |
Impostazione di un valore dell'elenco di selezione selezionando più valori da un elenco a discesa. |
integerValue |
Impostazione di un valore intero. |
userValue |
Impostazione di un valore utente selezionando un singolo utente. |
userListValue |
Impostazione di un valore dell'elenco di utenti selezionando più utenti. |
dateValue |
Impostazione di un valore data. |
TextListValue
Impostazione di un valore dell'elenco di testo.
Rappresentazione JSON |
---|
{ "values": [ string ] } |
Campi | |
---|---|
values[] |
activities.list di valori di testo. |
SelectionValue
Impostazione di un valore di selezione selezionando un singolo valore da un elenco a discesa.
Rappresentazione JSON |
---|
{ "id": string, "displayName": string, "badged": boolean } |
Campi | |
---|---|
id |
Identificatore della selezione. |
displayName |
Nome visualizzato della selezione. |
badged |
Indica se la selezione è contrassegnata da un badge. |
SelectionListValue
Impostazione di un valore dell'elenco di selezione selezionando più valori da un elenco a discesa.
Rappresentazione JSON |
---|
{
"values": [
{
object ( |
Campi | |
---|---|
values[] |
activities.list delle selezioni. |
UserValue
Impostazione di un valore utente selezionando un singolo utente.
Rappresentazione JSON |
---|
{ "email": string } |
Campi | |
---|---|
email |
Indirizzo email dell'utente. |
UserListValue
Impostazione di un valore dell'elenco di utenti selezionando più utenti.
Rappresentazione JSON |
---|
{
"values": [
{
object ( |
Campi | |
---|---|
values[] |
activities.list di utenti. |
Data
Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:
- Una data completa, con valori di anno, mese e giorno diversi da zero.
- Un mese e un giorno, con un anno pari a zero (ad esempio un anniversario).
- Un anno da solo, con un mese e un giorno pari a zero.
- Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).
Tipi correlati:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Rappresentazione JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campi | |
---|---|
year |
Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno. |
day |
Giorno di un mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo. |
Motivo
Il motivo per cui è stata applicata l'etichetta/il campo.
Rappresentazione JSON |
---|
{ "reasonType": string } |
Campi | |
---|---|
reasonType |
Il tipo di motivo. |