接口文档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_XIJING, ASSET_TYPE_CANVAS_WECHAT, ASSET_TYPE_CANVAS_IMAGE, ASSET_TYPE_CANVAS_VIDEO }
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_AGENCY, ASSET_TYPE_ACCOUNT_MDM, ASSET_TYPE_GROUP_BM, ASSET_TYPE_GROUP_AGENCY, ASSET_TYPE_GROUP_MDM, ASSET_TYPE_GROUP_POINT_TO_POINT }

使用说明

  1. 素材图片、视频资产授权功能目前白名单灰度中,若要使用可联系运营开通。
  2. 当 asset_type 为 ASSET_TYPE_CANVAS_WECHAT 时,asset_permission_spec、licensing_account_id_list 为必填项。
  3. 当 asset_type 为 ASSET_TYPE_XIJING 时,asset_permission_spec、licensing_id_type 为必填项,且 account_id 不支持代理商 id。
  4. 微信原生推广页只支持资产层级授权、蹊径落地页只支持账户层级授权。
  5. 当 licensing_id_type 为点对点 ASSET_TYPE_GROUP_POINT_TO_POINT 时,licensing_account_id_list 必填。
  6. 当 licensing_id_type 为同主体 ASSET_TYPE_GROUP_MDM 时,表示授权给 account_id 相同主体下所有的账号(包括未来新增的账号)。

请求示例


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=[]' 
					

应答字段

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": ""
}

可视化调试工具