第三方创意图片制作
注意：该接口需要单独线下申请开通权限才能使用，具体请与您的运营接口人联系。地址：images_exchange/add
方式：POST
参数：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| account_id | integer | 广告主id | 有操作权限的帐号id | yes |
| crt_sizes | int[] (an array of int) | 广点通创意规格id集合 | yes | |
| targeting | targeting | 广告信息 | yes | |
| agency_id | string | 广点通侧平台ID | yes | |
| agency | agency | 平台方信息 | no | |
| shop | shop | 平台方信息 | no | |
| products | product_struct[] | 商品信息，可能有多个 | no | |
| advertisement | advertisement | 广告信息 | no | |
| preference | preference | 创意制作配置项 | no |
targeting：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| industry | integer | 广告行业，广点通的行业分类ID | yes | |
| gender | string | 性别 | no | |
| age | string | 年龄 | no | |
| area | string | 广告地域定向，广点通的地域ID | no |
agency：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| id | string | 广点通侧平台ID | no | |
| name | string | 平台方名称 | no | |
| logo | string | 平台方Logo地址 | no |
shop：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| id | string | 商户ID，广告主侧的数据 | yes | |
| name | string | 商户名称 | yes | |
| industry | integer | 广告行业，广点通的行业分类ID | yes | |
| logo | string | 商户Logo地址 | no |
product_struct：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| id | string | 商品ID，广告主侧的数据 | yes | |
| name | string | 商品名称 | yes | |
| category | string | 商品分类，广告主侧的分类定义 | yes |
advertisement：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| dest_url | string | 广告落地页地址 | yes | |
| slogan_type | string | 文案类型 | no | |
| text | string | 宣传语 | no | |
| sub_text | string | 副文案 | no | |
| keywords | string[] (an array of string) | 关键字 | 小于或等于30个字节 | no |
preference：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| provider_id | integer | 供应商ID | 小于2^63 | no |
| template_id | integer | 模板ID | 小于2^63 | no |
| count | integer | 对于每个规格，希望获得的创意数 | no | |
| time_limit | float | 希望的响应时间上限，可以是小数，单位：秒 | 大于等于0，至多6位小数 | no |
请求示例：
curl -k "https://api.e.qq.com/v1.0/images_exchange/add?access_token=<TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>" \
-d '{
"account_id": <ACCOUNT_ID>,
"crt_sizes": [
12
]
"targeting": {
"industry": 1579429517450445753,
"gender": "xx",
"age": "xx",
"area": "xx"
}
"agency_id": <AGENCY_ID>,
"agency": {
"id": "<ID>",
"name": "xxxxxxxx",
"logo": "https://img.58cdn.com.cn/logo/58/252_84/logo-o.png"
},
"shop": {
"id": "<ID>",
"name": "xxxxxxxx",
"industry": 1941716230860835163,
"logo": "https://img.58cdn.com.cn/logo/58/252_84/logo-o.png"
},
"products": [
{"id":"<ID>","name":"xxxxxxxx","category":"xxx"}
],
"advertisement": {
"dest_url": "https://www.example.com",
"slogan_type": "xxx",
"text": "xxxxxxxx",
"sub_text": "xxxxxxxx",
"keywords": ["keywords"]
},
"preference": {
"provider_id": "<PROVIDER_ID>",
"template_id": "<TEMPLATE_ID>",
"count": 15,
"time_limit": 165.584
}
}'返回字段：
| 名称 | 类型 | 描述 |
|---|---|---|
| total_count | integer | 生成创意总数 |
| valid_count | integer | 有效创意数 |
| creatives | creative_struct[] | 创意集合 |
| req_no | string | 用于跟踪请求处理过程的标识 |
creative_struct：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| creative_id | integer | 创意ID | 小于2^63 | yes |
| template_id | integer | 模板ID | 小于2^63 | no |
| crt_size | integer | 广点通创意规格ID | yes | |
| provider_id | integer | 供应商ID | 小于2^63 | yes |
| provider | provider | 供应商侧元数据 | yes | |
| content | content | 创意内容 | yes |
provider：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| creative_id | integer | 创意ID | 小于2^63 | yes |
| template_id | integer | 模板ID | 小于2^63 | no |
content：
| 名称 | 类型 | 描述 | 限制 | 是否必填 |
|---|---|---|---|---|
| title | string | 广告标题 | no | |
| desc | string | 广告描述信息 | no | |
| image_url | string | 图片地址 | no | |
| image_resource_key | string | 图片资源标识 | no | |
| image_md5 | string | 图片MD5 | no | |
| image2_url | string | 图片2地址 | no | |
| image2_resource_key | string | 图片2资源标识 | no | |
| image2_md5 | string | 图片2 MD5 | no |
返回示例：
{
code: 0, // [必填] 错误码
data: { // [必填] 实际数据节点
total_count: 123, // [必填] 生成创意总数
valid_count: 120, // [必填] 有效创意数
creatives: [ // [必填] 创意集合
{
creative_id: 123, // [必填] 创意 ID
template_id: 123, // [可选] 模板 ID
crt_size: 12, // [必填] 广点通创意规格 ID
provider_id: 123, // [必填] 供应商 ID
provider: { // [必填] 供应商侧元数据
creative_id: "the-creative-id", // [必填] 创意 ID
template_id: "the-template-id" // [可选] 模板 ID
},
content: { // [必填] 创意内容
title: "the-title", // [可选] 广告标题
desc: "the-desc", // [可选] 广告描述信息
image_url: "http://the-url-of-image", // [可选] 图片地址
image_resource_key: "venus:ctx-work:v1:806410-2814-612308-1", // [可选] 图片资源标识
image_md5: "md5-of-image", // [可选] 图片 MD5
image2_url: "http://the-url-of-image2", // [可选] 图片 2 地址
image2_resource_key: "venus:ctx-work:v1:806410-2980-612307-1", // [可选] 图片 2 资源标识
image2_md5: "md5-of-image2" // [可选] 图片 2 MD5
}
},
...
],
req_no: "6325d8c4-9f20-4d50-bf8c-5b951b7d5f38" // [可选] 用于跟踪请求处理过程的标识
}
}