Skip to content

获取广告单元素材组

需要携带 Token,详情看 Token

获取创意组信息, 支持按条件分页查询

请求地址

https://ss-api.mintegral.com/api/open/v1/creative_sets

请求方法

GET

请求示例

json
GET /api/open/v1/creative_sets
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ "offer_id": 3028 }

请求参数

字段类型是否必填说明默认值例子
offer_idintN广告单元ID123
creative_set_idintN创意组ID123
creative_set_namestringN创意组名称set_name1
combination_methodintN创意制作方式-set_name1
pageintN分页, 从1开始11
limitintN分页每页记录数,默认10,最大501020

响应结果

字段类型说明
codeint200 表示成功,其他表示失败
msgstring成功,返回"success",失败返回相应的错误信息
datajson成功,返回素材组信息,失败返回具体的错误信息
  limitint数据页记录数上限
  pageint数据页
  totalint总记录数
  listarray<object>记录详情
    offer_idint广告单元ID
    creative_set_namestring创意组名称
    combination_methodint创意组创意组装方式
    ad_outputsarray<int>[枚举值 - 创意类型类型及要求尺寸]
    geosarray<string>投放地区
    creativesarray<object>创意组包含素材详情
      creative_namestring素材名称
      creative_md5string素材md5
      creative_typestring素材类型
      dimensionstring素材尺寸
      created_atint素材绑定到创意组的时间
      audit_statusint素材审核状态, 0为初始化,1为通过,2为拒审,3为审核中
      audit_reasonstring素材拒审原因

应答示例

json
{
  "msg": "success",
  "code": 200,
  "data": {
    "limit": 10,
    "page": 1,
    "total": 1,
    "list": [
      {
        "offer_id": 100,
        "creative_set_name": "test_group_1",
        "combination_method": 1,
        "ad_outputs": [
          111,
          121,
          131
        ],
        "geos": [
          "ALL"
        ],
        "creatives": [
          {
            "creative_name": "image_1.jpg",
            "creative_md5": "4066f7e9738eb0cfe87f59e752f8d64f",
            "creative_type": "IMAGE",
            "dimension": "1200x627",
            "created_at": 1714124002,
            "audit_status": 1,
            "audit_reason": ""
          },
          {
            "creative_name": "image_2.jpg",
            "creative_md5": "9d4af767418b5e20a936c7c07f017e39",
            "creative_type": "IMAGE",
            "dimension": "1200x627",
            "created_at": 1714124002,
            "audit_status": 1,
            "audit_reason": ""
          },
          {
            "creative_name": "video_1.jpg",
            "creative_md5": "9d4af767418b5e20a936c7c07f017e39",
            "creative_type": "VIDEO",
            "dimension": "1280x720",
            "created_at": 1714124002,
            "audit_status": 1,
            "audit_reason": ""
          }
        ]
      }
    ]
  }
}