資源:DataSegment
定義廣告空間區隔的 ID,收錄者或媒體企劃人員可在交易或競價套裝方案 UI 中指定該區隔。廣告空間收錄作業是由外部平台的收錄者執行。-- Next ID: 9 --
| JSON 表示法 |
|---|
{ "name": string, "createTime": string, "updateTime": string, "state": enum ( |
| 欄位 | |
|---|---|
name |
不可變動。ID。資料區隔的專屬 ID。帳戶 ID 對應至建立區隔的帳戶 ID。格式: |
createTime |
僅供輸出。資料區隔的建立時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
updateTime |
僅供輸出。資料區隔上次更新的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
state |
僅供輸出。資料區隔的狀態。 |
| 其他帳戶使用這項資料區隔時,系統會收取費用。例如,其他帳戶將這個資料區隔新增至交易或競價套裝方案時。資料區隔的費用類型設定後即無法變更。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位: | |
cpmFee |
(選用步驟) 每千次曝光收取的固定費用。貨幣代碼一經設定即無法變更。 |
millipercentOfMediaFee |
(選用步驟) 這筆費用會以曝光費用的百分比收取,並以千分之一百分比表示。例如,1% 會表示為 1000。 |
| 互斥欄位結束。 | |
userListId |
(選用步驟) 不可變動。這個資料區隔包裝的使用者名單 ID。 如果收錄者已連結資料合作夥伴帳戶,則可建立資料區隔,納入該帳戶擁有的使用者名單。您可以使用 Data Manager API 上傳及管理使用者名單。將使用者名單連結至資料區隔,即可根據您建立的目標對象定義廣告空間區隔。 |
州
僅供輸出。使用啟用和停用方法變更狀態。
| 列舉 | |
|---|---|
STATE_UNSPECIFIED |
預設值。 |
ACTIVE |
資料區隔已啟用。 |
INACTIVE |
資料區隔已停用。 |
SUSPENDED |
資料區隔已停權,無法啟用。 |
方法 |
|
|---|---|
|
啟用資料區隔。 |
|
建立由所列管理員擁有的資料區隔。 |
|
停用資料區隔。 |
|
根據指定名稱取得資料區隔。 |
|
列出收錄者擁有的資料區隔。 |
|
更新資料區隔。 |