REST Resource: curators.reports

리소스: Report

Report 리소스

JSON 표현
{
  "name": string,
  "reportId": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "displayName": string,
  "updateTime": string,
  "createTime": string,
  "locale": string
}
필드
name

string

식별자. 보고서의 리소스 이름입니다. 보고서 리소스 이름의 형식은 curators/{accountId}/reports/{reportId}입니다.

reportId

string (int64 format)

출력 전용입니다. 보고서 ID입니다.

reportDefinition

object (ReportDefinition)

필수 항목입니다. 보고서의 보고서 정의입니다.

displayName

string

선택사항입니다. 보고서의 표시 이름입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 이 보고서가 마지막으로 수정된 시점입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

createTime

string (Timestamp format)

출력 전용입니다. 이 보고서가 생성된 시점입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

locale

string

출력 전용입니다. 이 보고서의 언어입니다. 언어는 요청 시 사용자의 언어로 설정됩니다. 언어는 수정할 수 없습니다.

ReportDefinition

보고서 실행 방법에 대한 정의입니다.

JSON 표현
{
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "timeZoneSource": enum (TimeZoneSource),
  "timeZone": string,
  "currencyCode": string,
  "dateRange": {
    object (DateRange)
  },
  "sorts": [
    {
      object (Sort)
    }
  ]
}
필드
dimensions[]

enum (Dimension)

필수 항목입니다. 보고할 측정기준 목록입니다. 비어 있으면 보고서에 측정기준이 없고 모든 측정항목이 합계가 됩니다.

metrics[]

enum (Metric)

필수 항목입니다. 보고할 측정항목 목록입니다. 비어 있으면 보고서에 측정항목이 없습니다.

filters[]

object (Filter)

선택사항입니다. 이 보고서의 필터입니다.

timeZoneSource

enum (TimeZoneSource)

선택사항입니다. 이 보고서의 시간대를 가져올 위치입니다. 기본값은 태평양 시간대 (PT)입니다. 소스가 PROVIDED인 경우 보고서 정의의 timeZone 필드도 시간대를 설정해야 합니다.

timeZone

string

선택사항입니다. timeZoneSource가 PROVIDED인 경우 이 보고서에 사용할 시간대입니다. 다른 시간대 소스의 경우 비워 둡니다. IANA 형식의 시간대입니다. 예를 들면 'America/New_York'입니다.

currencyCode

string

선택사항입니다. 이 보고서의 ISO 4217 통화 코드입니다. 지정하지 않으면 계정 통화 코드가 기본값으로 사용됩니다.

dateRange

object (DateRange)

필수 항목입니다. 이 보고서의 기본 기간입니다.

sorts[]

object (Sort)

선택사항입니다. 이 보고서에 적용할 기본 정렬입니다.

측정기준

보고 측정기준

열거형
DIMENSION_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
ADVERTISER_DOMAIN 광고주의 도메인입니다.
COUNTRY 국가의 표시 이름입니다.
CURATION_DATA_SEGMENT_ID 큐레이터가 만든 데이터 세그먼트의 ID입니다.
CURATION_DATA_SEGMENT_RESPONSE_STATUS 실시간 선별의 데이터 세그먼트 요청 응답 상태입니다. 자세한 내용은 https://developers.google.com/authorized-buyers/curation/get-started/start를 참고하세요.
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME 실시간 선별에서 데이터 세그먼트 요청의 응답 상태를 현지화한 표시 이름입니다. 자세한 내용은 https://developers.google.com/authorized-buyers/curation/get-started/start를 참고하세요.
CURATOR_FEE_TYPE 큐레이션 서비스 유형 (예: 패키징 또는 데이터 세그먼트)입니다.
DATE 날짜.
DEAL_ID 거래 ID입니다.
DEAL_NAME 거래 이름
DETECTED_ADVERTISER_NAME 감지된 광고주의 표시 이름입니다.
DSP_NAME DSP의 표시 이름입니다.
DSP_SEAT_ID DSP 시트 ID입니다.
ENVIRONMENT 노출이 발생한 사용자 기기 및 컨테이너 환경입니다. 지원되는 값은 'app' 및 'web'입니다.
ENVIRONMENT_NAME 노출이 발생한 사용자 기기 및 컨테이너 환경의 현지화된 표시 이름입니다. 지원되는 값은 'app' 및 'web'입니다.
HOLDING_COMPANY_NAME 지주 회사의 표시 이름입니다.
HOUR 시간.
MOBILE_APP_ID 모바일 앱 ID입니다.
MOBILE_APP_NAME 모바일 앱 이름
MOBILE_OS 모바일 운영체제
MONTH 월을 탭합니다.
PACKAGE_FEE_VISIBILITY 패키지 수수료의 공개 상태 (예: 공개 또는 비공개)
PLATFORM 플랫폼(예: '데스크톱'과 '모바일')
PUBLISHER_DOMAIN 게시자 도메인입니다.
PUBLISHER_ID 게시자 식별자입니다.
PUBLISHER_NAME 게시자 이름입니다.
WEEK 주

측정항목

보고서 측정항목

열거형
METRIC_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
ACTIVE_VIEW_MEASURABILITY_RATE Active View 측정 가능 노출률
ACTIVE_VIEW_MEASURABLE 측정 가능 Active View
ACTIVE_VIEW_VIEWABILITY_RATE Active View 조회가능 노출률입니다.
ACTIVE_VIEW_VIEWABLE 조회 가능 Active View 노출수
AUCTIONS_WON 낙찰받은 입찰 수
BIDS 입찰가
BIDS_IN_AUCTION 입찰에 참여한 입찰가의 수
BID_REQUESTS 입찰 요청
CLICKS 클릭수
CURATION_PARTNER_FEE 큐레이터 수수료 패키지의 공개 상태가 비공개로 설정된 경우 0.00으로 수정됩니다. PACKAGE_FEE_VISIBILITY 측정기준을 사용하여 패키지 수수료가 공개되었는지 확인합니다.
DATA_SEGMENT_REQUESTS 실시간 선별에서 전송된 데이터 세그먼트 요청 수입니다.
IMPRESSIONS 노출수
SPEND 요청에 지정된 보고 통화로 표시된 지출입니다. 기본값은 USD입니다.

필터

하나 이상의 필드에 대한 필터입니다.

JSON 표현
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fieldFilter": {
    object (FieldFilter)
  },
  "notFilter": {
    object (Filter)
  },
  "andFilter": {
    object (FilterList)
  },
  "orFilter": {
    object (FilterList)
  }
  // End of mutually exclusive fields.
}
필드
유형에 따라 기본 필터가 결합되는 방식이 결정됩니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
fieldFilter

object (FieldFilter)

단일 필드의 필터입니다.

notFilter

object (Filter)

결과가 부정되는 필터입니다.

andFilter

object (FilterList)

결과가 AND 연산되는 필터 목록입니다.

orFilter

object (FilterList)

결과가 OR 연산되는 필터 목록입니다.

상호 배타적 필드의 끝입니다.

FieldFilter

특정 필드의 필터입니다.

JSON 표현
{
  "field": {
    object (Field)
  },
  "operation": enum (Operation),
  "values": [
    {
      object (ReportValue)
    }
  ]
}
필드
field

object (Field)

필수 항목. 필터링할 필드입니다.

operation

enum (Operation)

필수 항목입니다. 이 필터의 작업입니다.

values[]

object (ReportValue)

필수 항목입니다. 필터링할 값입니다.

필드

보고서의 측정기준 또는 측정항목입니다.

JSON 표현
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of mutually exclusive fields.
}
필드
측정기준 또는 측정항목입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
dimension

enum (Dimension)

이 필드가 나타내는 측정기준입니다.

metric

enum (Metric)

이 필드가 나타내는 측정항목입니다.

상호 배타적 필드의 끝입니다.

작업

지원되는 필터 작업입니다.

열거형
IN

스칼라 피연산자의 경우 피연산자가 제공된 필터 값 집합에 있는지 확인합니다.

목록 피연산자의 경우 피연산자의 요소가 제공된 필터 값 집합에 있는지 확인합니다.

기본값

NOT_IN

스칼라 피연산자의 경우 피연산자가 제공된 필터 값 집합에 없는지 확인합니다.

목록 피연산자의 경우 피연산자의 요소가 제공된 필터 값 집합에 없는지 확인합니다.

CONTAINS

스칼라 문자열 피연산자의 경우 피연산자에 제공된 필터 하위 문자열이 포함되어 있는지 확인합니다.

문자열 목록 피연산자의 경우 피연산자의 문자열에 제공된 필터 하위 문자열이 포함되어 있는지 확인합니다.

NOT_CONTAINS

스칼라 문자열 피연산자의 경우 피연산자에 제공된 필터 하위 문자열이 포함되어 있지 않은지 확인합니다.

문자열 목록 피연산자의 경우 피연산자의 문자열에 제공된 필터 하위 문자열이 포함되어 있지 않은지 확인합니다.

LESS_THAN 피연산자가 제공된 필터 값보다 작습니다.
LESS_THAN_EQUALS 피연산자가 제공된 필터 값보다 작거나 같습니다.
GREATER_THAN 피연산자가 제공된 필터 값보다 큽니다.
GREATER_THAN_EQUALS 피연산자가 제공된 필터 값보다 크거나 같습니다.
BETWEEN 피연산자가 제공된 필터 값 사이에 있습니다.
MATCHES 피연산자가 정규 표현식 또는 정규 표현식 집합과 일치합니다 (하나가 일치해야 함).
NOT_MATCHES 피연산자가 정규 표현식 또는 정규 표현식 집합과 일치하지 않습니다 (일치하는 항목이 없어야 함).

ReportValue

보고서의 단일 값을 나타냅니다.

JSON 표현
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "intValue": string,
  "doubleValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "intListValue": {
    object (IntList)
  },
  "stringListValue": {
    object (StringList)
  },
  "doubleListValue": {
    object (DoubleList)
  },
  "bytesValue": string
  // End of mutually exclusive fields.
}
필드
필드 값은 필드의 데이터 형식에 따라 달라집니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
intValue

string (int64 format)

정수 값

doubleValue

number

double 값입니다.

stringValue

string

문자열 값의 경우

boolValue

boolean

불리언 값입니다.

intListValue

object (IntList)

정수 값 목록입니다.

stringListValue

object (StringList)

문자열 값 목록입니다.

doubleListValue

object (DoubleList)

Double 값 목록입니다.

bytesValue

string (bytes format)

바이트 값입니다.

base64 인코딩 문자열입니다.

상호 배타적 필드의 끝입니다.

IntList

정수 값 목록입니다.

JSON 표현
{
  "values": [
    string
  ]
}
필드
values[]

string (int64 format)

값

StringList

문자열 값 목록입니다.

JSON 표현
{
  "values": [
    string
  ]
}
필드
values[]

string

값

DoubleList

이중 값 목록입니다.

JSON 표현
{
  "values": [
    number
  ]
}
필드
values[]

number

값

FilterList

필터 목록입니다.

JSON 표현
{
  "filters": [
    {
      object (Filter)
    }
  ]
}
필드
filters[]

object (Filter)

필수 항목입니다. 필터 목록입니다.

TimeZoneSource

보고서의 시간대를 결정하는 소스입니다.

열거형
TIME_ZONE_SOURCE_UNSPECIFIED 지정되지 않은 기본값입니다.
AD_EXCHANGE 태평양 시간대(PT)를 사용합니다.
UTC UTC 시간대를 사용합니다.
PROVIDED ReportDefinition.time_zone 필드에 제공된 시간대를 사용합니다. 요청 시 날짜가 동적으로 계산되므로 보고서를 실행하는 데 시간이 더 오래 걸릴 수 있습니다.
CURATOR 큐레이터의 계정 설정에 있는 시간대를 사용합니다.

DateRange

보고서의 기간입니다.

JSON 표현
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixed": {
    object (FixedDateRange)
  },
  "relative": enum (RelativeDateRange)
  // End of mutually exclusive fields.
}
필드
고정 또는 상대 기간입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
fixed

object (FixedDateRange)

고정 기간

relative

enum (RelativeDateRange)

상대 기간입니다.

상호 배타적 필드의 끝입니다.

FixedDateRange

두 고정 날짜 사이의 기간입니다 (종료일 포함).

JSON 표현
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
필드
startDate

object (Date)

필수 항목입니다. 이 기간의 시작일입니다.

endDate

object (Date)

필수 항목입니다. 이 기간의 종료일 (해당 날짜 포함)입니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.

month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.

day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

RelativeDateRange

상대 기간 옵션입니다.

열거형
RELATIVE_DATE_RANGE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
TODAY 보고서가 실행된 날짜입니다.
YESTERDAY 보고서가 실행되는 날짜의 전날입니다.
THIS_WEEK_TO_DATE 보고서가 실행되는 날짜를 포함하여 해당 주의 시작일부터의 데이터입니다.
THIS_WEEK_TO_YESTERDAY 보고서가 실행되는 달력상 주의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다.
THIS_MONTH_TO_DATE 보고서가 실행된 달의 시작일부터 보고서가 실행된 날까지(해당 날짜 포함)입니다.
THIS_MONTH_TO_YESTERDAY 보고서가 실행된 달의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다.
THIS_QUARTER_TO_DATE 보고서가 실행되는 분기의 시작일부터 보고서가 실행되는 날짜까지(해당 날짜 포함)입니다.
THIS_QUARTER_TO_YESTERDAY 보고서가 실행되는 분기의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다.
THIS_YEAR_TO_DATE 보고서가 실행된 연도의 시작일부터 보고서가 실행된 날짜까지(해당 날짜 포함)입니다.
THIS_YEAR_TO_YESTERDAY 보고서가 실행되는 연도의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다.
LAST_WEEK 보고서가 실행되는 주 이전의 전체 주 (월요일부터 일요일까지)입니다.
LAST_WEEK_STARTING_SUNDAY 보고서가 실행되는 주 이전의 전체 주 (일요일부터 토요일까지)입니다.
LAST_MONTH 보고서가 실행되는 달의 이전 달 전체입니다.
LAST_QUARTER 보고서가 실행되는 분기 이전의 전체 분기입니다.
LAST_YEAR 보고서가 실행되는 연도 이전의 전체 연도입니다.
LAST_7_DAYS 보고서 실행일 이전 7일
LAST_30_DAYS 보고서 실행일 이전 30일
LAST_60_DAYS 보고서 실행일 이전 60일
LAST_90_DAYS 보고서 실행일 이전 90일
LAST_93_DAYS 보고서 실행일 이전 93일
LAST_180_DAYS 보고서 실행일 이전 180일
LAST_360_DAYS 보고서 실행일 이전 360일
LAST_365_DAYS 보고서 실행일 이전 365일
LAST_3_MONTHS 보고서가 실행되는 달 이전의 전체 3개월입니다.
LAST_6_MONTHS 보고서가 실행되는 달 이전의 전체 6개월입니다.
LAST_12_MONTHS 보고서가 실행되는 달 이전의 12개월 전체입니다.
ALL_AVAILABLE 보고서 실행일 3년 전부터 보고서 실행일 전날까지(해당 날짜 포함)입니다.

정렬

보고서의 정렬을 나타냅니다.

JSON 표현
{
  "field": {
    object (Field)
  },
  "descending": boolean
}
필드
field

object (Field)

필수 항목입니다. 정렬할 필드 (측정기준 또는 측정항목)입니다.

descending

boolean

선택사항입니다. 정렬 순서입니다. true이면 내림차순으로 정렬됩니다.

메서드

create

Report 객체를 만듭니다.

delete

Report 객체를 삭제합니다.

get

Report 객체를 가져옵니다.

list

Report 객체를 나열합니다.

patch

Report 객체를 업데이트합니다.

run

기존 보고서의 실행을 비동기식으로 시작합니다.