快手广告投放平台:获取联盟定向媒体包列表

请求接口:https://ad.e.kuaishou.com/rest/openapi/v1/asset/media/list

快手广告投放平台:获取联盟定向媒体包列表

请求方式:GET/POST

数据格式:JSON



请求参数

字段 类型 是否必填 说明 备注
advertiser_id long 必填 快手广告主 ID 在获取 access_token 的时候返回
media struct 选填 媒体包参数结构 用于支持搜索
is_related_unit bool 选填 是否关联广告组信息 默认 false
page int 选填 当前页码 默认为 1
page_size int 选填 分页大小 默认 20,最大不超过 50


字段 类型 是否必填 说明 备注
media_id long 选填 媒体包 ID
name string 选填 媒体包名字 修改媒体包名
source_type int 选填 媒体包来源 0-不限,未指定,1-行业优质流量包,2-广告主自定义,默认 0
pos_ids string[] 选填 快手广告开户位列表 修改媒体包广告位
status int 选填 状态 删除媒体包,0-下线,1-上线,默认 1


返回参数

字段 类型 说明 备注
code int 返回码
message string 返回信息
data struct 媒体包对象

data

字段 类型 说明 备注
datails struct[] 关联广告组信息列表
total_count long 总共条数


details

字段 类型 说明 备注
relate_units struct[] 关联广告组信息列表
media struct 媒体包信息

relate_units


字段 类型 说明 备注
unit_id long 快手信息流广告组 ID
unit_name string 广告组名字
campaign_id long 广告计划 ID
campaign_type int 广告计划类型 计划类型,过滤筛选条件:1 - 作品推广;2 - 提升应用安装;3 - 获取电商下单;4 - 推广品牌活动;5 - 收集销售线索;6 - 保量广告;7 - 提高应用活跃
put_status int 在投状态 UNKNOWN_PUT_STATUS = 0; // 默认值;PUT_STATUS_OPEN = 1; // 投放;PUT_STATUS_PAUSE = 2; // 暂停;PUT_STATUS_DeleteD = 3; // 删除
review_status int 审核状态 UNKNOWN_REVIEW_STATUS = 0; // 默认值;REVIEW_WAIT_AUDIT = 1; //审核中;REVIEW_THROUGH = 2; //通过审核;REVIEW_NOT_THROUGH = 3; //审核未通过;BANNED = 4; //封禁
media_using bool 媒体包是否在使用
media_type int 媒体包的使用类型 0-未知,1-定向,2-排除

media

字段 类型 说明 备注
media_id long 媒体包 ID
name string 媒体包名字
advertiser_id long 广告主 ID
source_type int 媒体包来源 0-不限,未指定,1-行业优质流量包,2-广告主自定义,默认 0
pos_ids string[] 广告位列表 修改媒体包广告位
status int 状态 删除媒体包,0-下线,1-上线,默认 1
create_time long 创建时间 时间戳
update_time long 更新时间
请求样例
curl -X POST \
 -H 'Access-Token: 69d99a7c1fdf3f4b271b' \
 -H 'Content-Type: application/json' \
 -d '{    "advertiser_id":20000152,    "media":{        "media_id":213123213,        "name":"新建定向媒体包",        "soruce_type":2,
    },    "is_related_unit": true,    "pageInfo":{        "current_page":1,        "page_size":10,
     }
}' -L https://ad.e.kuaishou.com/rest/openapi/v1/asset/media/list
返回样例 复制
{    "code":0,    "message":"OK",    "data":{        "details":[
            {                "media":{                    "media_id":337630,                    "advertiser_id":42932,                    "create_time":1603291774359,                    "update_time":1603291774359,                    "name":"test——2",                    "source_type":2,                    "pos_ids":[                        "sadsads231afasfs",                        "231erew232123231"
                    ],                    "status":1
                },                "relate_units":[
                    {                        "unit_id":1213,                        "unit_name":"媒体包测试组",                        "campaign_id":23213112,                        "campaign_type":2,                        "put_status":1,                        "media_type":1
                    }
                ]
            },
            {                "media":{                    "media_id":33890,                    "account_id":42932,                    "create_time":1563173027191,                    "update_time":1563173027191,                    "name":"模板_test_1",                    "source_type":2,                    "pos_ids":[                        "212wqeqwe1312",                        "23123eqweqwe21"
                    ],                    "status":1
                },                "relate_units":[
                    {                        "unit_id":1213,                        "unit_name":"媒体包测试组",                        "campaign_id":23213112,                        "campaign_type":2,                        "put_status":1,                        "media_type":1
                    }
                ]
            }
        ],         "total_count":2
    }
}

文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址:http://www.mqs.net/post/8830.html

相关阅读

添加新评论