REST Resource: curators.dataSegments

資源:DataSegment

定義廣告空間區隔的 ID,收錄者或媒體企劃人員可在交易或競價套裝方案 UI 中指定該區隔。廣告空間收錄作業是由外部平台的收錄者執行。-- Next ID: 9 --

JSON 表示法
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
欄位
name

string

不可變動。ID。資料區隔的專屬 ID。帳戶 ID 對應至建立區隔的帳戶 ID。格式:curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

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"。

updateTime

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"。

state

enum (State)

僅供輸出。資料區隔的狀態。

其他帳戶使用這項資料區隔時,系統會收取費用。例如,其他帳戶將這個資料區隔新增至交易或競價套裝方案時。資料區隔的費用類型設定後即無法變更。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位:
cpmFee

object (Money)

(選用步驟) 每千次曝光收取的固定費用。貨幣代碼一經設定即無法變更。

millipercentOfMediaFee

string (int64 format)

(選用步驟) 這筆費用會以曝光費用的百分比收取,並以千分之一百分比表示。例如,1% 會表示為 1000。

互斥欄位結束。
userListId

string

(選用步驟) 不可變動。這個資料區隔包裝的使用者名單 ID。

如果收錄者已連結資料合作夥伴帳戶,則可建立資料區隔,納入該帳戶擁有的使用者名單。您可以使用 Data Manager API 上傳及管理使用者名單。將使用者名單連結至資料區隔,即可根據您建立的目標對象定義廣告空間區隔。

州

僅供輸出。使用啟用和停用方法變更狀態。

列舉
STATE_UNSPECIFIED 預設值。
ACTIVE 資料區隔已啟用。
INACTIVE 資料區隔已停用。
SUSPENDED 資料區隔已停權,無法啟用。

方法

activate

啟用資料區隔。

create

建立由所列管理員擁有的資料區隔。

deactivate

停用資料區隔。

get

根據指定名稱取得資料區隔。

list

列出收錄者擁有的資料區隔。

patch

更新資料區隔。