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

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

string

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

enum (ReportType)

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

enum (DimensionId)

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

응답 본문

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

승인 범위

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

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.

ReportType

보고서 유형입니다.

열거형
REPORT_TYPE_UNSPECIFIED 보고서 유형이 지정되지 않았으며 입력값이 잘못되었습니다.
HOURLY 시간별 보고서 유형입니다.
DAILY 일일 보고서 유형입니다.
WEEKLY 주간 보고서 유형입니다.
MONTHLY 월간 보고서 유형입니다.
AWBID_DAILY AwBid 일일 보고서 유형입니다.
AWBID_WEEKLY AwBid 주간 보고서 유형입니다.
AWBID_MONTHLY AwBid 월간 보고서 유형입니다.
AWBID_OUT_OF_MONTH_IVT AwBid 월간 IVT 보고서 유형입니다.

DimensionId

보고서 DimensionId 열거형입니다.

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