REST Resource: exchanges.auctionPackages

리소스: AuctionPackage

단일 입찰 패키지를 캡슐화합니다. DV3의 광고주는 마켓플레이스 검색 UI를 통해 DV3의 모든 입찰 패키지를 둘러보고 판매자 작업 없이 이러한 패키지를 사용하도록 선택할 수 있습니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
필드
name

string

식별자. 이 입찰 패키지의 상대 경로 이름입니다. 'exchanges/{seller_id}/auctionpackages/{auction_package_id} 형식이어야 합니다. 예: 'exchanges/1234/auctionPackage/5678'. 출력 전용입니다.
displayName

string

필수 항목입니다. 이 입찰 패키지의 표시 이름입니다. 최대 크기가 240자인 UTF-8로 인코딩되어야 합니다. 필수 항목입니다.
status

enum (DiscoveryObjectStatus)

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

string

필수 항목입니다. 이 패키지의 설명 텍스트입니다. 최대 크기가 2,000자인 UTF-8로 인코딩되어야 합니다. 필수 항목입니다.
format

enum (Format)

필수 항목입니다. 변경할 수 없습니다. 기본 광고 형식 유형입니다. 필수 항목입니다. 생성 후에는 업데이트가 허용되지 않습니다.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

선택사항입니다. 이 입찰 패키지 인벤토리의 예측 분석입니다. DV3 광고주는 이러한 분석을 확인하고 필터링할 수 있습니다. 선택사항입니다.
externalDealId

string

필수 항목입니다. 변경할 수 없습니다. 입찰 요청에 사용되는 Exchange 거래 ID입니다. 영문 기준 최대 100자 허용되는 문자는 영숫자, 밑줄, 대시, 마침표입니다. 필수 항목입니다. 필수 항목입니다. 생성 후에는 업데이트가 허용되지 않습니다.
logoUrl

string

출력 전용입니다. 이 입찰 패키지의 로고 URL입니다.

출력 전용입니다.
floorPrice

object (Money)

필수 항목입니다. 이 입찰 패키지의 가격 하한선입니다. 필수 항목입니다.
startTime

string (Timestamp format)

필수 항목입니다. 이 제품이 활성화되는 시간입니다. endTime보다 빨라야 합니다. 시작 시간은 1년 이상 미래일 수 없습니다. 필수 항목입니다.

생성된 출력은 항상 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"입니다.
endTime

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"입니다.
mediumType

enum (MediumType)

필수 항목입니다. 입찰 패키지의 미디어 유형입니다.
urgOwners[]

enum (UnderRepresentedGroup)

선택사항입니다. 소유자가 속한 소외 집단(있는 경우)입니다.
dv3MarketplaceUri

string

출력 전용입니다. 마켓플레이스의 입찰 패키지에 대한 Dv360 링크입니다.

형식

입찰 패키지의 광고 형식입니다.

열거형
DEAL_FORMAT_UNSPECIFIED 거래 형식이 지정되지 않았습니다. 입력에 유효하지 않습니다.
DEAL_FORMAT_DISPLAY 디스플레이 형식입니다.
DEAL_FORMAT_VIDEO 동영상 형식입니다.
DEAL_FORMAT_AUDIO 오디오 형식입니다.

메서드

create

 새 입찰 패키지를 생성합니다.

get

 입찰 패키지를 가져옵니다.

list

 입찰 패키지를 나열합니다.

patch

 입찰 패키지를 업데이트합니다.
지정된 패키지의 로고를 업로드합니다.