创建客户标签

curl --location --request POST '/v1.3/custom_tags/add' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --header 'Content-Type: application/json' \ --data-raw '{ "account_id": 111111111, "name": "car", "description": "car" }'

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access_token

string

必需

以Query Parameter方式在请求路径中传递。授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节。

默认值:

<ACCESS_TOKEN>

timestamp

string

必需

以Query Parameter方式在请求路径中传递。当前的时间戳，单位为秒，允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59

默认值:

nonce

string

必需

以Query Parameter方式在请求路径中传递。随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。

默认值:

<NONCE>

Body 参数application/json

account_id

integer

必需

推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id

name

string

必需

标签名称，标签树在同一父节点下的标签名称不能重复字段长度最小 1 字节，长度最大 32 字节

description

string

必需

标签描述字段长度最小 1 字节，长度最大 100 字节

parent_tag_id

integer

可选

父节点 id，不传，则默认为 0，表示该标签为根节点标签

tag_code

string

可选

广告主对标签在自己系统里的编码，只能包含数字或字母或下划线；如果该编码创建过标签，再次用该编码创建标签时，会返回之前用该编码创建的标签 id ；标签编码不能与人群编码(outer_audience_id)重复字段长度最小 1 字节，长度最大 128 字节

platform

string

可选

数据应用，不填写默认为 DMP，[枚举详情] 枚举列表：{ DMP, TDC, TDP }

示例

请求参数

返回响应