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[] 取代。广告交易平台提供的唯一发布商 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 编码，且大小不得超过 1000 个字符。必填。
contactInfo[]

string

必需。广告客户与发布商沟通的联系人电子邮件地址。最多 10 位联系人。每个联系人最多 100 个字符。示例：[US contact - John Smith: john.smith@abc.com]。必填。
commitmentCapability[]

enum (CommitmentCapability)

可选。此发布商支持的付款承诺类型。
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

必需。此发布商广告资源的预测明细。DV3 广告客户可以查看这些细分数据并按这些维度进行过滤。必须提供网域预测明细。
logoUrl

string

仅限输出。此发布商徽标的网址。
floorPrice

object (Money)

可选。此发布商的底价。必须与上限价格使用相同的币种代码。
ceilingPrice

object (Money)

可选。此发布商的上限价格。必须与底价使用相同的币种代码。
generalCapability

string

可选。
tvMetadata

object (TVMetadata)

可选。提供电视内容的发行商的元数据。如果媒体播放功能包含电视，则此字段为必填。如果媒体功能不含电视，则不适用。
urgOwners[]

enum (UnderRepresentedGroup)

可选。在“代表的群组”下，显示所有者是成员的群组（如果有）。

MediumCapability

中等功能枚举。市场前端（在 DV360 的“广告资源”模块中）包含不同的广告资源部分。“数字：包括展示广告资源、视频广告资源（包括联网电视和 OTT）以及音频广告资源中的发布商和竞价包。”“电视”：这是我们新推出的专门用于发现联网电视和 OTT 广告资源的版块。联网电视 (CTV) 和 OTT 的定义如下：“联网电视 (CTV) 包括符合以下描述的所有设备：- 联网设备或流媒体设备：连接到电视屏幕以显示视频流的设备（Roku、Apple TV 等）- 智能电视：支持集成式互联网连接的电视（三星智能电视等）- 游戏机：联网的游戏机（Xbox、PlayStation、Wii 等）- 机顶盒：提供传统有线电视节目和视频点播内容的设备。”“OTT 服务”是指视频提供商通过互联网（而非电信和有线电视提供商的封闭网络）提供的类似电视的视频内容。OTT 视频可在桌面设备、移动设备、平板电脑以及联网电视或机顶盒设备上观看（前提是内容是通过 IP 传送到后者）。“音频：这是新推出的专门用于音频广告资源的版块。”“OOH：数字户外广告发布商”。

枚举
MEDIUM_CAPABILITY_UNSPECIFIED 未指定中等功能。输入无效。
MEDIUM_CAPABILITY_DIGITAL 中等功能数字版。
MEDIUM_CAPABILITY_TV 中等功能电视。
MEDIUM_CAPABILITY_AUDIO 中等功能音频。
MEDIUM_CAPABILITY_OOH 中等能力的户外设备。

CommitmentCapability

承诺功能枚举。

枚举
COMMITMENT_CAPABILITY_UNSPECIFIED 未指定承诺功能。输入无效。
COMMITMENT_CAPABILITY_GUARANTEED 发布商拥有有保证的广告资源。
COMMITMENT_CAPABILITY_NON_GUARANTEED 发布商有无保证的广告资源。

TVMetadata

提供电视内容的发布商的元数据。

JSON 表示法 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
字段
tvDeliveryType

enum (TVDeliveryType)

必需。电视广告的投放类型。
topShows[]

string

可选。发布商拥有的热门电视节目标题列表。大小上限为 10。必须采用 UTF-8 编码。

TVDeliveryType

电视广告投放类型枚举。

枚举
TV_DELIVERY_TYPE_UNSPECIFIED 电视广告投放类型未指定。输入无效。
TV_DELIVERY_TYPE_CTV 电视投放类型为联网电视。
TV_DELIVERY_TYPE_LINEAR_TV 电视广告投放类型为线性电视。

方法

create

 创建新的发布商。

get

 获取发布商。

list

 列出发布商。

patch

 更新发布商。
上传出版商徽标。