Method: activities.list

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 sull'attività di amministratori e Google Drive. Per saperne di più sui parametri del report 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

string

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

enum (ApplicationName)

Il nome dell'applicazione per cui devono essere recuperati gli eventi.

Parametri di query

Parametri
actorIpAddress

string

L'indirizzo IP (Internet Protocol) dell'host in cui è stato eseguito l'evento. Questo è un modo aggiuntivo per filtrare il riepilogo di un report utilizzando l'indirizzo IP dell'utente la cui attività viene segnalata. Questo indirizzo IP potrebbe o meno riflettere 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 cui recuperare i dati.
endTime

string

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

  • Data della richiesta di un report dell'API: quando l'API ha creato e recuperato il report.
  • Ora di inizio del report: l'inizio dell'intervallo di tempo mostrato nel report. startTime deve precedere endTime (se specificato) e l'ora corrente al momento della richiesta, altrimenti l'API restituisce un errore.
  • Ora di fine del report: la fine dell'intervallo di tempo mostrato nel report. Ad esempio, l'intervallo di tempo degli eventi riepilogati in un report può iniziare ad aprile e terminare a maggio. Il report stesso può essere richiesto ad agosto.
Se endTime non è specificato, il report restituisce tutte le attività da startTime fino all'ora attuale o agli ultimi 180 giorni se startTime risale a più di 180 giorni fa.

Per le richieste Gmail, devono essere forniti startTime e endTime e la differenza non deve essere superiore a 30 giorni.
eventName

string

Il nome dell'evento su cui viene eseguita la query dall'API. Ogni eventName è correlato a un servizio o una funzionalità di Google Workspace specifici che l'API organizza in tipi di eventi. Un esempio sono gli eventi di Google Calendar nei report dell'applicazione Console di amministrazione. La struttura delle impostazioni di Calendar type contiene tutte le attività di Calendar eventName 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 saperne di più su stringhe di query e parametri eventName, consulta l'elenco dei nomi degli eventi per varie applicazioni riportato sopra in applicationName.
filters

string

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

Questi parametri evento sono associati a un eventName specifico. Se il parametro della richiesta non appartiene a eventName, viene restituito un report vuoto. Per saperne di più sui campi eventName disponibili per ogni applicazione e sui relativi parametri, vai alla tabella ApplicationName, quindi fai clic sulla pagina Eventi di attività nell'appendice per l'applicazione che ti interessa.

Negli esempi di attività di Drive riportati di seguito, 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 di doc_id non è uguale a 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".
  • <>: "diverso da". Deve essere codificato come URL (%3C%3E).
  • <: "inferiore a". Deve essere codificato come URL (%3C).
  • <=: "minore o uguale a". Deve essere codificato come URL (%3C=).
  • >: "maggiore di". Deve essere codificato come URL (%3E).
  • >=: "maggiore o uguale a". Deve essere codificato come URL (%3E=).

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 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 di attività visualizzati in ogni pagina delle risposte. Ad esempio, se la richiesta imposta maxResults=1 e il report ha due attività, il report ha due pagine. La proprietà nextPageToken della risposta contiene 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 di attività verranno 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 ottenere la pagina successiva del report, inserisci il valore nextPageToken nella stringa di query pageToken.
startTime

string

Imposta l'inizio dell'intervallo di tempo mostrato nel report. La data è in 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 precedere endTime (se specificato) e l'ora corrente al momento della richiesta, altrimenti l'API restituisce un errore.

Per le richieste Gmail, devono essere forniti startTime e endTime e la differenza non deve essere superiore a 30 giorni.
groupIdFilter

string

ID gruppo separati da virgole (offuscati) 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 (Activity)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

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

string

ETag della risorsa.
items[]

object (Activity)

Ogni record di attività nella risposta.
nextPageToken

string

Token per recuperare la pagina 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 su diversi tipi di eventi relativi alle attività di Access Transparency.
admin

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

I report sull'attività dell'applicazione Google Calendar restituiscono informazioni su vari eventi di attività di Calendar.
chat I report sull'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 sull'attività di 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à GCP.
gmail I report sull'attività dell'applicazione Gmail restituiscono informazioni su vari eventi di attività di Gmail.
gplus I report sulle attività dell'applicazione Google+ restituiscono informazioni su vari eventi di attività di Google+.
groups

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

I report sull'attività di Groups Enterprise restituiscono informazioni su vari eventi di attività di Groups Enterprise.
jamboard I report sull'attività di Jamboard restituiscono informazioni su vari eventi di attività di Jamboard.
login

I report sull'attività dell'applicazione Login restituiscono informazioni sull'account relative a diversi tipi di eventi di attività di accesso.
meet Il report sull'attività di controllo di Meet restituisce informazioni su diversi tipi di eventi di attività di controllo di Meet.
mobile Il report sull'attività di controllo dei dispositivi restituisce informazioni su diversi tipi di eventi di attività di controllo dei dispositivi.
rules

Il report sull'attività delle regole restituisce informazioni su diversi tipi di eventi di attività delle regole.
saml

Il report sull'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à del token.
user_accounts

I report sull'attività dell'applicazione Account utente restituiscono informazioni sull'account relative a diversi tipi di eventi di attività di Account utente.
context_aware_access

I report sull'attività di accesso sensibile al contesto restituiscono informazioni sugli eventi di accesso negato agli utenti a causa delle regole di accesso sensibile al contesto.
chrome

I report sull'attività di Chrome restituiscono informazioni sugli eventi del browser Chrome e di ChromeOS.
data_studio I report sull'attività di Data Studio restituiscono informazioni su vari tipi di eventi di attività di Data Studio.
keep I report sull'attività dell'applicazione Keep restituiscono informazioni su vari eventi di attività di Google Keep. Il report sull'attività di Keep è disponibile solo per i clienti di Google Workspace Business ed Enterprise.
vault I report sull'attività di Vault restituiscono informazioni su vari tipi di eventi di attività di Vault.
gemini_in_workspace_apps I report sull'attività di Gemini in Workspace restituiscono informazioni su vari tipi di eventi di attività di Gemini eseguiti dagli utenti all'interno di un'applicazione Workspace.
classroom I report sull'attività di Classroom restituiscono informazioni su diversi tipi di eventi di attività di Classroom.

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)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
Campi
kind

string

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

string

ETag della voce.
ownerDomain

string

Il dominio interessato dall'evento del report. Ad esempio, il dominio della Console di amministrazione o il proprietario del documento dell'applicazione Drive.
ipAddress

string

L'indirizzo IP dell'utente che esegue l'azione. Si tratta dell'indirizzo del protocollo internet (IP) dell'utente al momento dell'accesso a Google Workspace, che potrebbe o meno riflettere 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à Google Workspace modificati da un amministratore sono identificati nella proprietà type, che identifica un evento utilizzando la proprietà eventName. Per un elenco completo delle categorie dell'API type, consulta l'elenco dei nomi degli eventi per varie applicazioni riportato sopra in applicationName.
events[].name

string

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

  • Se non viene fornito alcun eventName, 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 varie applicazioni riportato sopra in applicationName.
events[].parameters[]

object

Coppie di valori di parametri per varie applicazioni. Per saperne di più sui parametri eventName, consulta l'elenco dei nomi degli eventi per varie applicazioni riportato sopra in applicationName.
events[].parameters[].messageValue

object

Coppie di valori di parametri nidificati associati a questo parametro. Il tipo di valore complesso per un parametro viene restituito come elenco di valori dei parametri. Ad esempio, il parametro indirizzo potrebbe avere un valore come [{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

activities.list di messageValue oggetti.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Valori parametro
events[].resourceIds[]

string

ID risorsa associati all'evento.
id

object

Identificatore univoco per ogni record di attività.
id.time

string

L'ora in cui si è verificata l'attività. Questo valore è espresso in secondi del tempo Unix epoch.
id.uniqueQualifier

string (int64 format)

Qualificatore univoco se più eventi si svolgono nello stesso momento.
id.applicationName

string

Il 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

L'utente che esegue l'azione.
actor.profileId

string

L'ID profilo Google Workspace univoco dell'attore. Questo valore potrebbe essere assente se l'attore non è un utente Google Workspace o potrebbe essere il numero 105250506097979753968, che funge da ID segnaposto.
actor.email

string

L'indirizzo email principale dell'attore. Potrebbe non essere presente se non è associato alcun indirizzo email all'attore.
actor.callerType

string

Il tipo di attore.
actor.key

string

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

object

Dettagli dell'applicazione che ha eseguito l'attività.
actor.applicationInfo.oauthClientId

string

ID client OAuth dell'applicazione di terze parti utilizzata per eseguire l'azione.
actor.applicationInfo.applicationName

string

Il nome dell'applicazione utilizzata per eseguire l'azione.
actor.applicationInfo.impersonation

boolean

Indica se l'applicazione si spacciava per un utente.
networkInfo

object (NetworkInfo)

Informazioni sulla rete dell'utente che esegue l'azione.
resourceDetails[]

object (ResourceDetails)

Dettagli della risorsa su cui è stata eseguita l'azione.

NetworkInfo

Informazioni sulla rete dell'utente che esegue l'azione.

Rappresentazione JSON 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
Campi
ipAsn[]

integer

L'indirizzo IP dell'utente che esegue l'azione.
regionCode

string

Codice regione ISO 3166-1 alpha-2 dell'utente che esegue l'azione.
subdivisionCode

string

Codice regione ISO 3166-2 (stati e province) per i paesi dell'utente che esegue l'azione.

ResourceDetails

Dettagli della risorsa su cui è stata eseguita l'azione.

Rappresentazione JSON 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string
}
Campi
id

string

Identificatore della risorsa.
title

string

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

string

Tipo di risorsa: documento, email, messaggio di chat
appliedLabels[]

object (AppliedLabel)

activities.list of labels applied on the resource
relation

string

Definisce la relazione della risorsa con gli eventi

AppliedLabel

Dettagli dell'etichetta applicata alla risorsa.

Rappresentazione JSON 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
Campi
id

string

Identificatore dell'etichetta: solo l'ID etichetta, non il nome risorsa OnePlatform completo.
title

string

Titolo dell'etichetta
fieldValues[]

object (FieldValue)

activities.list of fields which are part of the label and have been set by the user. Se l'etichetta ha un campo non impostato dall'utente, non sarà presente in questo elenco.
reason

object (Reason)

Il motivo per cui l'etichetta è stata applicata alla risorsa.

FieldValue

Dettagli del valore del campo impostato dall'utente per l'etichetta specifica.

Rappresentazione JSON 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  // Union field value can be only one of the following:
  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Campi
id

string

Identificatore del campo
displayName

string

Nome visualizzato del campo
type

string

Tipo di campo
reason

object (Reason)

Il motivo per cui il campo è stato applicato all'etichetta.
Campo unione value. I valori memorizzati nel campo value possono essere solo uno dei seguenti:
unsetValue

boolean

Se il campo non è impostato, questo valore è true.
longTextValue

string

Impostazione di un valore di testo lungo.
textValue

string

Impostazione di un valore di testo.
textListValue

object (TextListValue)

Impostazione di un valore dell'elenco di testo.
selectionValue

object (SelectionValue)

Impostazione di un valore di selezione scegliendo un singolo valore da un menu a discesa.
selectionListValue

object (SelectionListValue)

Impostazione di un valore dell'elenco di selezione selezionando più valori da un menu a discesa.
integerValue

string (int64 format)

Impostazione di un valore intero.
userValue

object (UserValue)

Impostazione di un valore utente selezionando un singolo utente.
userListValue

object (UserListValue)

Impostazione di un valore dell'elenco utenti selezionando più utenti.
dateValue

object (Date)

Impostazione di un valore di data.

TextListValue

Impostazione di un valore dell'elenco di testo.

Rappresentazione JSON 
{
  "values": [
    string
  ]
}
Campi
values[]

string

activities.list of text values.

SelectionValue

Impostazione di un valore di selezione scegliendo un singolo valore da un menu a discesa.

Rappresentazione JSON 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
Campi
id

string

Identificatore della selezione.
displayName

string

Nome visualizzato della selezione.
badged

boolean

Se la selezione è contrassegnata da un badge.

SelectionListValue

Impostazione di un valore dell'elenco di selezione selezionando più valori da un menu a discesa.

Rappresentazione JSON 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
Campi
values[]

object (SelectionValue)

activities.list of selections.

UserValue

Impostazione di un valore utente selezionando un singolo utente.

Rappresentazione JSON 
{
  "email": string
}
Campi
email

string

Email dell'utente.

UserListValue

Impostazione di un valore dell'elenco utenti selezionando più utenti.

Rappresentazione JSON 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
Campi
values[]

object (UserValue)

activities.list of users.

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 sono irrilevanti. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • 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:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

L'anno della data. Deve essere compreso tra 1 e 9999 o tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure compreso tra 0 e 31 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

string

Il tipo di motivo.