Il report sull'utilizzo delle entità restituisce le attività del servizio Google Workspace relative alle entità utilizzati dagli utenti del tuo account. Questi report possono essere personalizzati e filtrati per utilizzo specifico informazioni. I dati sono disponibili per gli ultimi 30 giorni.
Il report sull'utilizzo delle entità può essere usato solo per scopi legittimi in in conformità con il Contratto con il cliente. Questi report si applicano anche Google Workspace ed Education.
Recupera le attività di utilizzo di tutte le entità
Attualmente, l'unico tipo di entità supportato da questa API sono le community Google+. Per recuperare un
di tutte le attività relative alle entità dell'app nel tuo account, usa quanto segue
GET
Richiesta HTTP e includi il token di autorizzazione descritto nell'
documentazione sull'autorizzazione. Per
la leggibilità, l'esempio seguente è formattato con i ritorni a capo:
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/date ?parameters=applicationParameters &filters=parameterFilters &maxResults=maxResults
Il valore date è la data in cui si è verificato l'utilizzo e il timestamp si trova nella Formato ISO 8601, aaaa-mm-gg. Ti consigliamo utilizza il fuso orario del tuo account. Per ulteriori informazioni sui parametri della stringa di query e proprietà della risposta, consulta le Riferimento. Per informazioni sui parametri dei report sull'utilizzo delle entità, consulta Parametri di utilizzo delle entità riferimento.
applicationParameters è un elenco di parametri separati da virgole che vuoi recuperare.
Ogni parametro ha il formato application:parameter_name
, ad esempio
gplus:community_name
. I parametri disponibili sono documentati in
Parametri di utilizzo delle entità
riferimento. Se non viene specificato nessun parametro, vengono restituiti tutti i parametri.
parameterFilters è un elenco di filtri separati da virgole da applicare ai risultati. Ciascuna
il filtro è formattato come
application:parameter_name[relational_operator]parameter_value
. Ad esempio,
filtro gplus:num_total_members>100
filtra i risultati in modo che contengano solo risultati
in cui il parametro gplus:num_total_members
ha un valore maggiore di 100.
maxResults è il numero massimo di risultati da restituire in un singolo recupero. Se il totale
di risultati è maggiore di questo valore, la risposta verrà troncata
Verranno inclusi nextPageToken
(vedi il
esempio di risposta JSON di seguito).
Esempi
L'esempio seguente restituisce un report contenente tutti i parametri
per tutte le entità gplus_communities
.
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all /dates/2017-12-11
L'esempio seguente restituisce un report contenente il parametro community_name
per tutte le entità gplus_communities
.
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all /dates/2017-12-11?parameters=gplus:community_name
L'esempio seguente restituisce un report di community_name
num_total_members
per ogni entità gplus_communities
, filtrato in base a
community con più di 100 membri. Per un esempio di risposta dell'API, consulta
Esempio di risposta JSON.
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-11 ?parameters=gplus:community_name,gplus:num_total_members&filters=gplus:num_total_members>100
Recuperare un report per un'entità specifica
Per recuperare un report per un'entità specifica, utilizza la seguente richiesta HTTP GET
e
includere il token di autorizzazione descritto
documentazione sull'autorizzazione. Per
la leggibilità, l'esempio seguente è formattato con i ritorni a riga di comando.
GET https://admin.googleapis.com/admin/reports/v1/gplus_communities/entityKey/dates/date ?parameters=applicationParameters &filters=parameterFilters &maxResults=maxResults
entityKey è un identificatore di entità specifico per l'applicazione in cui la vita dell'entità. Consulta l'API Riferimento per i dettagli su come ottenere il entityKey per l'entità specifica che a cui sono interessati. Gli altri parametri sono indicati sopra in Recupera tutte le attività di utilizzo delle entità.
Per ulteriori informazioni sui parametri della stringa di query e sulle proprietà della risposta, consulta Riferimento API. Per informazioni sui parametri dei report sull'utilizzo delle entità, consulta Parametri di utilizzo delle entità riferimento.
Esempi
L'esempio seguente restituisce il report sulle entità per un'entità gplus_community
con
entityKey "1234".
https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/1234/dates/2017-12-11
Esempio di risposta JSON per il report sull'utilizzo
Una risposta corretta restituisce un codice di stato HTTP 200. Insieme a il codice di stato, la risposta restituisce un report. Alcuni dei parametri della risposta sono stati omessi per migliorare la leggibilità.
Esempio di risposta JSON per il report sulle entità
{ "kind": "reports#usageReports", "nextPageToken": "NjQ1OTgwODk0MzkxNDAwNjQ0OA", "usageReports": [ { "kind": "admin#reports#usageReport", "date": "2017-12-11", "entity": { "type": "OBJECT", "customerId": "C03az79cb", "objectType": "GPLUS_COMMUNITY", "objectId": "1234", }, "parameters": [ { "name": "gplus:community_name", "stringValue": "My Community" }, { "name": "gplus:num_total_members", "intValue": 37 }, { "name": "gplus:num_7day_active_members", "intValue": 12 }, { "name": "gplus:num_30day_active_members", "intValue": 17 }, ] } ] }
Esempio di risposta JSON per il report sulle entità con avvisi
Se la richiesta non può essere soddisfatta, è possibile che nella risposta vengano restituiti uno o più avvisi. In questo Ad esempio, il report non è disponibile nel momento in cui viene effettuata la richiesta.{ "kind": "reports#usageReports", "warnings": [ { "code": "PARTIAL_DATA_AVAILABLE" "message": "Data for date 2017-12-11 for application gplus is not available right now, please try again after a few hours." "data": [ { "key": "date" "value": "2017-12-11" } ] } ], "usageReports": [], }Ogni voce nell'array
warnings
ha i seguenti parametri:
- .
code
: codice di avviso leggibile dal computermessage
: messaggio di avviso leggibiledata
: elenco di coppie chiave/valore che forniscono informazioni di avviso dettagliate