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

 更新竞价包。
上传指定软件包的徽标。