사용 가능한 모든 날짜의 트래픽 통계를 나열합니다. 사용자에게 도메인의 TrafficStats에 액세스할 권한이 없는 경우 PERMISSION_DENIED를 반환합니다.
HTTP 요청
GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
트래픽 통계를 나열할 도메인의 리소스 이름입니다. |
쿼리 매개변수
매개변수 | |
---|---|
startDate |
검색할 측정항목의 가장 이른 날짜입니다(해당 날짜 포함). startDate 및 endDate를 모두 지정하거나 지정하지 않아야 합니다. 하나만 지정하거나 endDate가 startDate보다 이전인 경우 INVALID_SQLite가 반환됩니다. |
endDate |
제외할 측정항목의 가장 최근 날짜입니다. startDate 및 endDate를 모두 지정하거나 지정하지 않은 상태로 두어야 합니다. 하나만 지정하거나 endDate가 startDate보다 이전인 경우 INVALID_SQLite가 반환됩니다. |
pageSize |
요청한 페이지 크기입니다. 서버가 요청한 것보다 적은 TrafficStats를 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다. |
pageToken |
이전 List 요청에서 반환된 nextPageToken 값입니다(있는 경우). 이전 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
trafficStats.list의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"trafficStats": [
{
object ( |
필드 | |
---|---|
trafficStats[] |
TrafficStats의 목록입니다. |
nextPageToken |
결과의 다음 페이지를 검색하는 토큰으로, 목록에 결과가 더 이상 없으면 비어 있습니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/postmaster.readonly
자세한 내용은 승인 가이드를 참고하세요.
날짜
생일과 같은 캘린더 날짜 전체 또는 일부를 나타냅니다. 하루 중 시간과 시간대가 다른 곳에 지정되어 있거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 0년입니다 (예: 기념일).
- 1년은 자체적으로, 월은 0이고 나머지는 0일입니다.
- 연도와 월을 0일로 표시 (예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 표현 |
---|
{ "year": integer, "month": integer, "day": integer } |
필드 | |
---|---|
year |
날짜의 연도입니다. 1~9999 사이의 값이어야 합니다. 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
월입니다. 1~12 사이의 값이어야 합니다. 월과 일 없이 연도를 지정하려면 0과 같아야 합니다. |
day |
날짜입니다. 1~31 사이의 값이어야 하며 연도와 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다. |