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 編碼，且長度不得超過 1,000 個半形字元。必填。
contactInfo[]

string

必要欄位。廣告主與發布商聯絡的聯絡窗口電子郵件地址。最多 10 位聯絡人。每個聯絡人的長度上限為 100 個半形字元。例如：[美國聯絡人 - 王大明：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) 和音訊廣告空間的發布商和競價套裝方案。」「TV：這是我們新推出的專屬專區，可探索連網電視和 OTT 廣告空間。連網電視和 OTT 的定義如下：「連網電視 (CTV) 包括所有符合以下敘述的裝置：- 連線裝置或串流裝置：連接到電視螢幕以顯示影片串流的裝置 (例如 Roku、Apple TV 等)。- 智慧型電視：內建網際網路連線功能的電視 (例如 Samsung 智慧型電視等) - 遊戲主機：具備網際網路連線功能的遊戲主機 (例如 Xbox、PlayStation、Wii 等) - 機上盒：提供傳統有線電視和隨選影片內容的裝置。「Over the Top (OTT)」是指由影片供應商透過網際網路，在電信和有線電視供應商的封閉網路之外，提供類似電視的影片內容。OTT 影片可在電腦、行動裝置、平板電腦，以及連網電視或機上盒裝置上觀看 (只要內容是透過 IP 傳送至後者即可)。「Audio：這是新推出的專屬音訊廣告空間專區。」「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

 更新發布商。
上傳發布商標誌。