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 개요를 참고하세요.

측정항목 세부사항

데이터를 반환할 측정항목의 세부사항입니다.

열거형
UNSPECIFIED_GRANULARITY 측정항목을 쿼리하는 데 사용되는 기본 측정항목 세부사항입니다.
WEEKLY 주간 측정항목을 나타냅니다.
DAILY 7일 동안의 일일 측정항목을 나타냅니다.

측정항목 필터

요청 범위를 줄이는 데 사용되는 필터입니다.

JSON 표현
{
  "deploymentId": string
}
필드
deploymentId

string

측정항목을 가져올 특정 배포를 나타내는 필드(선택사항)입니다.

측정항목 값

집계된 실행 수를 포함하는 측정항목 값입니다.

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