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 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

表示间隔的结束时间的必填字段。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"