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)

必需。此发布商的状态。状态为 PAUSED 或 REMOVED 的发布商不会向 DV3 广告客户显示。
mediumCapability

enum (MediumCapability)

必需。此发布商计划在其上托管广告的媒体。
description

string

必需。此发布商的说明文字。必须采用 UTF-8 编码，且大小上限为 1,000 个字符。
contactInfo[]

string

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

enum (CommitmentCapability)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

object (Money)

可选。此发布商的底价。必须与最高价采用相同的币种代码。
ceilingPrice

object (Money)

可选。此发布商的最高价。必须与底价采用相同的币种代码。
generalCapability

string

可选。自由文本格式的一般说明。必须采用 UTF-8 编码，且大小上限为 200 个字符。此说明可以是 SOV（语音份额）、CPD、量保证。示例说明：“CPD、高影响力、69% 平均可见度”
tvMetadata

object (TVMetadata)

可选。提供电视广告的发布商的元数据。当媒体功能包含电视广告时，此字段为必填字段。当媒体功能不包含电视广告时，此字段不适用。
urgOwners[]

enum (UnderRepresentedGroup)

可选。所有者所属的代表性不足的群体（如果有）。

MediumCapability

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

枚举
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

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