- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- MetricsGranularity
- MetricsFilter
- MetricsValue
- Prova!
Consente di recuperare i dati delle metriche per gli script, ad esempio numero di esecuzioni e utenti attivi.
Richiesta HTTP
GET https://script.googleapis.com/v1/projects/{scriptId}/metrics
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
scriptId |
Campo obbligatorio che indica lo script per il quale ottenere le metriche. |
Parametri di query
Parametri | |
---|---|
metricsGranularity |
Campo obbligatorio che indica il livello di granularità delle metriche restituite. |
metricsFilter |
Campo facoltativo contenente i filtri da applicare alla richiesta. Questo limita l'ambito delle metriche restituite a quelle specificate nel filtro. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Risorsa contenente le statistiche sull'utilizzo per un determinato script, in base al filtro e alla maschera forniti presenti nella richiesta.
Rappresentazione JSON |
---|
{ "activeUsers": [ { object ( |
Campi | |
---|---|
activeUsers[] |
Numero di utenti attivi. |
totalExecutions[] |
Numero di esecuzioni totali. |
failedExecutions[] |
Numero di esecuzioni non riuscite. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/script.metrics
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
MetricsGranularity
La granularità della metrica per cui restituire i dati.
Enum | |
---|---|
UNSPECIFIED_GRANULARITY |
Granularità della metrica predefinita utilizzata per non eseguire query sulle metriche. |
WEEKLY |
Rappresenta le metriche settimanali. |
DAILY |
Rappresenta le metriche giornaliere in un periodo di 7 giorni. |
MetricsFilter
Filtro utilizzato per ridurre l'ambito della richiesta.
Rappresentazione JSON |
---|
{ "deploymentId": string } |
Campi | |
---|---|
deploymentId |
Campo facoltativo che indica un deployment specifico da cui recuperare le metriche. |
MetricsValue
Valore delle metriche che contiene il numero di esecuzioni conteggiate.
Rappresentazione JSON |
---|
{ "value": string, "startTime": string, "endTime": string } |
Campi | |
---|---|
value |
Indica il numero di esecuzioni conteggiate. |
startTime |
Campo obbligatorio che indica l'ora di inizio dell'intervallo. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
endTime |
Campo obbligatorio che indica l'ora di fine dell'intervallo. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |