CustomInterest

自定义兴趣。这是按兴趣分类的用户列表。

JSON 表示法
{
  "resourceName": string,
  "status": enum (CustomInterestStatus),
  "type": enum (CustomInterestType),
  "members": [
    {
      object (CustomInterestMember)
    }
  ],
  "id": string,
  "name": string,
  "description": string
}
字段
resourceName

string

不可变。自定义兴趣的资源名称。自定义兴趣资源名称采用以下格式:

customers/{customerId}/customInterests/{custom_interest_id}

status

enum (CustomInterestStatus)

此自定义兴趣的状态。指明自定义兴趣是已启用还是已移除。

type

enum (CustomInterestType)

自定义兴趣的类型,CUSTOM_AFFINITY 或 CUSTOM_INTENT。默认情况下,类型设置为 CUSTOM_AFFINITY。

members[]

object (CustomInterestMember)

此自定义兴趣所含的自定义兴趣成员的列表。可在创建 CustomInterest 时添加成员。如果在 UPDATE 操作中返回成员,则现有成员将会被覆盖。

id

string (int64 format)

仅供输出。自定义兴趣的 ID。

name

string

自定义兴趣的名称。它应该在同一自定义的兴趣相似受众群体中是唯一的。对于创建操作,此字段是必填字段。

description

string

此自定义兴趣受众群体的说明。

CustomInterestStatus

包含可能的自定义兴趣类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
ENABLED 启用状态 - 自定义兴趣已启用,可以定位。
REMOVED “已移除”状态 - 自定义兴趣已移除,无法用于定位。

CustomInterestType

包含可能的自定义兴趣类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CUSTOM_AFFINITY 允许品牌推广广告客户定义自定义的兴趣相似受众群体名单。
CUSTOM_INTENT 允许广告客户定义自定义的意向受众群体名单。

CustomInterestMember

自定义兴趣受众群体的成员。成员可以是关键字或网址。它是不可更改的,也就是说,它只能创建或移除,而不能更改。

JSON 表示法
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
字段
memberType

enum (CustomInterestMemberType)

自定义兴趣成员的类型,即“KEYWORD”或“网址”。

parameter

string

当成员类型为 KEYWORD 时,为关键字文本;当 memberType 为 网址 时,为网址字符串。

CustomInterestMemberType

包含可能的自定义兴趣成员类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
KEYWORD 自定义兴趣成员类型“KEYWORD”。
URL 自定义兴趣成员类型网址。