开发文档

为腾讯社交广告客户提供全面的技术和数据支持

查询可用的第三方创意图片模板


注意:该接口需要单独线下申请开通权限才能使用,具体请与您的运营接口人联系。地址:images_exchange_templates/get
方式:POST
参数:

名称 类型 描述 限制 是否必填
account_id integer 广告主ID 有操作权限的帐号id yes
crt_size integer 广点通创意规格ID yes

请求示例:

curl -k "https://api.e.qq.com/v1.0/images_exchange_templates/get?access_token=<TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>" \
    -d '{
            "account_id": <ACCOUNT_ID>,
            "crt_size": 12

    }'

返回字段:

名称 类型 描述
templates template_struct[] 创意模板集合

template_struct:

名称 类型 描述 限制 是否必填
template_id integer 模板ID 小于2^63 yes
provider_id integer 供应商ID 小于2^63 yes
provider provider 供应商侧元数据 yes
content content 创意内容 yes

provider:

名称 类型 描述 限制 是否必填
template_id integer 模板ID 小于2^63 yes

content:

名称 类型 描述 限制 是否必填
title string 广告标题 yes
desc string 广告描述信息 no
thumbnail_url string 模板缩略图地址 yes
version string 版本号 no
timestamp integer 更新时间戳,秒 no

返回示例:


    {
        code: 0,                                                    // [必填] 错误码
        data: {                                                     // [必填] 实际数据节点
            templates: [                                            // [必填] 创意模板集合
                {
                    template_id: 123,                               // [必填] 模板 ID
                    provider_id: 123,                               // [必填] 供应商标识
                    provider: {                                     // [必填] 供应商侧元数据
                        template_id: "the-template-id"              // [必填] 供应商模板 ID
                    },
                    content: {                                      // [必填] 模板内容
                        title: "the-title",                         // [必填] 模板标题
                        desc: "the-desc",                           // [可选] 模板描述信息
                        thumbnail_url: "http://the-url-of-thumb",   // [必填] 模板缩略图地址
                        version: 1,                                 // [可选] 版本号
                        timestamp: 1234567890                       // [可选] 更新时间戳,秒
                    }
                },
                ...
            ]
        }
    }