名称 | 类型 | 描述 |
---|---|---|
account_id | integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
type* | string | 标签类型,可选值:REGION(地域),BUSINESS_DISTRICT(商圈),BUSINESS_INTEREST(商业兴趣,待下线),APP_CATEGORY(APP 类目),BEHAVIOR(行为),INTEREST(兴趣),INTENTION(意向),WECHAT_OFFICIAL_ACCOUNT_CATEGORY(微信流量类型定向),MOBILE_UNION_CATEGORY(移动媒体类型),DEVICE_BRAND_MODEL(设备品牌型号定向) |
tag_spec | struct | 获取定向标签的条件 |
behavior_spec | struct | 获取行为定向标签的条件,type 为 BEHAVIOR 时必填 |
query_mode* | enum | 定向标签查询方式,[枚举详情] 枚举列表:{ TARGETING_TAG_QUERY_MODE_SEARCH, TARGETING_TAG_QUERY_MODE_RECOMMEND, TARGETING_TAG_QUERY_MODE_COMMON, TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND, TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST } |
query_spec | struct | 查询定向标签的条件,当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST、TARGETING_TAG_QUERY_MODE_SEARCH 和 TARGETING_TAG_QUERY_MODE_RECOMMEND 时必填 |
query | string | 用于搜索或推荐的词 字段长度最小 1 字节,长度最大 200 字节 |
query_list | string[] | 批量检查关键词,应答结果仅返回有效关键词,当且仅当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST 时可填且必填 数组最小长度 1,最大长度 250 字段长度最小 1 字节,长度最大 64 字节 |
max_result_number | integer | 最大结果数,默认 10,最大结果数 最小值 1,最大值 50 |
excluding_targeting_tags | string[] | 已经选中的标签,在结果中不会再次出现 数组最小长度 1,最大长度 250 |
advanced_recommend_type | enum | 优质推荐类型,当 query_mode 为 TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND 时必填,[枚举详情] 枚举列表:{ ADVANCED_RECOMMEND_TYPE_SYSTEMATIC, ADVANCED_RECOMMEND_TYPE_INDUSTRY_HOT } |
interest_spec | struct | 获取兴趣定向标签的条件,type 为 INTEREST 时必填 |
query_mode* | enum | 定向标签查询方式,[枚举详情] 枚举列表:{ TARGETING_TAG_QUERY_MODE_SEARCH, TARGETING_TAG_QUERY_MODE_RECOMMEND, TARGETING_TAG_QUERY_MODE_COMMON, TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND, TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST } |
query_spec | struct | 查询定向标签的条件,当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST、TARGETING_TAG_QUERY_MODE_SEARCH 和 TARGETING_TAG_QUERY_MODE_RECOMMEND 时必填 |
query | string | 用于搜索或推荐的词 字段长度最小 1 字节,长度最大 200 字节 |
query_list | string[] | 批量检查关键词,应答结果仅返回有效关键词,当且仅当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST 时可填且必填 数组最小长度 1,最大长度 250 字段长度最小 1 字节,长度最大 64 字节 |
max_result_number | integer | 最大结果数,默认 10,最大结果数 最小值 1,最大值 50 |
excluding_targeting_tags | string[] | 已经选中的标签,在结果中不会再次出现 数组最小长度 1,最大长度 250 |
advanced_recommend_type | enum | 优质推荐类型,当 query_mode 为 TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND 时必填,[枚举详情] 枚举列表 :{ ADVANCED_RECOMMEND_TYPE_SYSTEMATIC, ADVANCED_RECOMMEND_TYPE_INDUSTRY_HOT } |
curl --location --request GET '/v1.3/targeting_tags/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'fields;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'type=REGION'
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"id": 110000,
"name": "北京市",
"parent_id": 0,
"parent_name": "",
"city_level": "CITY_LEVEL_FIRST"
}
]
}
}