磁力引擎
    • M-API 注册认证问题Q&A
    • M-API咨询类问题Q&A
    • 快速入门
      • 如何开通快手mapi
    • Oauth2.0授权
      • 授权流程
      • scope 权限说明
      • token管理
        • token有效期&续期
        • 获取 token
        • 刷新 token
    • 账户服务
      • 广告主
        • 获取广告账户信息
        • 获取广告账户余额信息
        • 获取广告账户流水信息
      • 账户罗盘
        • 获取罗盘绑定广告主列
        • 磁力罗盘对外 quota 腾挪接口
      • 代理商
        • 上传资质文件
        • 获取账号信息和开户资质
        • 创建或更新账户信息和开户资质
        • 创建或更新投放资质
        • 可复制账户列表
        • 复制账户
    • 广告投放
      • 账户层级
        • 账户日预算查询
        • 修改账户预算
        • 账户操作记录信息查询
      • 创编2.0(已下线)
        • 广告计划
          • 创建广告计划
          • 修改广告计划
          • 获取广告计划信息
          • 修改广告计划预算
        • 广告组
          • 创建广告组
          • 创建联盟定投广告组
          • 创建搜索广告组
          • 创建搜索快投广告组
          • 修改广告组
          • 修改联盟定投广告组
          • 修改搜索广告组
          • 修改搜索快投广告组
          • 定向人群预估查询
          • 获取广告组信息
        • 广告创意
          • 创建创意
          • 创建程序化 2.0 创意
          • 批量创建&修改创意
          • 修改创意
          • 修改程序化 2.0 创意
          • 获取广告创意信息
          • 获取程序化创意 2.0 信息
      • 创编3.0(已下线)
        • 广告创建接口
        • 广告创建接口(广告组和广告创意)
        • 广告计划更新接口
        • 广告组更新接口
        • 广告创意更新接口(程序化创意和自定义创意)
        • 广告详情接口
        • 广告计划详情接口
        • 广告组详情接口
        • 广告创意详情接口
      • 智能化创编
        • 广告计划
          • 创建广告计划
          • 修改广告计划
          • 获取广告计划信息
          • 修改广告计划状态
        • 广告组
          • 创建广告组
          • 修改广告组
          • 查询广告组
          • 修改广告组预算
          • 修改广告组状态
          • 修改广告组出价
        • 广告创意
          • 创建自定义创意
          • 创建程序化创意
          • 修改自定义创意
          • 修改程序化创意
          • 批量修改自定义创意
          • 查询自定义创意
          • 查询程序化创意
          • 修改创意状态
          • 创意体验
          • 创意标签填写建议
          • 获取程序化创意 2.0 审核信息
        • 批量获取监测链接接口
        • 监测链接批量更新接口
      • 高级创意
        • 获取高级创意列表
        • 创建高级创意接口
        • 删除高级创意接口
      • 搜索广告投放工具
        • 关键词管理
          • 获取关键词列表
          • 创建关键词
          • 修改关键词匹配方式
          • 修改关键词投放状态
          • 批量导出关键词
          • 获取关键词导出文件
        • 否定词管理
          • 获取否定词列表
          • 更新否定词
    • 数据报表
      • 异步任务数据报表
        • 创建历史数据查询任务
        • 获取任务状态
        • 数据下载
      • 直播报表
        • 报表新增直播数据
        • 直播间组件报表
        • 直播间报表
      • 获取原生效果数据整体概览接口(数据概览、分日转化数据分布、转化漏斗)
        POST
      • 原生效果数据报表明细接口
        POST
      • 查询原生快手号列表(for原生报表)
        POST
      • 代理商数据(t-1 数据需要第二天 9 点以后获取)
        POST
      • 广告主数据(实时)
        POST
      • 广告计划数据(实时)
        POST
      • 广告组数据
        POST
      • 广告创意数据-自定义
        POST
      • 程序化创意 2.0 数据
        POST
      • 素材报表
        POST
      • 人群分析报表
        POST
      • 小店通转化数据报表
        POST
      • 程序化落地页报表
        POST
      • 获取商品库报表
        POST
      • 关键词报表
        POST
      • 搜索词报表
        POST
      • 探索工具关键报表数据
        POST
    • 素材管理
      • 图片素材
        • 上传图片 v1 接口【逐步废弃,请使用V2接口】
        • 上传图片 v2 接口
        • 查询图片信息 get 接口
        • 查询图片接口 list 接口
        • 图片库推送
        • 获取可选的封面贴纸样式
      • 视频素材
        • 上传视频接口 v1【逐步废弃,请使用V2接口】
        • 上传视频接口 v2
        • 获取视频信息 get 接口(可通过 photo_ids 查询所有视频)
        • 获取视频信息 list 接口推荐使用,仅能查询平台&MAPI 上传,可查 uid 下所有非素造视频)
        • 批量删除视频
        • 上传图文视频
      • 视频库
        • 视频库-推送视频
        • 视频库-推送视频(新版)
        • 视频库-批量更新视频功能
        • 视频库-删除视频标签
        • 视频关联创意数查询
      • 文件上传
        • 图文音频文件MAPI上传
    • 素造平台
      • 获取素造视频接口
    • 建站管理
      • 魔力建站落地页信息查询接口
      • 魔力建站落地页批量创建接口
      • 魔力建站落地页更新CID信息
      • 魔力建站营销组件-表单查询接口
      • 魔力建站预约下载信息查询接口
      • 魔力建站落地页组信息查询接口
      • 魔力建站落地页组创建接口
      • 魔力建站落地页组更新接口
      • 魔力建站落地页组删除接口
      • 魔力建站落地页投放开关接口
    • 线索管理-老铁线索通
      • 线索通-批量创建微信小游戏
      • 线索通-获取微信小游戏列表
      • 线索 crm 信息查询接口
      • 线索 crm 意向度/进度/通话状态更新接口
      • 发起外呼接口
      • 获取通话记录
      • 线索crm赔付线索回传接口
    • DMP人群管理
      • 文件上传接口(新)
      • 人群包创建接口(新)
      • 人群包更新接口(新)
      • 人群列表查询接口
      • 人群包删除接口
      • 人群包跨账户推送
      • 人群包上线接口
      • 系统推荐定向/排除人群包
    • 联合建模
      • 样本文件上传
      • 通过上传方式新建样本
    • 工具
      • 短句
        • 通过快手号id查询授权短剧接口
        • 通过短剧id查询剧集列表
        • 获取授权的短剧作者列表
      • 查询工具
        • 创意相关
          • 获取创意推荐理由
        • 获取可选的深度优化目标
        • 获取可选的浅度优化目标
        • 获取可选的定向标签
        • 获取可选的应用定向
        • 获取可选的推荐封面
        • 获取可选的动态词包
        • 获取行动号召按钮
        • 获取可选的封面贴纸样式
        • 获取可用的转化目标
        • 获取可选白名单接口
        • 获取地域定向
        • 获取商圈地域定向
        • 获取可用咨询组件列表
        • MAPI Quota 白盒化
        • 获取创意分类查询接口
        • 快手网红-网红分类
        • 种子人群包列表
        • 快手网红-搜索快手网红
      • 功能名单
        • 获取创意分类标签白名单客户
        • 获取联盟投放白名单
      • 评论管理
        • 评论列表数据查询
        • 回复评论
        • 评论树查询
        • 屏蔽评论
        • 增加屏蔽评论信息
        • 删除屏蔽评论信息
        • 获取屏蔽评论信息列表
        • 评论管理-评论置顶
        • 评论管理-取消评论置顶
      • 应用列表
        • 获取应用列表
        • 应用权限信息列表接口
      • 行为兴趣标签-创意层级
        • 获取行为与兴趣"类目"
        • 获取行为兴趣"关键词"
      • 定向模板(新)
        • 创建定向模板
        • 更新定向模板
        • 查询定向模板
        • 删除定向模板
        • 定向模板同步
        • 模板同步失败查询
        • 查询模板关联的广告列表接口
        • 查询待升级模板列表
        • 模板升级
      • 小说库
        • 获取小说列表
        • 获取小说详情
        • 获取小说各分类枚举
        • 创建小说
        • 小说批量更新
        • 小说批量删除
        • 批量下载小说图片接口
        • 小说报表
        • 小说批量分享
      • 联盟自定义媒体包
        • 联盟定向媒体包创建
        • 联盟定向媒体包修改
        • 联盟定向媒体包删除
        • 获取联盟定向媒体包列表
        • 联盟定向媒体包广告位报表
      • 游戏试玩
        • 上传试玩素材
        • 直存试玩
        • 获取试玩按钮列表
        • 获取试玩列表
        • 试玩推送
        • 查看共享账户
      • 商品库
        • 商品库各行业商品数据校验规则
        • 查询 DPA 模板信息
        • 获取商品库列表
        • 获取商品库类目树
        • 创建商品
        • 更新商品
        • 获取商品列表
        • 获取商品列表(部分信息)
        • 获取商品列表(游标)
        • 获取SDPA创意视频模板
        • 批量模板合成SDPA创意视频
      • 出价建议
        • 批量获取广告组出价建议
        • 获取广告组曝光、转化预估
        • 获取广告组投放预估曲线
      • 直播推广
        • 获取主播列表
        • 获取直播间小铃铛列表
      • 探索工具
        • 一键复苏开启
        • 一键复苏关闭
        • 加速探索-开启接口
        • 加速探索关闭
        • 辅助探索开启
        • 探索工具状态查询
        • 探索工具报表
        • 探索工具使用记录
        • 探索工具关键报表数据
      • 智能托管
        • 枚举说明
        • 智能托管创建及更新接口
        • 智能托管状态更新
        • 智能托管删除接口
        • 获取智能托管详情接口
        • 获取智能托管物料接口
        • 智能托管报表接口
        • 分小说展开效果数据接口
      • 投前预估
        • 创建投前预估任务
        • 投前预估详情
        • 投前预估列表
        • 投前预估任务管理
      • 原生广告投放工具
        • 隐藏视频同步至个人主页
        • 获取快手号授权列表
        • 快手号授权接口
        • 获取达人原生视频列表接口
        • 共享授权接口
        • 共享授权结果
        • 共享授权-获取已共享授权授权记录
        • 获取原生快手号列表接口
        • 本地视频上传接口
    • 频控和创建限制
      • 频控和创建限制
      • 接口调用分级使用
    • 磁力聚星
      • 投后数据
        • 星视频--查询订单的投后数据
        • 星任务(视频)-查询任务的投后数据
        • 星任务(视频)-查询订单的投后数据
    • 转化归因
      • 转化归因信息合辑
        • 转化归因信息合辑
    • 应用管理
      • 接入前言
      • 文件上传【必选】
        • 【应用中心】上传 APK 文件
        • 【应用中心】上传图片
      • 应用创编【必选】
        • 【应用中心】创建 Android 应用
        • 【应用中心】创建 iOS 应用
        • 【应用中心】编辑 Android 应用
        • 【应用中心】更新 iOS 应用
      • 应用查询For单元投放【必选】
        • 获取新版应用发布列表【单元创编】
        • 获取新版分包发布列表【单元创编】
      • 应用查询For应用中心【可选】
        • 【应用中心】获取应用列表
        • 【应用中心】获取应用详情
      • 应用共享【可选】
        • 【应用中心】添加应用共享
        • 【应用中心】取消应用共享
        • 【应用中心】获取应用已共享账号列表
        • 【应用中心】获取应用已共享主体列表
        • 【应用中心】获取单个主体下共享账号列表
        • 【应用中心】获取可共享的主体列表
        • 【应用中心】获取可共享的账号列表
      • 应用操作【可选】
        • 【应用中心】iOS 应用上报更新
        • 【应用中心】发布应用
        • 【应用中心】应用上架
        • 【应用中心】应用下架
        • 【应用中心】应用商店上下架
      • 应用分包【可选】
        • 【应用中心】新建应用分包
        • 【应用中心】更新/恢复/删除应用分包
        • 【应用中心】修改应用分包备注
        • 【应用中心】获取分包管理/回收站列表
        • 【应用中心】分包失败,重新构建
      • 其他接口【可选】
        • 【应用中心】获取应用尚未发布的最新的应用包信息
        • 【应用中心】获取应用版本记录
        • 获取新版应用发布详情
        • 人群包数据
    • 附录
      • 3.0创编接口改动
      • 报错 code 枚举值

    M-API 注册认证问题Q&A

    1 注册成为快手Marketing API的开发者全流程介绍#

    开发者共分为三种角色
    广告主开发者: 该角色开发者只能操作&绑定注册时主体or新增主体下的账户,若绑定非主体账户会报错无权限操作。
    新增主体流程:广告主发起(抄送对应的销售&运营)发送至客户对应销售&运营——由销售or运营同学转发至(①mapi@kuaishou.com )
    	■ 邮件标题:【授权公司名称】+需要授权的appid+被授权公司名称
    	■ 邮件正文:写明原因+ 授权公司名称
    	■ 邮件资质:授权函+双方营业执照片(授权函模板地址:https://docs.corp.kuaishou.com/file/fcAAWFd6qyl_9gQEqEoD9lfCa)
    	■ 授权函模板:授权人(需要增加的营业执照名称)被授权人:(被增加的已有的营业执照名称)身份证、手机号:操作人的信息
    	■ 授权函模板盖章:授权人的章,被授权人:操作人的签名(最好盖两个公司的章哈)
    代理商开发者:该角色开发者只能操作代理商下账户,其他代理商账户无法操作。
    第三方服务商开发者:该角色开发者能绑定任意主体,但目前与快手合作的广告主&代理商有任何控股关系均无法成为服务商。
    image

    1.1 广告主/代理商注册成为开发者#

    1.1.1 进入开发者平台登录#

    快手账号登陆,登陆地址:https://developers.e.kuaishou.com/welcome
    image

    1.1.2 登陆后点击右上角注册成为开发者#

    image

    1.1.3 完善开发者联系人资料#

    image

    1.1.4 完善开发者资质信息#

    注意事项:#
    ● 管理员身份
        ○ 法人:
            ■ 适用场景:法人自己开通开放平台,成为快手开发者
            ■ 姓名填写规范:
                ● 法人信息一定要与营业执照名称一致,承诺函等一定要填写法人姓名
            ■ 清晰度:公章清晰,签字需要清晰可辨认
        ○ 代理人
            ■ 适用场景:当法人不方便提供相关信息/公司授权部门员工协助开通。
            ■ 姓名填写规范:
                ● 《账号运营授权委托书》授权人为公司主体,被授权人为代理人及相关信息
                ● 《快手广告管理平台 Market API 开发者企业认证授权书》,员工姓名选项一定为代理商人
    ● 开发者角色
        ○ 广告主:填写开通开发者的主体资质下任一一个广告投放账户id。
        ○ 代理商:填写代理商开户使用的快手id。
        
    image
    image

    1.1.5 提交资质等待审核,若审核不通过进入消息中心跳转修改。#

    如果账号提交成功,审核同学每日会进行审核,无需特批加急催促。
    image
    image

    1.2 第三方服务商成为开发者#

    选择开发这角色需要线下签订合同,一般在七个工作日内回复。其余步骤均与广告主/代理商注册开发者一致。

    1.2.1 签订服务商合同#

    需要线下审批并签订服务商入驻合同后,将服务商审批通过合同传与此处。
    image
    邮件主题:XX公司申请成为第三方开发者角色
    邮件内容:
    申请公司:/
    与快手现有合作业务:/
    公司介绍:/
    联系方式:电话或者微信号

    2 如何获取获取开发者ID#

    2.1 当开发者资质审核通过,需要注册应用才可获取appid及secret#

    当资质审通过,需要自主进行注册获取。
    image
      ● 需要添加内容:
      	○ 应用名称:主要目的方便区分不同应用
      	○ 应用图标:主要目的方便区分不同应用
      	○ 授权地址:主要目的为了跳转授权页面,拼接auth_code
      ● 需要注意事项:
      	○ 定义:该appid并非应用id,可以简单理解为开发者下面管理的开发者子账号;并非一个应用仅能使用一个appid,只要是主体资质相同均可进行授权。
      	○ 数量限制:一个开发者最多可以创建3个app,主要方便管理定义不同。

    2.2 获取app_id & secret & 授权链接#

    授权链接会自动拼接权限,部分特殊权限需平台管理员手动添加。
    app_id & secret为系统生成,请保存好app对应的secret方便调用获取token。

    3 正式调用接口,获取token#

    3.1 流程介绍#

    通过2.2获取回调地址授权获取auth_code(授权流程如3.3)——调用获取token接口(/rest/openapi/oauth2/authorize/access_token)输入传参:appid&secret&authcode

    3.2 参数解释#

    ● auth_code
    	○ 有效期:10min,或者当每次重新授权时均会重置
    	○ 具体功能:拼接校验主体内容,拼接参数为下一步获取准备。
    	○ 注意事项:auth_code只能使用一次,可重复进行上述授权操作获得新的auth_code
    
    ● access_token
    	○ 有效期:1天,或者当每次重新授权时均会重置
    	○ 具体功能:相当于账户密码,调用每个接口均需要输入。
    	○ 注意事项:账户or批量授权账户or代理商获取token均为一一对应,无法跨角色使用、
    
    ● refresh_token
    	○ 有效期:30天,或者当每次重新授权时均会重置
    	○ 具体功能:刷新token

    3.3 不同开发者角色授权流程#

    3.3.1 广告主授权流程#

    1)广告主登录需要被授权的广告投放账户(需要进入到投放平台账户的首页)
    2)然后将授权URL手动粘贴至浏览器中访问,点击界面上的授权按钮完成授权操作。
    3)授权回调 授权完成后,浏览器页面会自动跳转至授权URL中的回调地址,同时返回auth_code和state(拼接在回调地址后面),开发者使用auth_code进行后续授权操作

    3.3.2 代理商授权流程#

    1)代理商使用授权URL拼接&oauth_type=agent
    	○ 例子:developers.e.kuaishou.com/tools/authorize?app_id=1&scope=%5B%22report_service%22%5D&redirect_uri=https://e.kuaishou.com&oauth_type=agent&state=abc
    2)通过url登录代理商注册的快手id
    3)授权回调 授权完成后,浏览器页面会自动跳转至授权URL中的回调地址,同时返回auth_code和state(拼接在回调地址后面),开发者使用auth_code进行后续授权操作。

    3.3.3 客户罗盘授权流程(解决广告主单账户授权能力,实现批量授权)#

    授权流程:
    1)输入授权 URL-登陆账户罗盘-选择授权方式-确认授权-跳转获取 auth_code-通过接口获取 token
    2)浏览器中输入账户罗盘授权 URL,以下为举例 url。需要替换 URL 中对应开发者的 app_id&redirect_uri&对应 scope 权限。 
    	○ 举例https://developers.e.kuaishou.com/tools/authorize?app_id=1&scope=%5B%22ad_query%22%2C%22ad_manage%22%2C%22report_service%22%5D&redirect_uri=https://www.kuaishou.com&state=abcd
    3)登陆注册罗盘的快手 ID,获取账户罗盘绑定的账户 ID
    4)选择授权方式:基于广告账户授权/基于用户授权
    
    授权方式:
    1)基于广告账户授权:可选择多账户授权,基于广告账户授权。
    2)基于用户授权:可选择授权账户罗盘下全部账户,基于快手 ID 授权。

    3.4 调用接口获取token#

    3.4.1 获取token,对外文档介绍:https://developers.e.kuaishou.com/docs/1.4.1#

    3.4.2 刷新token,对外文档介绍:https://developers.e.kuaishou.com/docs/1.4.2#

    4 如何看懂开发者文档#

    4.1 如何看最近更新内容#

    关注开放平台更新日志,最新更新功能均会同步。

    4.2 如何找到想要接口文档及对应文档#

    1)定位层级及平台:首先定位想看账户的层级or那个平台,通过开发文档list确定需要找寻接口
    2)看请求接口链接,看请求方式:看接口介绍及接口的调用方式
    3)看接口请求参数及备注:看接口里面具体的参数对应的值是什么,并且具体读读备注内容很多隐藏规则均在备注中体现、
    4)请接口返回参数:查看接口返回参数,确定返回内容,实在不理解能看懂可查看下方事例。
    修改于 2023-10-25 09:48:23
    下一页
    M-API咨询类问题Q&A
    Built with