Method: projects.getMetrics

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.

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

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".