开发文档

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

获取创意规格列表及描述


地址:creative_templates/get

方式:GET

参数:

名称 类型 描述 限制 是否必填
creative_template_id integer 创意规格id no
site_set enum[] (an array of enum) 投放站点集合
[site_set_definition]
可选值:

  • SITE_SET_QZONE
  • SITE_SET_QQCLIENT
  • SITE_SET_MUSIC
  • SITE_SET_MOBILE_UNION
  • SITE_SET_QQCOM
  • SITE_SET_MAIL
  • SITE_SET_WECHAT
  • SITE_SET_MOBILE_INNER
no
product_type enum 标的物类型
[product_type]
可选值:

  • PRODUCT_TYPE_APP_ANDROID_
    OPEN_PLATFORM
  • PRODUCT_TYPE_APP_IOS
  • PRODUCT_TYPE_SHOP_WECHAT
  • PRODUCT_TYPE_LINK_WECHAT
  • PRODUCT_TYPE_LINK
no

请求示例:

curl -k "https://api.e.qq.com/v1.0/creative_templates/get?access_token=<TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>&site_set=["SITE_SET_QQCLIENT"]&product_type=PRODUCT_TYPE_LINK"

返回示例:


    {
        "code": 0,
        "message": "",
        "data": {
            "list": [
                {
                    "creative_template_id": 176,
                    "creative_preview": [],
                    "creative_template": {
                        "title": {
                            "default": "",
                            "fixed": "",
                            "name": "title",
                            "desc": "标题",
                            "comment": "",
                            "use": "required",
                            "min_occurs": 1,
                            "max_occurs": 1,
                            "type": "TEXT",
                            "dimension": {
                                "content": {
                                    "min_length": "0",
                                    "max_length": "6"
                                }
                            }
                        },
                        "description": {
                            "default": "",
                            "fixed": "",
                            "name": "description",
                            "desc": "文案",
                            "comment": "",
                            "use": "required",
                            "min_occurs": 1,
                            "max_occurs": 1,
                            "type": "TEXT",
                            "dimension": {
                                "content": {
                                    "min_length": "0",
                                    "max_length": "20"
                                }
                            }
                        },
                        "top_icon": {
                            "default": "",
                            "fixed": "",
                            "name": "top_icon",
                            "desc": "顶部图标",
                            "comment": "",
                            "use": "required",
                            "min_occurs": 1,
                            "max_occurs": 1,
                            "type": "IMAGE",
                            "dimension": {
                                "resource": {
                                    "width": "30",
                                    "height": "30",
                                    "file_size_KB_limit": "1024",
                                    "file_format": "*.jpg|*.jpeg|*.png",
                                    "min_duration": "",
                                    "max_duration": "",
                                    "duration_type": ""
                                }
                            }
                        },
                        "image": {
                            "default": "",
                            "fixed": "",
                            "name": "image",
                            "desc": "图片",
                            "comment": "",
                            "use": "required",
                            "min_occurs": 1,
                            "max_occurs": 1,
                            "type": "IMAGE",
                            "dimension": {
                                "resource": {
                                    "width": "1000",
                                    "height": "400",
                                    "file_size_KB_limit": "1024",
                                    "file_format": "*.jpg|*.jpeg|*.png",
                                    "min_duration": "",
                                    "max_duration": "",
                                    "duration_type": ""
                                }
                            }
                        },
                        "button_text": {
                            "default": "",
                            "fixed": "",
                            "name": "button_text",
                            "desc": "按钮文字",
                            "comment": "",
                            "use": "required",
                            "min_occurs": 1,
                            "max_occurs": 1,
                            "type": "TEXT",
                            "dimension": {
                                "content": {
                                    "min_length": "2",
                                    "max_length": "4"
                                }
                            }
                        },
                        "bottom_text": {
                            "default": "",
                            "fixed": "",
                            "name": "bottom_text",
                            "desc": "底部文字",
                            "comment": "",
                            "use": "required",
                            "min_occurs": 1,
                            "max_occurs": 1,
                            "type": "TEXT",
                            "dimension": {
                                "content": {
                                    "min_length": "6",
                                    "max_length": "8"
                                }
                            }
                        },
                        "activity_type": {
                            "type": "ENUM",
                            "name": "activity_type",
                            "default": "",
                            "fixed": "",
                            "use": "required",
                            "min_occurs": 1,
                            "max_occurs": 1,
                            "dimension": {
                                "option": [
                                    "BIRTHDAY_ACTIVITY_PAGE_CARD",
                                    "FESTIVAL_ACTIVITY_PAGE_CARD"
                                ]
                            },
                            "desc": {
                                "BIRTHDAY_ACTIVITY_PAGE_CARD": "生日页卡",
                                "FESTIVAL_ACTIVITY_PAGE_CARD": "节日页卡"
                            },
                            "comment": {
                                "BIRTHDAY_ACTIVITY_PAGE_CARD": "亲爱的XXX(昵称),你还有xx天就生日啦!",
                                "FESTIVAL_ACTIVITY_PAGE_CARD": "亲爱的XXX(昵称),"
                            }
                        }
                    }
                }
            ]
        }
    }