资产权限授予
全部接口
V1.1
loading
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 } |
使用说明
- 素材图片、视频资产授权功能目前白名单灰度中，若要使用可联系运营开通。
- 当 asset_type 为 ASSET_TYPE_CANVAS_WECHAT 时，asset_permission_spec、licensing_account_id_list 为必填项。
- 当 asset_type 为 ASSET_TYPE_XIJING 时，asset_permission_spec、licensing_id_type 为必填项，且 account_id 不支持代理商 id。
- 微信原生推广页只支持资产层级授权、蹊径落地页只支持账户层级授权。
- 当 licensing_id_type 为点对点 ASSET_TYPE_GROUP_POINT_TO_POINT 时，licensing_account_id_list 必填。
- 当 licensing_id_type 为同主体 ASSET_TYPE_GROUP_MDM 时，表示授权给 account_id 相同主体下所有的账号（包括未来新增的账号）。
请求示例
curl 'https://api.e.qq.com/v1.1/asset_permissions/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'asset_permission_spec=[]' \
-d 'licensing_account_id_list=[]'
应答字段
无应答示例
{
"code": 0,
"message": "",
"message_cn": ""
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
