进行图片处理
| 所属权限 | ads_management |
| 请求地址 | image_processing/add |
| 请求方法 | POST |
| Content-Type | application/json |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。
| 参数名称 | 参数类型 |
|---|---|
| access_token | 授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节 |
| timestamp |
当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59 |
| nonce | 随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性 |
请求参数
标有*的参数为必填项
| 名称 | 类型 | 描述 |
|---|---|---|
|
account_id*
|
integer | account_id |
|
image_id*
|
string | 图片 id 字段长度最小 1 字节，长度最大 64 字节 |
|
operation_type*
|
string | 操作类型 |
|
operation_spec*
|
struct | 处理操作信息 |
|
crop_customized_spec
|
struct | 裁剪信息，当且仅当 operation_type = OPERATION_TYPE_CROP_CUSTOMIZED 时,可填且必填 |
|
width*
|
integer | ，裁剪后的矩形宽度，单位 px，小于等于（原图的宽度-axis_x） 最小值 1，最大值 4000 |
|
height*
|
integer | ，裁剪后的矩形高度，单位 px，小于等于（原图的高度-axis_y） 最小值 1，最大值 4000 |
|
axis_x*
|
integer | ，裁剪矩形左上角顶点 X 坐标，单位 px，小于等于原图的宽度 最小值 0，最大值 4000 |
|
axis_y*
|
integer | ，裁剪矩形左上角顶点 Y 坐标，单位 px，小于等于原图的高度 最小值 0，最大值 4000 |
|
crop_smart_spec
|
struct | 智能裁剪信息，当且仅当 operation_type = OPERATION_TYPE_CROP_SMART 时,可填且必填 |
|
width*
|
integer | ，裁剪后的矩形宽度，单位 px，小于等于原图的宽度 最小值 1，最大值 4000 |
|
height*
|
integer | ，裁剪后的矩形高度，单位 px，小于等于原图的高度 最小值 1，最大值 4000 |
|
resize_spec
|
struct | 缩放信息，当且仅当 operation_type = OPERATION_TYPE_RESIZE 时,可填且必填 |
|
width*
|
integer | ，缩放后的矩形宽度，单位 px 最小值 1，最大值 4000 |
|
height*
|
integer | ，缩放后的矩形高度，单位 px 最小值 1，最大值 4000 |
|
crop_customized_spec_and_resize
|
struct | 自定义裁剪后缩放信息，当且仅当 operation_type = crop_customized_spec_and_resize 时,可填且必填 |
|
crop_width*
|
integer | ，裁剪后的矩形宽度，单位 px，小于等于（原图的宽度-axis_x） 最小值 1，最大值 4000 |
|
crop_height*
|
integer | ，裁剪后的矩形高度，单位 px，小于等于（原图的高度-axis_y） 最小值 1，最大值 4000 |
|
axis_x*
|
integer | ，裁剪矩形左上角顶点 X 坐标，单位 px，在原图片中的位置，小于等于原图的宽度 最小值 0，最大值 4000 |
|
axis_y*
|
integer | ，裁剪矩形左上角顶点 Y 坐标，单位 px，在原图片中的位置，小于等于原图的高度 最小值 0，最大值 4000 |
|
resize_width*
|
integer | ，对裁剪后的图片进行缩放后的矩形宽度，单位 px，缩放后的宽度：高度=缩放前的宽度：高度 最小值 1，最大值 4000 |
|
resize_height*
|
integer | ，对裁剪后的图片进行缩放后的矩形高度，单位 px，缩放后的宽度：高度=缩放前的宽度：高度 最小值 1，最大值 4000 |
|
file_size_max*
|
integer | ，操作后的图片大小的最大限制，单位 B(Byte) 可选范围：128-102400 最小值 128，最大值 102400 |
使用说明
- 支持裁剪和缩放的图片类型包括：PNG、JPEG。
请求示例
curl 'https://api.e.qq.com/v3.0/image_processing/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"account_id": 50259,
"image_id": "4421578",
"operation_type": "OPERATION_TYPE_CROP_CUSTOMIZED_AND_RESIZE",
"operation_spec": {
"crop_customized_spec_and_resize": {
"crop_width": 550,
"crop_height": 450,
"axis_x": 50,
"axis_y": 50,
"resize_width": 300,
"resize_height": 200
}
},
"file_size_max": 102400
}'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
image_id
|
string | 图片 id |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"image_id": "4421578"
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
