接口文档SDK业务专题开发者工具

资产权限授予
全部接口
V1.1
loading

所属权限 Ads Management
请求地址 asset_permissions/add
请求方法 post

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性
fields get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
asset_type*
enum 资产类型,[枚举详情]
枚举列表:{ ASSET_TYPE_NDMP, ASSET_TYPE_XIJING, ASSET_TYPE_CANVAS_WECHAT, ASSET_TYPE_CANVAS_IMAGE, ASSET_TYPE_CANVAS_VIDEO, ASSET_TYPE_FENGYE, ASSET_TYPE_DYNAMIC_AD_TEMPLATE, ASSET_TYPE_AD_QUALIFICATION, ASSET_TYPE_CATALOG, ASSET_TYPE_ACTION_SET, ASSET_TYPE_CONVERSION_SPEC, ASSET_TYPE_UNION_PACKAGE, ASSET_TYPE_ACCOUNT_WECHAT_CANVAS, ASSET_TYPE_PROFILE, ASSET_TYPE_LOCAL_STORE, ASSET_TYPE_INTERACTIVE_PRIVATE_TEMPLATE, ASSET_TYPE_DN_DATA_SOURCE, ASSET_TYPE_DN_DATA_SET, ASSET_TYPE_DN_FILE, ASSET_TYPE_SEARCH_BRAND_AREA }
asset_permission_spec*
struct[] 资产权限列表
数组最小长度 1,最大长度 100
asset_permission_grant_type*
enum 资产权限授予类型,[枚举详情]
枚举列表:{ ASSET_PERMISSION_GRANT_TYPE_ASSET, ASSET_PERMISSION_GRANT_TYPE_ACCOUNT }
asset_id
integer 资产 id,当资产权限授予类型为 ASSET_PERMISSION_GRANT_TYPE_ASSET 需要传入
licensing_account_id_list
integer[] 被授权账号 id 列表
数组最小长度 1,最大长度 100
licensing_id_type
enum 被授权账号类型,指明被授权账号的类型:ACCOUNT 类型为指定账户授权,GROUP 类型为对账号组内所有账号授权,[枚举详情]
枚举列表:{ ASSET_TYPE_ACCOUNT_BM, ASSET_TYPE_ACCOUNT_MDM, ASSET_TYPE_GROUP_BM, ASSET_TYPE_GROUP_MDM, ASSET_TYPE_GROUP_POINT_TO_POINT, ASSET_TYPE_AGENCY }
path_id
integer 被授权帐号 id 对应的商务管家 id 或 MDM id
permission_list
enum[] 权限 id 列表,目前只针对行为数据源资产和新人群包资产授权有效,[枚举详情]
数组最小长度 1,最大长度 100
枚举列表:{ PERMISSION_TYPE_AUDIENCE, PERMISSION_TYPE_CLAIM, PERMISSION_TYPE_ALLOW_ADVERTISE, PERMISSION_TYPE_ALLOW_INSIGHT, PERMISSION_TYPE_ALLOW_REPROCESS, PERMISSION_TYPE_DMP, PERMISSION_TYPE_TRANSFORMATION_ATTRIBUTION, PERMISSION_TYPE_PKAM, PERMISSION_TYPE_DPA }

使用说明

  1. 创意素材授权:创意素材资的产类型包括素材图片资产(ASSET_TYPE_CANVAS_IMAGE)和素材视频资产(ASSET_TYPE_CANVAS_VIDEO),仅支持按账号层级授权(ASSET_PERMISSION_GRANT_TYPE_ACCOUNT),支持将账号内所有素材授权给同商务管家/同公司主体下指定账号、同商务管家下所有账号、同公司主体下所有账号。仅支持 ADQ 到 ADQ 的授权。
  2. 原生落地页授权(新)(ASSET_TYPE_ACCOUNT_WECHAT_CANVAS):目前支持账号层级授权,支持将账号所有的原生页(包括后续新增)授权同商务管家/同公司主体下指定账号、同商务管家下所有账号、同公司主体下所有账号;在授权原生页的同时会自动将授权账号中的图片、视频素材进行授权。
  3. 蹊径落地页授权(新):支持账号层级授权,支持将账号所有的蹊径落地页(包括后续新增)授权同商务管家/同公司主体下指定账号、同商务管家下所有账号、同公司主体下所有账号;在授权蹊径落地页的同时会自动将授权账号中的所有原生落地页、图片、视频素材进行授权。(旧的点对点类型授权不再支持新接入,已接入用户不受影响,但使用点对点授权时,不支持蹊径性能版,也不会自动授权原生落地页、图片、视频素材,如需使用蹊径性能版请接入新版授权能力)。
  4. 枫叶落地页授权:支持账户层级授权,支持将账号内所有枫叶落地页授权给同商务管家/同公司主体指定账号、跨商务管家指定账号、跨商务管家的全部账号、同公司主体全部账号。
  5. 动态商品模板授权:支持账户层级授权,支持将账号内所有动态商品模板授权给同商务管家/同公司主体指定账号、跨商务管家指定账号、跨商务管家的全部账号、同公司主体全部账号。
  6. 广告资质必须审核通过才能授权;一次只能授权一个广告资质;可共享的资质包括:投放端广告资质下的授权/合同、证明/报告、其他;子客共享范围支持同一代理商下相同主体的全部子客间共享(不需要单个选子客);直客共享范围为相同主体均可共享;登录的账号必须有 mdmid 才可共享。仅支持 ADQ 到 ADQ 的授权。
  7. 商品库授权:支持资产层级授权,支持将账号内的某个商品库授权给同商务管家/同公司主体指定帐号、跨商务管家指定帐号、跨商务管家的全部帐号、同公司主体全部帐号和任意帐号。
  8. 行为数据源授权:支持资产层级授权,支持将账号内某个行为数据源授权给同商务管家/同公司主体全部账号、跨商务管家/跨公司主体全部账号和任意指定账号。
  9. 转化归因授权:支持资产层级授权,支持将账号内的某个转化 id 授权给同主体内的全部账号/指定账号。仅支持 ADQ 到 ADQ 的授权。
  10. 新人群包授权:支持按资产维度进行授权,支持将账号内某个人群包授权给指定公司主体的全部账号、指定商务管家的全部账号和任意账号授权。授权到任意账号不用确认接收即可使用;授权到指定主体全部账号、指定商务管家全部账号时,需要确认接收后才可使用。
  11. 流量包授权:支持资产层级授权,支持将账号内的某个流量包授权给指定主体/指定 BM 内的全部账号/指定账号。仅支持 ADQ 到 ADQ 的授权。
  12. 朋友圈头像昵称跳转页授权(ASSET_TYPE_PROFILE):支持资产层级授权,支持将账号内的某个资产授权给同商务管家/同公司主体下指定账号; 1 个账号下头像昵称跳转页最多 5 个(包括自建和被授权的资产),超过 5 个授权会报错。
  13. 门店资产管理:仅支持按账号层级授权,支持将账号内所有门店信息授权给同商务管家/同公司主体下指定账号、同商务管家下所有账号、同公司主体下所有账号。
  14. 互动私有模板:仅支持按账号层级授权,支持将账号内所有门店信息授权给同商务管家/同公司主体下指定账号、同商务管家下所有账号、同公司主体下所有账号。
  15. DataNexus 数据源授权(ASSET_TYPE_DN_DATA_SOURCE):支持资产层级授权,支持将账号内某个数据源授权给任意指定账号。授权时需指定应用场景(permission_list),授权后支持调用资产授权应用场景更新接口对应用场景进行更新。
  16. DataNexus 数据集授权(ASSET_TYPE_DN_DATA_SET):支持资产层级授权,支持将账号内某个数据集授权给任意指定账号。授权时需指定应用场景(permission_list),授权后支持调用资产授权应用场景更新接口对应用场景进行更新。
  17. DataNexus 文件授权(ASSET_TYPE_DN_FILE):支持资产层级授权,支持将账号内某个文件授权给任意指定账号。授权时需指定应用场景(permission_list),授权后支持调用资产授权应用场景更新接口对应用场景进行更新。
  18. 被授权资产不可做二次间接授权。
  19. 当 asset_type 为 ASSET_TYPE_CANVAS_WECHAT 时,asset_permission_spec、licensing_id_type、licensing_account_id_list 为必填项。
  20. 当 asset_type 为 ASSET_TYPE_CANVAS_IMAGE、ASSET_TYPE_CANVAS_VIDEO、ASSET_TYPE_XIJING、ASSET_TYPE_DYNAMIC_AD_TEMPLATE、ASSET_TYPE_FENGYE、ASSET_TYPE_AD_QUALIFICATION 时,asset_permission_spec、licensing_id_type 为必填项,且 account_id 不支持代理商 id。
  21. 当 licensing_id_type 为点对点 ASSET_TYPE_GROUP_POINT_TO_POINT 时,licensing_account_id_list 为必填项。
  22. 当 licensing_id_type 为公司主体 ASSET_TYPE_GROUP_MDM 时,表示授权给该公司主体下所有的账号(包括未来新增的账号)。
  23. 当 licensing_id_type 为商务管家 ASSET_TYPE_GROUP_BM 时,表示授权给该商务管家下所有的账号(包括未来新增的账号)。
  24. 按账号层级是指仅支持授权账号内的全部资产,不支持选择单个资产进行授权。
  25. 当 licensing_id_type 为 ASSET_TYPE_AGENCY 时,表示授权给服务商自身使用,其下子客不可用,当前仅支持人群包授权给服务商。

请求示例


curl 'https://api.e.qq.com/v1.1/asset_permissions/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'asset_permission_spec=[]' \
-d 'licensing_account_id_list=[]' \
-d 'permission_list=[]' 
					

应答字段

名称 类型 描述
fail_num
integer 失败个数
success_num
integer 成功个数
fail_reason
struct[] 资产添加失败信息
account_id
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
asset_id
integer 资产 id,当资产权限授予类型为 ASSET_PERMISSION_GRANT_TYPE_ASSET 需要传入
message
string 错误信息

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "fail_reason": [
            {
                "account_id": "<ACCOUNT_ID>",
                "message": ""
            }
        ]
    }
}

可视化调试工具