Method: entityUsageReports.get

Recupera un report che è una raccolta di proprietà e statistiche sulle entità utilizzate dagli utenti all'interno dell'account. Per saperne di più, consulta la guida al Report sull'utilizzo delle entità. Per saperne di più sui parametri del report sulle entità, consulta le guide di riferimento Parametri di utilizzo delle entità.

Richiesta HTTP

GET https://admin.googleapis.com/admin/reports/v1/usage/{entityType}/{entityKey or all}/dates/{date}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
entityType

enum (EntityType)

Rappresenta il tipo di entità per il report.
entityKey or all

string

Rappresenta la chiave dell'oggetto con cui filtrare i dati. È una stringa che può assumere il valore all per ottenere gli eventi di attività per tutti gli utenti o qualsiasi altro valore per un'entità specifica dell'app. Per informazioni dettagliate su come ottenere entityKey per un determinato entityType, consulta le guide di riferimento Parametri di utilizzo delle entità.
date

string

Rappresenta la data in cui si è verificato l'utilizzo, in base al fuso orario UTC-8:00 (Pacific Standard Time). Il timestamp è nel formato ISO 8601, yyyy-mm-dd.

Parametri di query

Parametri
customerId

string

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

string

La stringa di query filters è un elenco separato da virgole dei parametri evento di un'applicazione in cui il valore del parametro viene manipolato da un operatore relazionale. La stringa di query filters include il nome dell'applicazione il cui utilizzo viene restituito nel report. I valori dell'applicazione per il report Utilizzo entità includono accounts, docs e gmail.

Il formato dei filtri è [application name]:[parameter name][relational operator][parameter value],....

In questo esempio, il valore <> "diverso da" l'operatore è codificato nell'URL nella stringa di query della richiesta (%3C%3E): 

GET
https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0

Gli operatori relazionali includono:

  • ==: "uguale a".
  • <>: "non uguale a". Con codifica URL (%3C%3E).
  • <: "minore di". Con codifica URL (%3C).
  • <=: "minore o uguale a". Con codifica URL (%3C=).
  • >: "maggiore di". Con codifica URL (%3E).
  • >=: "maggiore o uguale a". Con codifica URL (%3E=).
I filtri possono essere applicati solo ai parametri numerici.
maxResults

integer (uint32 format)

Determina il numero di record delle attività visualizzati in ciascuna pagina di risposta. Ad esempio, se la richiesta imposta <span>maxResults=1</span> e il report ha due attività, avrà due pagine. La proprietà <span>nextPageToken</span> della risposta include il token per la seconda pagina.
pageToken

string

Token per specificare la pagina successiva. Un report con più pagine ha una proprietà nextPageToken nella risposta. Nella richiesta successiva per visualizzare la pagina successiva del report, inserisci il valore nextPageToken nella stringa di query pageToken.
parameters

string

La stringa di query parameters è un elenco separato da virgole di parametri evento che perfezionano i risultati di un report. Il parametro è associato a un'applicazione specifica. I valori dell'applicazione per il report sull'utilizzo delle entità sono solo gplus.
Una stringa di query parameter è nel formato CSV [app_name1:param_name1], [app_name2:param_name2]....

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di UsageReports.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/admin.reports.usage.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

EntityType

Enum
gplus_communities Restituisce un report sulle community Google+.