预授权资产列表获取

请求地址

https://api.e.qq.com/v3.0/asset_pre_permissions/get

请求方法

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_id	integer	Y	推广帐号 id或 DataNexus 账号 id
asset_type	enum	Y	资产类型。见 枚举值
asset_id	integer		资产 id
asset_name	string		资产名称。字段长度最小 0 字节，长度最大 90 字节
path_type	enum		资产授权路径类型。见 枚举值
page	integer		搜索页码，默认值：1。最小值 1，最大值 99999
page_size	integer		一页显示的数据条数，默认值：10。最小值 1，最大值 100

请求体示例

curl -G 'https://api.e.qq.com/v1.1/asset_pre_permissions/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'page=1' \
-d 'page_size=10' 

应答体结构

名称	类型	描述
page_info	object	分页信息
page	integer	当前页码
page_size	integer	一页显示的数据条数，默认值：10，最小值 1，最大值 100
total_number	integer	总行数
total_page	integer	总页数
list	array	返回信息列表
account_id	integer	推广帐号 id或 DataNexus 账号 id
owner_account_id	integer	推广帐号 id或 DataNexus 账号 id
asset_id	integer	资产 id
asset_name	string	资产名称
asset_type	enum	资产类型。见 枚举值
path_id	integer	当资产授权路径为 PATH_TYPE_POINT_TO_POINT 时，表示被授权帐号 id ；其他类型时为被授权帐号 id 对应的商务管家 id 或 MDM id
path_type	enum	资产授权路径类型。见 枚举值
is_granted_all	enum	资产授权维度
grant_time	integer	授权时间（时间戳）
permission_list	enum[]	权限类型，目前只针对行为数据源资产和新人群包资产授权有效，见 枚举值

应答体示例

{
  "code": 0,
  "message": "",
  "message_cn": "",
  "data": {
    "list": [
      {
        "account_id": "<ACCOUNT_ID>",
        "permission_list": []
      }
    ],
    "page_info": {
      "page": 1,
      "page_size": 10,
      "total_number": 1,
      "total_page": 1
    }
  }
}

信息

当资产类型为 ASSET_TYPE_NDMP，不支持同时按 asset_id 和 asset_name 查询。

该内容是否有帮助？