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[]로 대체됩니다. Exchange에서 제공한 고유한 게시자 ID입니다. 입찰 요청에서 전송된 게시자 ID와 일치해야 합니다.

영문 기준 최대 100자 영숫자, 밑줄, 대시, 마침표만 사용할 수 있습니다.
externalPublisherIds[]

string

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

최대 10개까지 계산할 수 있습니다. ID당 최대 100자(영문 기준) 영숫자, 밑줄, 대시, 마침표만 사용할 수 있습니다.
displayName

string

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

enum (DiscoveryObjectStatus)

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

enum (MediumCapability)

필수 항목입니다. 이 게시자가 광고를 호스팅할 미디어입니다.
description

string

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

string

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

enum (CommitmentCapability)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

object (Money)

선택사항입니다. 이 음반 제작사의 가격 하한선입니다. 상한 가격과 통화 코드가 동일해야 합니다.
ceilingPrice

object (Money)

선택사항입니다. 이 음반 제작사의 가격 상한선입니다. 가격 하한선과 동일한 통화 코드여야 합니다.
generalCapability

string

선택사항입니다.
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를 통해 전송되는 경우 STB 기기에서 시청 가능). '오디오: 오디오 인벤토리를 위한 전용 섹션으로 새로 출시되었습니다.' 'OOH: 디지털 옥외 광고 게시자'

열거형
MEDIUM_CAPABILITY_UNSPECIFIED 미디엄 기능이 지정되지 않았습니다. 잘못된 입력입니다.
MEDIUM_CAPABILITY_DIGITAL 중간 수준의 디지털 기능
MEDIUM_CAPABILITY_TV 중간 성능의 TV
MEDIUM_CAPABILITY_AUDIO 중간 성능 오디오
MEDIUM_CAPABILITY_OOH 중간 수준의 옥외 기능

CommitmentCapability

약정 기능 enum.

열거형
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

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