搜狗首页  |   服务首页  |   客服热线:010-56898080

API参考  |  数据类型

MaterialStyle对象数据类型如下表:

属性名 类型 说明 限制
deviceType long 设备类型 2:移动
materialType int 物料类型 7:短子链-组合
8:长子链-组合
9:图片-单图
18:图文
11:短子链-单条
37:长子链-单条
52:图集组件
content string 物料内容 参考下面content格式定义
ispause int 是否暂停 0:启用,1:暂停
materialStyleGrps MaterialStyleGrpDto[] 绑定关系
status int 审核状态 正常:105,
审核中:106,
拒绝:107,
暂停:108

MaterialStyleGrpDto对象数据类型如下表:

属性名 类型 说明 限制
level int 绑定层级 必填;短子链可绑定:账户(仅限50个短子链)、计划(仅限10个短子链)、推广组(仅限10个短子链); 长子链仅可绑定:账户层级(仅限50个短子链)、计划(仅限10个短子链)、推广组(仅限10个短子链); 单图和图集组件可绑定:账户(仅限30个单图)、计划(仅限10个单图)、推广组(仅限5个单图); 图文组件可绑定:推广组(仅限1个图文)
targetId long 绑定目标id 必填


content格式说明:

materialType:7&11 短子链content参数说明:

materialType:7(短子链组,共4组name&url,前两组必填)

materialType:11(短子链单条,仅一组name&url必填)

参数名 类型 说明 content内容格式(json)
name string 名称(必填,8~16个字节) {"nameUrlList":[{"name":"","content":"","url":""}]}
url string URL(必填,1~1024个字节)
content 无用字段,废弃

materialType:8&37 长子链content参数说明:

materialType:8(长子链组,共3组name&url&content,均必填)

materialType:37(长子链单条,共1组name&url&content,必填)

参数名 类型 说明 content内容格式(json)
name string 名称(必填,两个汉字) {"nameUrlList":[{"name":"","content":"","url":""}]}
url string URL(必填,1~1024个字节)
content string 内容(必填,12~40个字节)

materialType:9 图片-单图组件content参数说明:

注:新增和修改图片类型组件,先请求图片上传接口上传图片,用返回的"picUrl" "smallPicUrl"填充单图组件参数体,再请求新增修改组件接口

参数名 类型 说明 content内容格式(json)
bigPicUrl string 必填;图片地址(图片尺寸校验:比例1:1,不小于330*330;图片格式: JPG、JPEG、PNG,图片大小:小于220k)
这里的bigPicUrl和smallPicUrl链接通过图片上传接口获取
{"bigPicUrl":" ","smallPicUrl":" ","themes":[" "],"width":0,"height":0,"beauty":" ","color":" ","composition":" ","express":" ","logo":" ","sharp":" ","visitUrl":" "}
smallPicUrl string 小图,必填,可通过图片上传接口获取
visitUrl string 选填;访问URL(0-1024字节)
themes string[] 必填,标签(仅限汉字、数字、英文,不能超过40个字节,每个图片仅限5个主题)
width int 原图图片高
height int 原图图片宽
其他字段忽略

materialType:18 图文组件content参数说明:

注:新增和修改图片类型组件,先请求图片上传接口上传图片,用返回的"picUrl"填充图文组件参数体,再请求新增修改组件接口

参数名 类型 说明 content内容格式(json)
pic1 PicTextPictureDto 必填;PicTextPictureDto 具体格式参加下方表格 {"pic1":{"picDesc1":" ","picDesc1Id":1,"picId":1,"picUrl":" ","picVisitUrl":" "},"pic2":{"picDesc1":" ","picDesc1Id":1,"picId":2,"picUrl":" ","picVisitUrl":" "},"pic3":{"picDesc1":" ","picDesc1Id":1,"picId":3,"picUrl":" ","picVisitUrl":" "}}
pic2
pic3

PicTextPictureDto 参数格式说明:

参数名 类型 说明
picDesc1 string 必填;产品说明1:允许输入4-16个字节
picDesc1Id long 仅修改图文内容时使用,参数值由接口返回。
picId long 仅修改图文内容时使用,参数值由接口返回。
picUrl string 必填;图片地址(图片尺寸校验:比例1:1,不小于330*330;图片格式: JPG、JPEG、PNG,图片大小:小于220k)
这里的picUrl链接通过图片上传接口获取
picVisitUrl string 选填;访问URL(0-1024字节)

materialType:52 图集组件content参数说明:

注:新增和修改图片类型组件,先请求图片上传接口上传图片,用返回的"picUrl"填充图集组件参数体,再请求新增修改组件接口

参数名 类型 说明 content内容格式(json)
pic1 PicTextPictureDto 必填;PicTextPictureDto 具体格式参加下方表格 {"pic1":{"picId":1,"picUrl":" ","picVisitUrl":" "},"pic2":{"picId":2,"picUrl":" ","picVisitUrl":" "},"pic3":{"picId":3,"picUrl":" ","picVisitUrl":" "},"themes":[" "]}
pic2
pic3
pic3 string[] 必填,标签(仅限汉字、数字、英文,不能超过40个字节,每个图片仅限5个主题)

PicTextPictureDto 参数格式说明:

参数名 类型 说明
picId long 仅修改图集内容时使用,参数值由接口返回。
picUrl string 必填;图片地址(图片尺寸校验:比例1:1,不小于330*330;图片格式: JPG、JPEG、PNG,图片大小:小于220k)
这里的picUrl链接通过图片上传接口获取
picVisitUrl string 选填;访问URL(0-1024字节)