REST Resource: exchanges.auctionPackages

資源：AuctionPackage

封裝單一競價套裝方案。DV3 中的廣告主可以透過市集探索使用者介面瀏覽 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 編碼，且長度不得超過 2000 個半形字元。必填。
format

enum (Format)

基礎廣告格式類型。必要欄位。建立後即無法更新。
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

這個競價套裝方案廣告空間的預測明細。DV3 廣告主可以查看及篩選這些細目資料。選填。
externalDealId

string

出價要求中使用的廣告交易平台交易 ID。最多 100 個半形字元。允許的字元包括英數字元、底線、破折號和半形句號。必要欄位。必要欄位。建立後不允許更新。
logoUrl

string

僅供輸出。這個競價套裝方案標誌的網址。

僅供輸出。
floorPrice

object (Money)

這個競價套裝方案的底價。必填。
startTime

string (Timestamp format)

這項產品啟用的時間。必須早於 endTime。開始時間不得超過 1 年。必填。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

這項產品停用的時間。必填。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「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

 更新競價套裝方案。
上傳指定套件的標誌。