Method: activities.watch

Inizia a ricevere notifiche per le attività dell'account. Per ulteriori informazioni, vedi Ricezione di notifiche push.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userKey or all

string

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

enum (ApplicationName)

Nome dell'applicazione per cui devono essere recuperati gli eventi.

Parametri di ricerca

Parametri
actorIpAddress

string

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

string

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

string

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:

  • 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 visualizzato nel report. Il valore startTime deve essere precedente al valore endTime (se specificato) e all'ora corrente 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, 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 il valore 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

string

Il nome dell'evento su cui l'API esegue la query. 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 include 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 sui parametri e sulle stringhe di query di 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 sono nel 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 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 è composto 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".
  • <>: "non uguale a". Deve essere codificato come URL (%3C%3E).
  • <: "minore di". 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 di o uguale a". Deve essere codificato come 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 ignora quel parametro e restituisce la risposta corrispondente ai restanti parametri validi. Se non vengono richiesti parametri, vengono restituiti tutti i parametri.
maxResults

integer

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

string

Deprecated. Questo campo è obsoleto e non è più supportato.

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

string

Il token per specificare la pagina successiva. Un report con più pagine ha una proprietà nextPageToken nella risposta. Nella richiesta successiva che rimanda alla 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. Il formato della data è RFC 3339, ad esempio 2010-10-28T10:26:35.000Z. Il report restituisce tutte le attività dal giorno startTime fino al giorno endTime. Il valore startTime deve essere precedente al valore endTime (se specificato) e all'ora corrente in cui viene effettuata la richiesta, altrimenti l'API restituisce un errore.
groupIdFilter

string

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 contiene un'istanza di SubscriptionChannel.

Corpo della risposta

Un canale di notifica utilizzato per controllare le modifiche alle risorse.

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

Rappresentazione JSON 
{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}
Campi
id

string

Un UUID o una stringa univoca simile che identifica il canale.
token

string

Una stringa arbitraria inviata all'indirizzo di destinazione con ogni notifica inviata attraverso questo canale. Campo facoltativo.
expiration

string (int64 format)

Data e ora di scadenza del canale di notifica, espresse come timestamp Unix, in millisecondi. Campo facoltativo.
type

string

Il tipo di meccanismo di pubblicazione utilizzato per questo canale. Il valore deve essere impostato su "web_hook".
address

string

L'indirizzo a cui vengono inviate le notifiche per questo canale.
payload

boolean

Un valore booleano per indicare se è richiesto il payload. Un payload è costituito da dati inviati nel corpo di un messaggio HTTP POST, PUT o PATCH e contiene informazioni importanti sulla richiesta. Campo facoltativo.
params

map (key: string, value: string)

Parametri aggiuntivi che controllano il comportamento del canale di pubblicazione. Campo facoltativo.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
resourceId

string

Un ID opaco che identifica la risorsa visitata su questo canale. Stabile in diverse versioni dell'API.
resourceUri

string

Un identificatore specifico della versione per la risorsa monitorata.
kind

string

Identifica questo canale come canale di notifica utilizzato per controllare le modifiche apportate a una risorsa, ovvero "api#channel".

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

Nome dell'applicazione per cui devono essere recuperati gli eventi.

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 e Google Workspace 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.