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

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

enum (DiscoveryObjectStatus)

이 입찰 패키지의 상태입니다. '일시중지됨' 또는 '삭제됨' 상태의 패키지는 DV3 광고주에게 표시되지 않습니다. 필수 항목입니다.
description

string

이 패키지의 설명 텍스트입니다. UTF-8로 인코딩되어야 하며 최대 크기는 2,000자(영문 기준)입니다. 필수 항목입니다.
format

enum (Format)

기본 광고 형식 유형입니다. 필수 항목입니다. 생성 후에는 업데이트할 수 없습니다.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

입찰 요청에 사용된 거래소 거래 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

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