百度信息流推广API

    接口规范

    请求响应格式标准

    未特殊说明时,所有接口的请求、响应内容均为json格式、UTF-8编码的文本,分别在HTTP请求体和响应体中提供。 所有接口请求的HTTP Headers中需要提供必要的信息,如下:

    公共请求头

    公共头部 描述
    Authorization 包含Access Key与请求签名,具体参考鉴权认证机制
    Content-Type application/json; charset=utf-8。
    x-bce-date 表示日期的字符串,参考日期与时间规范

    HTTP协议的标准头域不再这里列出。公共头域将在每个百度信息流推广API中出现,是必需的头域。

    未特殊说明时,所有接口的请求和响应内容具有公共的结构,各接口的说明中仅提供公共结构之下“body”和“data”部分的说明。

    请求体结构:

    {
        "body": ..., // body的内容由具体接口定义,每个接口中“请求”部分即body的内容说明
        "header": {
            "opUsername": "xxxx", // 操作账户名称
            "opPassword": "xxxx", // 操作账户密码
            "tgUsername": "xxxx", // 被操作账户名称
            "tgPassword": "xxxx", // 被操作账户密码
            "bceUser": "xxxx" // BCE账户名
        }
    }

    在请求体中,“header”里需要填入百度推广账号的信息。三种不同权限的账号填写方法分别如下:

    普通权限:

      "header": {
        "opUsername":"operator_username",       // 操作账户用户名(信息流账户用户名)
        "opPassword":"*********"                // 操作账户密码(信息流账户密码)
        "tgUsername":"target_username", 		// 操作账户用户名(普通权限下tgUsername和opUsername传相同的用户名)
        "tgPassword":"*********", 		// 操作账户密码(普通权限下opPassword和tgPassword传相同的密码)
        "bceUser":"014df051fa131234a2a*****"    // 普通权限的操作账户,对应的百度智能云ID
      }

    账户管家权限:

      "header": {
        "opUsername":"operator_username",       // 管家账户用户名
        "opPassword":"*********",               // 管家账户密码
        "tgSubname":"target_username",          // 被操作的子账户
        "bceUser":"014df051fa131234a2a*****"    // 账户管家权限的操作账户,对应的百度智能云ID
      }

    代理商权限&工具商权限:

      "header": {
        "opUsername":"operator_username",       // 操作账户用户名(代理商账户用户名)
        "opPassword":"*********"                // 操作账户密码(代理商账户密码)
        "tgUsername":"target_username", 		// 被操作账户名(客户信息流账户用户名)
        "tgPassword":"*********", 		// 被操作账户密码(客户信息流账户密码)
        "bceUser":"014df051fa131234a2a*****"    // 代理商权限的操作账户,对应的百度智能云ID
      }

    公共响应头

    公共头部 描述
    Content-Type application/json; charset=utf-8。
    x-bce-request-id 后端生成,并自动设置到响应头域中。

    其中,request id使用UUID version4由百度信息流推广API服务生成。

    响应体结构:

    {
        "body": {
            "data": [...] // data为数组,内容由具体接口定义,每个接口中“响应”部分即data的内容说明
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    日期与时间规范

    日期与时间的表示有多种方式。为统一起见,除非是约定俗成或者有相应规范的,凡需要日期时间表示的地方一律采用UTC时间,遵循ISO 8601,并做以下约束:

    • 表示日期一律采用YYYY-MM-DD方式,例如2014-06-01表示2014年6月1日
    • 表示时间一律采用hh:mm:ss方式,并在最后加一个大写字母Z表示UTC时间。例如23:00:10Z表示UTC时间23点0分10秒。
    • 凡涉及日期和时间合并表示时,在两者中间加大写字母T,例如2014-06-01T23:00:10Z表示UTC时间2014年6月1日23点0分10秒。
    上一篇
    服务访问地址
    下一篇
    示例代码