Method: entityUsageReports.get

Recupera un report che è una raccolta di proprietà e statistiche relative alle entità utilizzate dagli utenti all'interno dell'account. Per ulteriori informazioni, consulta la guida Report sull'utilizzo delle entità. Per ulteriori informazioni 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 eventi 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 ricerca

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 di cui viene restituito l'utilizzo nel report. I valori dell'applicazione nel report Utilizzo delle entità includono accounts, docs e gmail.

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

In questo esempio, l 'operatore "non uguale a" di <> è codificato come 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". È codificato nell'URL (%3C%3E).
  • < - "minore di". È codificato nell'URL (%3C).
  • <=: "minore di o uguale a". È codificato nell'URL (%3C=).
  • > - "maggiore di". È codificato nell'URL (%3E).
  • >=: "maggiore di o uguale a". È codificato nell'URL (%3E=).
I filtri possono essere applicati solo ai parametri numerici.
maxResults

integer (uint32 format)

Determina il numero di record di attività visualizzati in ogni pagina di risposta. Ad esempio, se la richiesta imposta <span>maxResults=1</span> e il report contiene due attività, avrà due pagine. La proprietà <span>nextPageToken</span> della risposta ha 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 di follow-on relativa alla 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 Utilizzo entità sono solo gplus.
Una stringa di query parameter è in formato CSV di [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 alle autorizzazioni.

EntityType

Enum
gplus_communities Restituisce un report sulle community Google+.