REST Resource: exchanges.inventorySources

資源：InventorySource

DV360 廣告空間來源的執行模式。

JSON 表示法 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
欄位
name

string

僅供輸出。訂單的相對資源名稱。由伺服器產生。例如：「exchanges/1234/inventorySources/5678」。
buyerStatus

enum (BuyerStatus)

僅供輸出。買家狀態。
sellerStatus

enum (SellerStatus)

賣家狀態。
transactionType

enum (TransactionType)

僅供輸出。產品交易類型。
pricingType

enum (PricingType)

僅供輸出。產品的定價類型。
rateDetails

object (RateDetails)

僅供輸出。房價詳細資料。
startTime

string (Timestamp format)

僅供輸出。這項產品的啟用時間。必須早於結束時間。開始時間不得晚於 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"。
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

廣告交易平台提供的每日量預測。用於判斷放送速度，並啟用買方選擇。這個欄位已不適用。
audienceMatchRate

number

僅供輸出。程式輔助保證交易的預測目標對象比對率 (指定目標對象)，交易所會根據這項指標判斷應傳送多少額外請求。這是介於 0 和 1 之間的小數，其倒數應做為曝光次數的乘數。0 表示該欄位未設定，因此沒有目標對象指定條件。例如：「0.125」。這表示有 12.5% 的請求符合目標對象指定目標，且傳送的請求數量應為協商曝光次數的 8 倍。
makegoodRequested

boolean

僅供輸出。指出買方是否已要求補償項。
makegoodRequestedReason

string

僅供輸出。買方提供要求補償項的原因。
percentFrequencyCapExcludedTraffic

string (int64 format)

程式輔助保證交易中，因展示頻率上限而排除的流量百分比。這是介於 0 到 100 之間的整數。值為 0 (也是預設值) 表示沒有排除條件，因此所有流量都適用於展示頻率上限。值為 100 表示完全排除，因此不會套用展示頻率上限。如果值介於 0 到 100 之間，系統會部分排除。舉例來說，如果值為 20，系統會從展示頻率上限排除 20% 的流量。
dv360WseatId[]

string (int64 format)

僅供輸出。目前有權存取廣告空間來源的 wseat。
lastModifiedTime

string (Timestamp format)

僅供輸出。廣告空間來源上次更新的時間。請注意，部分 DV3 內部更新會變更上次修改時間。

使用 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"。
creativeApprovalConfig

object (CreativeApprovalConfig)

(選用步驟) 廣告素材核准的設定。可能需要在交易平台或發布商層級取得核准。

BuyerStatus

買家狀態。

列舉
BUYER_STATUS_UNSPECIFIED 未指定買方狀態。輸入值無效。
BUYER_STATUS_ACTIVE 買方狀態為有效。已指派委刊項，且已指派有效廣告素材。
BUYER_STATUS_PENDING 買家狀態為待處理。這項狀態表示交易無效，買方需要採取特定行動。
BUYER_STATUS_PAUSED 買方狀態為「買方已暫停」。

SellerStatus

賣家狀態。

列舉
SELLER_STATUS_UNSPECIFIED 未指定賣方狀態。Unexpected：表示協議狀態不明。輸入值無效。
SELLER_STATUS_ACTIVE 賣家狀態為有效。廣告交易平台已啟用廣告空間來源。
SELLER_STATUS_PAUSED 賣家狀態已暫停。

InventorySourceVolumeForecast

廣告空間來源的每日要求量預測。適用下列驗證規則：- 必須為每週的每一天提供項目 - 數量不得為負數 - 必須提供有效的 timeZoneId

JSON 表示法 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
欄位
dailyVolumes[]

object (DailyVolume)

每日數量預測。
timeZoneId

string

IANA 時區資料庫時區，例如「America/New_York」，用於每日交易量。

DailyVolume

特定日期廣告空間來源的要求量。

JSON 表示法 
{
  "day": enum (DayOfWeek),
  "volume": string
}
欄位
day

enum (DayOfWeek)

要求量適用的星期幾。
volume

string (int64 format)

指定星期幾的預測要求量。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 星期一
TUESDAY 週二
WEDNESDAY 週三
THURSDAY 週四
FRIDAY Friday (週五)
SATURDAY Saturday (週六)
SUNDAY 星期日

CreativeApprovalConfig

廣告素材核准的設定。

JSON 表示法 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
欄位
requiresExchangeApproval

boolean

必填。指出廣告素材是否需要在廣告交易平台層級預先核准。
publisherConfigs[]

object (PublisherConfig)

(選用步驟) 發布商的設定。

PublisherConfig

發布商的設定 (publisher_config)。如果設定 publisher_config，廣告素材必須先在發布商層級獲得預先擷取核准，才能放送。

JSON 表示法 
{
  "publisherId": string,
  "publisherDisplayName": string
}
欄位
publisherId

string

必填。發布商 ID。
publisherDisplayName

string

必填。發布者名稱。

方法

get

 取得廣告空間來源。

list

 列出廣告空間來源。

patch

 更新廣告空間來源。