文件列表获取

请求地址

https://api.e.qq.com/v1.1/data_nexus_file/get

请求方法

GET

所属权限

User Actions

请求参数

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

请求体类型

application/json

请求体参数

名称	类型	必填	描述
account_id	integer	Y	推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
file_id	integer		文件 id
page	integer		当前页码，默认 1, 最小值 1，最大值 2147483647
page_size	integer		分页大小，默认 10，最小值 1，最大值 100

请求体示例

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

应答体结构

名称	类型	描述
page_info	struct	分页信息
page	integer	当前页码
page_size	integer	分页大小
total_number	integer	总行数
total_page	integer	总页数
list	struct[]	文件列表
file_id	integer	文件 id
file_name	string	文件名称
file_desc	string	文件描述
status	enum	文件状态。枚举列表：{ NORMAL }
acccess_way	enum	文件来源。枚举列表：{ SELF_BUILT, BE_AUTHORIZED }
create_time	string	创建时间，格式为 yyyy-MM-dd HH:mm:ss，如 2016-11-01 10:42:56
scenes	struct[]	文件场景分发状态
scene	enum	应用场景。枚举列表：{ DMP, TRANSFORMATION_ATTRIBUTION, PK_AM }
dispathch_status	enum	文件分发状态。枚举列表：{ SWITCH_ON, SWITCH_OFF }
attach_info	struct	文件分发附属信息
data_source_id	integer	归因场景分发时关联的数据源 id

应答体示例

{
  "code": 0,
  "message": "",
  "message_cn": "",
  "data": {
    "page_info": {
      "page": 1,
      "page_size": 10,
      "total_number": 1,
      "total_page": 1
    },
    "list": [
      {
        "acccess_way": "SELF_BUILT",
        "create_time": "2022-12-29 15:53:05",
        "file_desc": "文件上传测试",
        "file_id": 1752,
        "file_name": "MKT_API 文件上传 242",
        "scenes": [
          {
            "dispathch_status": "UN_DISPATCHED",
            "scene": "PK_AM"
          },
          {
            "dispathch_status": "UN_DISPATCHED",
            "scene": "DMP"
          }
        ],
        "status": "NORMAL"
      }
    ]
  }
}