Method: projects.getMetrics  |  Apps Script  |  Google for Developers (original) (raw)

Method: projects.getMetrics

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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 string Campo obbligatorio che indica lo script per il quale ottenere le metriche.

Parametri di query

Parametri
metricsGranularity enum (MetricsGranularity) Campo obbligatorio che indica il livello di granularità delle metriche restituite.
metricsFilter object (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 (MetricsValue) } ], "totalExecutions": [ { object (MetricsValue) } ], "failedExecutions": [ { object (MetricsValue) } ] }
Campi
activeUsers[] object (MetricsValue) Numero di utenti attivi.
totalExecutions[] object (MetricsValue) Numero di esecuzioni totali.
failedExecutions[] object (MetricsValue) Numero di esecuzioni non riuscite.

Richiede il seguente ambito OAuth:

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 string 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 string Indica il numero di esecuzioni conteggiate.
startTime string (Timestamp format) 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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime string (Timestamp format) 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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.

Ultimo aggiornamento 2024-09-12 UTC.