所有文档

          百度信息流推广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秒。
          上一篇
          服务访问地址
          下一篇
          示例代码