REST Resource: exchanges.publishers

資源：Publisher

封裝單一發布商。

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：john.smith@abc.com]。
commitmentCapability[]

enum (CommitmentCapability)

(選用步驟) 發布商支援的承諾類型。
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

必填。這個發布商廣告空間的預測明細。DV3 廣告主可以查看及篩選這些細目。必須提供網域預測細目。
logoUrl

string

僅供輸出。這個發布者的標誌網址。
floorPrice

object (Money)

(選用步驟) 這個發布商的底價。必須與最高價格使用相同的貨幣代碼。
ceilingPrice

object (Money)

(選用步驟) 這個發布商的最高價格。必須與底價使用相同的貨幣代碼。
generalCapability

string

(選用步驟) 一般說明 (自由文字格式)。必須採用 UTF-8 編碼，且不得超過 200 個字元。這項說明可以是廣告曝光占有率、每日費用或量保證。範例說明：「CPD、高影響、平均可視度 69%」
tvMetadata

object (TVMetadata)

(選用步驟) 提供電視內容的發布商中繼資料。如果媒體功能包含電視，則為必要屬性。如果中型功能不含電視，則不適用。
urgOwners[]

enum (UnderRepresentedGroup)

(選用步驟) 版主所屬的弱勢群體 (如有)。

MediumCapability

中等功能列舉。市集前端 (位於 DV360 的廣告空間模組中) 包含不同的廣告空間專區。「數位：包括多媒體、影片 (含連網電視和 OTT) 和音訊廣告空間的發布商和競價套裝方案。」「電視」：這是我們新推出的專區，可探索連網電視和 OTT 廣告空間。連網電視和 OTT 的定義如下：「連網電視 (CTV) 包括所有符合以下敘述的裝置：- 連線裝置或串流裝置：連接到電視螢幕以顯示影片串流的裝置 (例如 Roku、Apple TV 等)。- 智慧型電視：內建網際網路連線功能的電視 (例如 Samsung 智慧型電視等)。- 遊戲主機：具備網際網路連線功能的遊戲主機 (Xbox、PlayStation、Wii 等) - 機上盒：提供傳統有線電視和隨選影片內容的裝置。「Over the Top (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

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