Method: projects.getMetrics

取得指令碼的指標資料，例如執行次數和活躍使用者人數。

HTTP 要求

GET https://script.googleapis.com/v1/projects/{scriptId}/metrics

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
scriptId

string

必填欄位，用於指出要取得指標的指令碼。

查詢參數

參數
metricsGranularity

enum (MetricsGranularity)

用來指出傳回指標精細程度的必填欄位。
metricsFilter

object (MetricsFilter)

選填欄位，包含要套用至要求的篩選器。這個做法可將傳回的指標範圍限制在篩選器中指定的指標。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

資源包含特定指令碼的使用統計資料 (以要求中提供的篩選器和遮罩為依據)。

JSON 表示法 
{
  "activeUsers": [
    {
      object (MetricsValue)
    }
  ],
  "totalExecutions": [
    {
      object (MetricsValue)
    }
  ],
  "failedExecutions": [
    {
      object (MetricsValue)
    }
  ]
}
欄位
activeUsers[]

object (MetricsValue)

活躍使用者人數。
totalExecutions[]

object (MetricsValue)

總執行作業數量。
failedExecutions[]

object (MetricsValue)

失敗的執行作業數量。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/script.metrics

詳情請參閱 OAuth 2.0 總覽。

MetricsGranularity

要傳回資料的指標精細程度。

列舉
UNSPECIFIED_GRANULARITY 用於查詢沒有任何指標的預設指標精細程度。
WEEKLY 代表每週指標。
DAILY 代表 7 天內的每日指標。

MetricsFilter

用於縮減要求範圍的篩選器。

JSON 表示法 
{
  "deploymentId": string
}
欄位
deploymentId

string

選填欄位，表示要擷取指標的特定部署作業。

MetricsValue

記錄執行作業次數的指標值。

JSON 表示法 
{
  "value": string,
  "startTime": string,
  "endTime": string
}
欄位
value

string

指出已計算的執行作業數量。
startTime

string (Timestamp format)

必填欄位，指出間隔的開始時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

必填欄位，用來表示間隔的結束時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。