Method: exchanges.generateReport

보고서 ID를 생성하고 반환합니다. 보고서가 유지되지 않습니다. 동일한 요청으로 호출하면 보고서가 다시 생성됩니다.

HTTP 요청

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

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

경로 매개변수

매개변수
exchange

string

필수 항목입니다. 보고서가 속한 거래소의 이름입니다. 예: 'Exchanges/123' 필수 항목입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
필드
startDate

string

필수 항목입니다. YYYY-MM-DD 형식의 ISO_8601 보고서 시작일입니다(이 날짜를 기간에 포함). 입력으로 필요합니다.
endDate

string

필수 항목입니다. YYYY-MM-DD 형식의 ISO_8601 보고서 종료일입니다(이 날짜를 기간에 포함). 입력으로 필요합니다.
reportType

enum (ReportType)

필수 항목입니다. 보고서 유형을 지정하지 않으면 오류가 반환됩니다.
dimensionIds[]

enum (DimensionId)

선택사항입니다. 보고서가 생성될 때 기준으로 하는 측정기준 목록입니다. null이면 게시자 ID만 포함합니다. 특정 유형의 보고서에서 지원되지 않는 측정기준은 무시됩니다.

응답 본문

성공한 경우 응답 본문에 Report의 인스턴스가 포함됩니다.

승인 범위

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

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

ReportType

보고서 유형입니다.

열거형
REPORT_TYPE_UNSPECIFIED 보고서 유형 미지정, 잘못된 입력 값
HOURLY 보고서 유형이 매시간입니다.
DAILY 매일 보고서 유형입니다.
WEEKLY 보고서 유형이 주별입니다.
MONTHLY 보고서 유형입니다.

DimensionId

보고서 DimensionId enum

열거형
DIMENSION_ID_UNSPECIFIED 보고서 측정기준이 지정되지 않았습니다. 입력 값이 잘못되었습니다.
PARTNER_ID 파트너 ID, 일일 보고서에서만 지원됩니다.
DEVICE_TYPE 기기 유형, 일일 보고서에서만 지원됩니다.
CREATIVE_ID 광고 소재 ID, 일일 보고서에서만 지원됩니다. 이 측정기준은 보고서의 파일 크기에 상당한 영향을 미칠 수 있습니다. 보고서를 실행하는 데 몇 시간이 걸릴 수 있다는 내용도 포함되어 있습니다. 향후 이와 같이 로드가 많은 입력란에 대한 등급이 제한될 예정입니다.
CREATIVE_TYPE 광고 소재 유형, 일일 보고서에서만 지원됩니다. 이 측정기준은 보고서의 파일 크기에 상당한 영향을 미칠 수 있습니다. 보고서를 실행하는 데 몇 시간이 걸릴 수 있다는 내용도 포함되어 있습니다. 향후 이와 같이 로드가 많은 입력란에 대한 등급이 제한될 예정입니다.
REGION_CODE 일일 보고서에서만 지원되는 국가/지역 코드입니다.
DEAL_ID 인벤토리 소스에 매핑되는 거래 ID이며 일일 보고서에서만 지원됩니다.
PUBLISHER_ID 게시자 ID, 입력 측정기준 ID 목록이 null인 경우 기본 측정기준입니다.