Reports: generate

승인 필요

쿼리 매개변수에서 전송한 보고서 요청을 바탕으로 애드센스 보고서를 생성합니다. 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 중 하나입니다. 사용 가능한 값: "`DIMENSION`": "`METRIC_CURRENCY`": "`METRIC_RATIO`": "`METRIC_TALLY`":
`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를 이용해 실제 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.