REST Resource: curators.dataSegments

资源:DataSegment

为一段广告资源定义一个标识符,以便甄选方或媒体规划人员在交易或竞价包界面中进行定位。广告资源精选由精选方在外部平台上完成。-- 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。格式:curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

仅限输出。数据细分受众群的创建时间。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 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 规范化(即转换为 UTC 零时区格式并在末尾附加 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 上传和管理用户名单。将用户名单与数据细分受众群相关联后,您就可以根据自己创建的受众群体来定义细分广告资源。

州

仅限输出。使用 activate 和 deactivate 方法更改状态。

枚举
STATE_UNSPECIFIED 默认值。
ACTIVE 基于数据的细分受众群处于启用状态。
INACTIVE 基于数据的细分受众群未启用。
SUSPENDED 该数据细分受众群已被暂停,无法启用。

方法

activate

激活数据细分。

create

创建由所列管理者拥有的基于数据的细分受众群。

deactivate

停用基于数据的细分受众群。

get

获取指定名称的数据细分。

list

列出甄选方拥有的基于数据的细分受众群。

patch

更新数据细分受众群。