跳到主要内容

资产权限授予


请求地址​

https://api.e.qq.com/v3.0/asset_permissions/add


请求方法​

POST


所属权限​

广告管理（Ads Management）


请求参数​

参数名描述
access_token授权令牌，完成 OAuth 2.0 授权后获得，参考开发者环境
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型​

application/json


请求体参数​

阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填

名称类型必填描述
account_idintegerY
推广帐号 id或 DataNexus 账号 id
asset_typeenumY
资产类型。见 枚举值
asset_permission_specarrayY
资产权限列表，数组最小长度 1，最大长度 100
asset_permission_grant_typeenumY
资产权限授予类型。见 枚举值
asset_idintegerC
资产 id，当资产权限授予类型为 ASSET_PERMISSION_GRANT_TYPE_ASSET 需要传入
licensing_account_id_listinteger[]
被授权账号 id 列表，数组，最大长度 100
licensing_id_typeenum
被授权账号类型，指明被授权账号的类型：ACCOUNT 类型为指定账户授权，GROUP 类型为对账号组内所有账号授权，见 枚举值
path_idinteger
被授权帐号 id 对应的商务管家 id 或 MDM id
permission_listenum[]
权限类型，目前只针对行为数据源资产和新人群包资产授权有效。数组最小长度 1，最大长度 100。见 枚举值

请求体示例​

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_type=ASSET_TYPE_DN_DATA_SOURCE' \
-d 'asset_permission_spec=[ { "asset_permission_grant_type":"ASSET_PERMISSION_GRANT_TYPE_ASSET",  "asset_id": 1111111111 } ],' \
-d 'licensing_account_id_list=[]' \
-d 'licensing_id_type=ASSET_TYPE_GROUP_POINT_TO_POINT',
-d 'permission_list=["PERMISSION_TYPE_PKAM"]'

应答体结构​

名称类型描述
fail_numinteger失败个数
success_numinteger成功个数
fail_reasonarray资产添加失败信息
account_idinteger推广帐号 id或 DataNexus 账号 id
asset_idinteger资产 id，当资产权限授予类型为 ASSET_PERMISSION_GRANT_TYPE_ASSET 需要传入
messagestring错误信息

应答体示例​

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


信息
  1. 商品库授权：支持资产层级授权，支持将账号内的某个商品库授权给同商务管家/同公司主体指定帐号、跨商务管家指定帐号、跨商务管家的全部帐号、同公司主体全部帐号和任意帐号。
  2. 行为数据源授权：支持资产层级授权，支持将账号内某个行为数据源授权给同商务管家/同公司主体全部账号、跨商务管家/跨公司主体全部账号和任意指定账号。
  3. 转化归因授权：支持资产层级授权，支持将账号内的某个转化 id 授权给同主体内的全部账号/指定账号。仅支持 ADQ 到 ADQ 的授权。
  4. 人群包授权：支持按资产维度进行授权，支持将账号内某个人群包授权给指定公司主体的全部账号、指定商务管家的全部账号和任意账号授权。授权到任意账号不用确认接收即可使用；授权到指定主体全部账号、指定商务管家全部账号时，需要确认接收后才可使用。



该内容是否有帮助？