Method: domains.trafficStats.list

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

사용 가능한 모든 날짜의 트래픽 통계를 표시합니다. 사용자에게 도메인의 트래픽 통계에 대한 액세스 권한이 없으면 PERMISSION_DENIED를 반환합니다.

HTTP 요청

GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

트래픽 통계를 표시할 도메인의 리소스 이름입니다. domains/{domain_name} 형식이어야 합니다. 여기서 domain_name은 정규화된 도메인 이름입니다.

쿼리 매개변수

매개변수
startDate

object (Date)

측정항목을 가져올 초기 기간의 시작일입니다. startDate와 endDate는 모두 지정하거나 둘 다 지정하지 않아야 합니다. 하나만 지정되거나 endDate가 startDate보다 이전인 경우 INVALID_ARGUMENT가 반환됩니다.
endDate

object (Date)

제외를 가져올 측정항목의 가장 최근 날짜입니다. startDate와 endDate는 모두 지정하거나 둘 다 지정하지 않아야 합니다. 하나만 지정되거나 endDate가 startDate보다 이전인 경우 INVALID_ARGUMENT가 반환됩니다.
pageSize

integer

요청한 페이지 크기입니다. 서버가 요청된 트래픽 통계보다 적은 수를 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
pageToken

string

이전 List 요청에서 반환된 nextPageToken 값입니다(있는 경우). 이전 trafficStats.list 메서드 호출에서 반환된 ListTrafficStatsResponse.next_page_token의 값입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

trafficStats.list에 대한 응답 메시지입니다.

JSON 표현 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
필드
trafficStats[]

object (TrafficStats)

TrafficStats 목록입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰으로, 목록에 결과가 더 이상 없으면 비어 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/postmaster.readonly

자세한 내용은 OAuth 2.0 개요를 참고하세요.

날짜

생일과 같은 캘린더 날짜 전체 또는 일부를 나타냅니다. 시간 및 시간대는 다른 곳에서 지정하거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0인 전체 날짜
  • 0년이 되는 연월일 (예: 기념일)
  • 그 자체로 1년이며 0개월과 0일입니다.
  • 연도와 월, 0일 (예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜 연도입니다. 1~9,999 사이의 값이어야 하며, 1년 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

월 범위는 1~12여야 합니다. 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

날짜입니다. 1~31 사이의 값이어야 하며 연과월에 유효해야 합니다. 단, 연도를 직접 지정하거나 연도가 중요하지 않은 연도와 월을 지정해야 합니다.