Method: projects.getMetrics

스크립트의 측정항목 데이터(예: 실행 수 및 활성 사용자 수)를 가져옵니다.

HTTP 요청

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

URL은 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 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
endTime

string (Timestamp format)

간격의 종료 시간을 나타내는 필수 필드입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.