승인 필요
쿼리 매개변수에서 전송한 보고서 요청을 바탕으로 애드센스 보고서를 생성합니다. JSON 형식으로 결과를 반환하며, CSV 형식으로 출력을 검색하려면 'alt=csv'를 검색어 매개변수로 지정합니다. 직접 해보기
요청
HTTP 요청
GET https://www.googleapis.com/adsense/v1.4/reports
매개변수
매개변수 이름 | 값 | 설명 |
---|---|---|
필수 검색어 매개변수 | ||
endDate | string | 'YYYY-MM-DD' 형식의 보고서 기간 종료일(종료일 포함)입니다. |
startDate | string | 'YYYY-MM-DD' 형식의 보고서 기간 시작일(시작일 포함)입니다. |
선택 검색어 매개변수 | ||
accountId | string | 보고할 계정입니다. |
currency | string | 금액 측정항목을 보고할 때 사용할 통화입니다. 설정하지 않으면 계정 통화로 기본 설정됩니다. |
dimension | string | 보고서를 생성할 때 기초가 되는 측정기준입니다. 사용 가능한 측정 기준은 측정항목 및 측정기준에 설명되어 있습니다. 각각의 측정기준에 대해 자세히 알아보려면 애드센스 용어집을 참조하세요. |
filter | string | 보고서에 적용할 필터입니다. |
locale | string | 결과 보고서를 현지 언어로 번역할 때 사용할 선택 언어입니다. 지정하지 않으면 기본값인 'en_US'가 사용됩니다. |
maxResults | integer | 반환할 보고서 데이터의 최대 행 수입니다. startIndex가 설정하지 않은 상태이거나 0이면 API에서 maxResults 값에 의해 지정된 수만큼 행을 반환합니다. maxResults가 설정되지 않으면 최대 50,000행 내에서 해당되는 모든 행이 반환됩니다. startIndex가 0 이외의 값으로 설정되는 경우 startIndex와 maxResults의 합계는 5,000을 넘을 수 없습니다. 이 수치를 넘을 경우 5,000개를 초과하는 페이지는 지원되지 않는다는 내용의 오류가 반환됩니다. 사용 가능한 값: 0 ~50000 |
metric | string | 보고서를 생성할 때 기초가 되는 측정항목입니다. 사용 가능한 측정항목은 측정항목 및 측정기준에 설명되어 있습니다. 각각의 측정항목에 대해 자세히 알아보려면 애드센스 용어집을 참조하세요. |
sort | string | 결과 보고서를 정렬할 측정기준 또는 측정항목의 이름입니다. 오름차순으로 정렬하려면 '+'를, 내림차순으로 정렬하려면 '-'를 프리픽스로 추가합니다(선택). 프리픽스가 지정되지 않으면 항목이 오름차순으로 정렬됩니다. |
startIndex | integer | 반환할 보고서 데이터의 첫 번째 행의 색인입니다. startIndex가 설정하지 않은 상태이거나 0이면 API에서 maxResults 값에 의해 지정된 수만큼 행을 반환합니다. maxResults가 설정되지 않으면 최대 50,000행 내에서 해당되는 모든 행이 반환됩니다. startIndex가 0 이외의 값으로 설정되는 경우 startIndex와 maxResults의 합계는 5,000을 넘을 수 없습니다. 이 수치를 넘을 경우 5,000개를 초과하는 페이지는 지원되지 않는다는 내용의 오류가 반환됩니다. 사용 가능한 값: 0 ~5000 |
useTimezoneReporting | boolean | 보고서가 애드센스 계정의 현지 시간대를 반영해 생성되는지 여부입니다. 거짓(false)이면 기본 PST/PDT 시간대가 사용됩니다. |
승인
이 요청을 처리하려면 아래 범위 중 하나 이상에서 승인을 받아야 합니다(인증 및 승인에 대해 자세히 알아보기).
범위 |
---|
https://www.googleapis.com/auth/adsense |
https://www.googleapis.com/auth/adsense.readonly |
요청 본문
요청 본문에서 이 메소드를 사용하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
JSON
{ "kind": "adsense#report", "totalMatchedRows": long, "headers": [ { "name": string, "type": string, "currency": string } ], "rows": [ [ string ] ], "totals": [ string ], "averages": [ string ], "warnings": [ string ], "startDate": string, "endDate": string }
속성 이름 | 값 | 설명 | 참고 |
---|---|---|---|
kind | string | 유형(이 경우 adsense#report)입니다. | |
totalMatchedRows | long | 보고서 요청과 일치하는 전체 행 수입니다. 요청된 행의 수 또는 보고서 행 수 한도에 의해 일부 행만 반환될 수 있습니다. | |
headers[] | list | 보고서 연산에서 요청된 항목의 헤더 정보입니다. 헤더의 목록으로 요청된 각 측정기준 및 보고서의 각 측정항목에 대해 헤더가 하나씩 포함됩니다. | |
headers[].name | string | 헤더의 이름입니다. | |
headers[].type | string | 헤더의 유형이며 DIMENSION, METRIC_TALLY, METRIC_RATIO, METRIC_CURRENCY 중 하나입니다. 사용 가능한 값:
| |
headers[].currency | string | 이 항목의 통화 단위입니다. 헤더 유형이 METRIC_CURRENCY인 경우에만 표시됩니다. | |
rows[] | list | 보고서 연산의 결과 행입니다. 각 행은 셀의 목록입니다. 한 행에 요청의 측정기준 하나가 들어가고, 그 다음 행에 요청의 측정항목 하나가 들어갑니다. 측정기준 셀에는 문자열이 포함되고, 측정항목 셀에는 숫자가 포함됩니다. | |
totals[] | list | 보고서의 총 합계입니다. 보고서의 다른 행과 동일한 길이로, 측정기준에 해당하는 셀은 빈 값입니다. | |
averages[] | list | 보고서의 평균입니다. 보고서의 다른 행과 동일한 길이로, 측정기준에 해당하는 셀은 빈 값입니다. | |
warnings[] | list | 보고서 생성 시 발생한 경고 메시지입니다. | |
startDate | string | 요청 시작일로 yyyy-mm-dd format 형식입니다. | |
endDate | string | 요청 종료일로 yyyy-mm-dd format 형식입니다. |
CSV
"(dynamic)" (foreach) string (/foreach)
속성 이름 | 값 | 설명 | 참고 |
---|---|---|---|
(dynamic) | string |
직접 해보기
아래의 API Explorer를 이용해 실제 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.