Questa pagina è stata tradotta dall'API Cloud Translation.

Method: activities.list

Richiesta HTTP
Parametri del percorso
Parametri di ricerca
Corpo della richiesta
Corpo della risposta
- Rappresentazione JSON
Ambiti di autorizzazione
ApplicationName
Attività
- Rappresentazione JSON
  - Rappresentazione JSON
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 saperne di più, consulta le guide per i report sulle attività degli amministratori e di Google Drive. Per ulteriori informazioni sui parametri del report 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

Parametri
`userKey`	`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 il suo 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.

userKey

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 il suo 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 query

Parametri
`actorIpAddress`	`string` 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 l'indirizzo di una rete privata virtuale (VPN). Questo parametro supporta sia le versioni di indirizzi IPv4 sia quelle IPv6.
`customerId`	`string` L'ID univoco del cliente per cui recuperare i dati.
`endTime`	`string` 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 API. Un report dell'API ha tre concetti di tempo di base: Data della richiesta dell'API di un report: la data in cui l'API ha creato e recuperato il report. Ora di inizio del report: l'inizio dell'intervallo di tempo visualizzato nel report. `startTime` deve essere precedente al valore `endTime` (se specificato) e all'ora attuale in cui viene effettuata la 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à dal giorno `startTime` fino all'ora corrente o agli ultimi 180 giorni se `startTime` è più lontano di 180 giorni nel passato.
`eventName`	`string` Il nome dell'evento oggetto della query dall'API. Ogni `eventName` è correlato a una funzionalità o a un servizio Google Workspace specifico 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 Impostazioni di Calendar `type` contiene tutte le attività di Calendar `eventName` registrate dall'API. Quando un amministratore modifica un'impostazione di Calendar, l'API registra questa attività nei parametri Impostazioni di Calendar `type` e `eventName`. Per ulteriori informazioni sulle stringhe di query e sui parametri `eventName`, consulta l'elenco dei nomi di 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. Viene restituito un report vuoto se il parametro della richiesta non appartiene a `eventName`. Per saperne di più sui campi `eventName` disponibili per ogni applicazione e sui relativi parametri associati, vai alla tabella ApplicationName, quindi fai clic sulla pagina Eventi attività nell'appendice per l'applicazione che ti interessa. Nei seguenti esempi di attività di Drive, 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 `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 questi operatori di relazione: `==`—"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 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 del 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`	`integer` Determina il numero di record delle attività da mostrare in ogni pagina di risposta. Ad esempio, se la richiesta imposta `maxResults=1` e il report contiene 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 delle 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 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 `startTime` al giorno `endTime`. `startTime` deve essere precedente al valore `endTime` (se specificato) e all'ora attuale in cui viene effettuata la richiesta, altrimenti l'API restituisce un errore.
`groupIdFilter`	`string` 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 (`Activity`) } ], "nextPageToken": string }

Campi
`kind`	`string` Il tipo di risorsa API. Per un report sulle 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 sui diversi tipi di eventi relativi alle attività di Access Transparency.
`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 alle attività del calendario.
`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à 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à del 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 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 di attività degli 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 ChromeOS.
`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

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`) } ] } ] } ] } ], "id": { "time": string, "uniqueQualifier": string, "applicationName": string, "customerId": string }, "actor": { "profileId": string, "email": string, "callerType": string, "key": string } }

{
  "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)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}

Campi
`kind`	`string` Il tipo di risorsa API. Per un report sulle attività, il valore è `audit#activity`.
`etag`	`string` ETag della voce.
`ownerDomain`	`string` 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`	`string` 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 un indirizzo di 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à di Google Workspace modificati da un amministratore è identificato nella proprietà `type` che identifica un evento utilizzando la proprietà `eventName`. Per un elenco completo delle categorie `type` dell'API, consulta l'elenco dei nomi degli eventi per le varie applicazioni sopra in `applicationName`.
`events[].name`	`string` Nome dell'evento. Si tratta del nome specifico dell'attività registrata dall'API. Inoltre, ogni `eventName` è correlato a una funzionalità o a un servizio Google Workspace specifico che l'API organizza in tipi di eventi. Per i parametri di richiesta `eventName` in generale: Se non viene specificato 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 le varie applicazioni in `applicationName`.
`events[].parameters[]`	`object` Coppie di valori parametro per varie applicazioni. Per ulteriori informazioni sui parametri `eventName`, consulta l'elenco dei nomi degli eventi per le varie applicazioni sopra in `applicationName`.
`events[].parameters[].messageValue`	`object` 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 `[{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 oggetti `messageValue`.
`events[].parameters[].multiMessageValue[].parameter[]`	`object (NestedParameter)` Valori parametro
`id`	`object` Identificatore univoco per ogni record di attività.
`id.time`	`string` Ora di occorrenza dell'attività. Si tratta del tempo UNIX epoch in secondi.
`id.uniqueQualifier`	`string (int64 format)` Qualificatore univoco se più eventi hanno lo stesso orario.
`id.applicationName`	`string` Nome dell'applicazione a cui appartiene l'evento. Per i possibili valori, consulta l'elenco delle applicazioni sopra in `applicationName`.
`id.customerId`	`string` L'identificatore univoco di un account Google Workspace.
`actor`	`object` 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 di Google Workspace o può essere il numero 105250506097979753968 che funge da ID segnaposto.
`actor.email`	`string` L'indirizzo email principale dell'attore. Può 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 il `consumer_key` dell'autore della richiesta per le richieste dell'API OAuth 2LO o un identificatore per gli account robot.