资产权限授予

请求参数

标有*的参数为必填项

名称	类型	描述
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 --location --request POST '/v1.3/asset_permissions/add' \ --header 'access_token: <ACCESS_TOKEN>' \ --header 'timestamp: <TIMESTAMP>' \ --header 'nonce: <NONCE>' \ --data-urlencode 'account_id=<ACCOUNT_ID>' \ --data-urlencode 'asset_permission_spec=[],' \ --data-urlencode 'licensing_account_id_list=[]' \ --data-urlencode 'permission_list=[]' \ --data-urlencode 'asset_type='

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

请求参数#

请求参数

返回响应

请求参数