REST Resource: exchanges.publishers

리소스: 게시자

단일 게시자를 캡슐화합니다.

JSON 표현 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
필드
name

string

출력 전용입니다. 이 게시자의 상대 경로 이름입니다. 'exchanges/{seller_id}/publishers/{publisherId}' 형식이어야 합니다. 예: 'exchanges/1234/publishers/5678'
externalPublisherId

string

필수 항목입니다. [지원 중단됨] 이 필드는 곧 externalPublisherIds[]로 대체됩니다. 거래소에서 제공한 고유한 게시자 ID입니다. 입찰 요청에서 전송된 게시자 ID와 일치해야 합니다.

영문 기준 최대 100자 허용되는 문자는 영숫자, 밑줄, 대시, 마침표입니다.
externalPublisherIds[]

string

선택사항입니다. 거래소에서 제공한 게시자 ID입니다. 각 ID는 고유해야 하며 입찰 요청에서 전송된 게시자 ID와 일치해야 합니다.

최대 10개 ID당 최대 100자(영문 기준) 허용되는 문자는 영숫자, 밑줄, 대시, 마침표입니다.
displayName

string

필수 항목입니다. 이 게시자의 표시 이름입니다. 최대 크기가 30자(영문 기준)인 UTF-8로 인코딩되어야 합니다.
status

enum (DiscoveryObjectStatus)

필수 항목입니다. 이 게시자의 상태입니다. 상태가 PAUSED 또는 REMOVED인 게시자는 DV3 광고주에게 표시되지 않습니다.
mediumCapability

enum (MediumCapability)

필수 항목입니다. 이 게시자가 광고를 게재할 계획인 미디어입니다.
description

string

필수 항목입니다. 이 게시자의 설명 텍스트입니다. 최대 크기가 1,000자(영문 기준)인 UTF-8로 인코딩되어야 합니다.
contactInfo[]

string

필수 항목입니다. 광고주가 게시자와 소통할 수 있는 연락처 이메일입니다. 최대 10개의 연락처 연락처당 최대 100자(영문 기준) 예: [미국 연락처 - John Smith: john.smith@abc.com]
commitmentCapability[]

enum (CommitmentCapability)

선택사항입니다. 이 게시자가 지원하는 약정 유형입니다.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

필수 항목입니다. 이 게시자의 인벤토리에 대한 예측 분석입니다. DV3 광고주는 이러한 분석을 확인하고 필터링할 수 있습니다. 도메인 예측 분석은 필수 항목입니다.
logoUrl

string

출력 전용입니다. 이 게시자의 로고 URL입니다.
floorPrice

object (Money)

선택사항입니다. 이 게시자의 가격 하한선입니다. 가격 상한선과 통화 코드가 동일해야 합니다.
ceilingPrice

object (Money)

선택사항입니다. 이 게시자의 가격 상한선입니다. 가격 하한선과 통화 코드가 동일해야 합니다.
generalCapability

string

선택사항입니다. 자유 형식 텍스트의 일반적인 설명입니다. 최대 크기가 200자(영문 기준)인 UTF-8로 인코딩되어야 합니다. 이 설명은 SOV(광고 점유율), CPD, 볼륨 보장일 수 있습니다. 설명 예: 'CPD, High Impact, 평균 시청률 69%']
tvMetadata

object (TVMetadata)

선택사항입니다. TV 상품이 있는 게시자의 메타데이터입니다. 미디어 기능에 TV가 포함된 경우 필수 항목입니다. 미디어 기능에 TV가 포함되지 않은 경우에는 적용되지 않습니다.
urgOwners[]

enum (UnderRepresentedGroup)

선택사항입니다. 소유자가 속한 소외된 그룹(있는 경우)입니다.

MediumCapability

미디어 기능 열거형입니다. 마켓플레이스 프런트엔드 (DV360의 인벤토리 모듈 내)에는 인벤토리에 대한 여러 섹션이 포함되어 있습니다. '디지털: 디스플레이, 동영상 (CTV 및 OTT 포함), 오디오 인벤토리에 걸쳐 있는 게시자 및 입찰 패키지가 포함됩니다.' 'TV: CTV 및 OTT 인벤토리를 검색하기 위해 새로 출시된 전용 섹션입니다. CTV 및 OTT는 다음과 같이 정의됩니다. '커넥티드 TV (CTV)에는 다음과 같은 설명에 맞는 모든 기기가 포함됩니다. - 커넥티드 또는 스트리밍 기기: 동영상 스트림을 표시하기 위해 TV 화면에 연결하는 기기 (Roku, Apple TV 등) - 스마트 TV: 인터넷 연결이 통합된 TV (삼성 스마트 TV 등) - 게임 콘솔: 인터넷에 연결되는 게임 콘솔 (Xbox, PlayStation, Wii 등) - 셋톱 박스: 기존 케이블 및 VOD 콘텐츠를 게재하는 기기' '오버더톱 (OTT)은 통신 및 케이블 제공업체의 폐쇄형 네트워크 외부에서 인터넷을 통해 동영상 제공업체가 제공하는 TV와 유사한 동영상 콘텐츠를 의미합니다. OTT 동영상은 데스크톱, 모바일, 태블릿은 물론 CTV 또는 STB 기기에서도 시청할 수 있습니다 (후자의 경우 콘텐츠가 IP를 통해 제공되는 경우). '오디오: 오디오 인벤토리를 위한 새로 출시된 전용 섹션입니다.' 'OOH: 디지털 옥외 광고 게시자'

열거형
MEDIUM_CAPABILITY_UNSPECIFIED 미디어 기능이 지정되지 않았습니다. 잘못된 입력입니다.
MEDIUM_CAPABILITY_DIGITAL 미디어 기능 디지털입니다.
MEDIUM_CAPABILITY_TV 미디어 기능 TV입니다.
MEDIUM_CAPABILITY_AUDIO 미디어 기능 오디오입니다.
MEDIUM_CAPABILITY_OOH 미디어 기능 옥외 광고입니다.

CommitmentCapability

약정 기능 열거형입니다.

열거형
COMMITMENT_CAPABILITY_UNSPECIFIED 약정 기능이 지정되지 않았습니다. 잘못된 입력입니다.
COMMITMENT_CAPABILITY_GUARANTEED 게시자에게 인벤토리가 보장됩니다.
COMMITMENT_CAPABILITY_NON_GUARANTEED 게시자에게 인벤토리가 보장되지 않습니다.

TVMetadata

TV 상품이 있는 게시자의 메타데이터입니다.

JSON 표현 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
필드
tvDeliveryType

enum (TVDeliveryType)

필수 항목입니다. TV 광고의 게재 유형입니다.
topShows[]

string

선택사항입니다. 게시자가 소유한 인기 TV 프로그램 제목 목록입니다. 최대 크기는 10입니다. UTF-8로 인코딩되어야 합니다.

TVDeliveryType

TV 게재 유형 열거형입니다.

열거형
TV_DELIVERY_TYPE_UNSPECIFIED TV 게재 유형이 지정되지 않았습니다. 잘못된 입력입니다.
TV_DELIVERY_TYPE_CTV TV 게재 유형 커넥티드 TV입니다.
TV_DELIVERY_TYPE_LINEAR_TV TV 게재 유형 일반 TV입니다.

메서드

create

 새 게시자를 만듭니다.

get

 게시자를 가져옵니다.

list

 게시자를 나열합니다.

patch

 게시자를 업데이트합니다.
게시자 로고를 업로드합니다.