素材 DCA 标签绑定查询

所属权限 ads_management
请求地址 material_dcatag/get
请求方法 GET

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
integer 广告主帐号 id
image_id_list
integer[] 图片素材 id 列表,image_id_list 和 media_id_list 不能同时为空
media_id_list
integer[] 视频素材 id 列表,image_id_list 和 media_id_list 不能同时为空

请求示例


curl -v -G 'https://api.e.qq.com/v3.0/material_dcatag/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'image_id_list=[]' \
-d 'media_id_list=[]' 
					

应答字段

名称 类型 描述
list
struct[] 已绑定列表
image_id
integer 图片素材 id
media_id
integer 视频素材 id
info
struct[] 素材属性信息列表
name
string 素材属性名称
value
string 素材属性值
set_name
string 素材集合名称
marketing_asset_id
integer 推广产品 id
marketing_asset_outer_id
string 推广产品外部 id
marketing_target_type
string 推广内容资产类型
audit_status
integer 审核状态,0: 待审; 1: 通过; 2: 拒绝
audit_msg
string 审核拒绝原因
dcatag_list
struct[] 素材标签集合
tag_name
string 素材标签 id
tag_value
string 素材标签值

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "info": [],
                "dcatag_list": []
            }
        ]
    }
}

可视化调试工具