Questa pagina è stata tradotta dall'API Cloud Translation.

Method: activities.watch

Richiesta HTTP
Parametri del percorso
Parametri di ricerca
Corpo della richiesta
Corpo della risposta
- Rappresentazione JSON
Ambiti di autorizzazione
ApplicationName

Inizia a ricevere notifiche per le attività dell'account. Per ulteriori informazioni, consulta la sezione 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

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.

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.
`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 (deprecated)`	`string` `Deprecated`. Questo campo è deprecato e non è più supportato. 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. I dati precedenti al 17 dicembre 2018 non vengono visualizzati nei risultati filtrati.
`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.
`groupIdFilter (deprecated)`	`string` `Deprecated`. Questo campo è deprecato e non è più supportato. 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" Importante:per filtrare in base ai gruppi, devi aggiungerli esplicitamente alla lista consentita dei gruppi filtro. Per saperne di più sull'aggiunta di gruppi alla lista consentita dei gruppi filtro, vedi Filtrare i risultati in base a Google Gruppi .

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di SubscriptionChannel.

Corpo della risposta

Un canale di notifica utilizzato per monitorare 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 }

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 questo canale.
`token`	`string` Una stringa arbitraria inviata all'indirizzo di destinazione con ogni notifica inviata tramite questo canale. Facoltativo.
`expiration`	`string (int64 format)` Data e ora di scadenza del canale di notifica, espresse come timestamp Unix, in millisecondi. 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 che indica se il payload è richiesto. Un payload è un insieme di dati inviati nel corpo di un messaggio HTTP POST, PUT o PATCH e contiene informazioni importanti sulla richiesta. Facoltativo.
`params`	`map (key: string, value: string)` Parametri aggiuntivi che controllano il comportamento del canale di distribuzione. Facoltativo. Un oggetto contenente un elenco di coppie `"key": value`. Esempio: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`resourceId`	`string` Un ID opaco che identifica la risorsa visualizzata su questo canale. Stabile in diverse versioni dell'API.
`resourceUri`	`string` Un identificatore specifico della versione per la risorsa visualizzata.
`kind`	`string` Identifica questo canale di notifica utilizzato per monitorare le modifiche 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