定向包接口
所有文档

          百度信息流推广API

          定向包接口

          查询定向包

          接口描述

          查询定向包信息。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/AtpFeedService/getAtpFeed

          请求参数说明

          字段名称 类型 描述
          atpFeedFields array(string) 需要查询的定向包属性,属性名称即定向包对象定向设置列表的字段名称。
          注意:查询定向设置时,不应传"audience",而是传定向设置列表中需要的字段名称。某些定向信息内容可能较长(如意图词),请按照实际需要查询,以提高响应速度。
          ids array(number) 需要查询的定向包ID数组,最多填100个ID。
          如果不填,则查询该账户下所有的定向包。
          key string 定向包名字查询关键字。
          在ids字段查询的基础上返回定向包名字包括此字段的定向包信息

          响应参数说明

          响应内容为定向包对象数组,请参考其定义。

          请求示例

          POST /v1/feed/cloud/AtpFeedService/getAtpFeed HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header": {
                  "opUsername": "example",
                  "tgUsername": "example",
                  "bceUser": "example",
                  "opPassword": "example",
                  "tgPassword": "example"
              },
              "body": {
                  "ids": [3739688195],
                  "key": "定向包",
                  "atpFeedFields": [
                      "atpFeedId",
                      "atpFeedName",
                      "atpFeedDesc",
                      "subject",
                      "age",
                      "sex"
                  ]
              }
          }

          响应示例

          {
              "body": {
                  "data": [
                      {
                          "atpFeedId": 3739688195,
                          "atpFeedName": "atpFeedName",
                          "subject": 1,
                          "audience":{
                              "age": "1,2",
                              "sex": "1"
                          }
                      }
                  ]
              },
              "header": {
                  "oprs": 1,
                  "failures": [],
                  "succ": 1,
                  "oprtime": 0,
                  "desc": "success",
                  "status": 0
              }
          }

          新增定向包

          接口描述

          新增定向包。(说明:一个账户下最多有100个定向包)

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/AtpFeedService/addAtpFeed

          请求参数说明

          字段名称 类型 描述
          atpFeedTypes array(object) 定向包对象数组,请参考其定义。

          响应参数说明

          响应为定向包对象数组,请参考其定义。

          响应结果中会包含新增成功的定向包ID信息。

          请求示例

          POST /v1/feed/cloud/AtpFeedService/addAtpFeed HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
          	"header": {
          		"opUsername": "example",
          		"tgUsername": "example",
          		"bceUser": "example",
          		"opPassword": "example",
          		"tgPassword": "example"
          	},
          	"body": {
          		"atpFeedTypes": [
                      {
                          "atpFeedName": "定向包",
                          "atpFeedDesc": "这是个定向包",
                          "ftypes": [],
                          "subject": 1,
                          "audience":{
                              "age": "1,2",
                              "sex": "1"
                          }
                      }
                  ]
          	}
          }

          响应示例

          {
            "body": {
              "data": [
                      {
                          "atpFeedId": 3739688195,
                          "atpFeedName": "定向包",
                          "atpFeedDesc": "这是个定向包",
                          "ftypes": [],
                          "subject": 1,
                          "audience":{
                              "age": "1,2",
                              "sex": "1"
                          }
                      }
                  ]
            },
            "header": {
              "oprs": 1,
              "failures": [],
              "succ": 1,
              "oprtime": 0,
              "desc": "success",
              "status": 0
            }
          }

          更新定向包

          接口描述

          更新定向包信息。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/AtpFeedService/updateAtpFeed

          请求参数说明

          字段名称 类型 描述
          atpFeedTypes array(object) 定向包对象数组,请参考其定义。

          注意:请求参数中的定向包ID为必填信息。

          响应参数说明

          响应为定向包对象数组,请参考其定义。

          请求示例

          POST /v1/feed/cloud/AtpFeedService/updateAtpFeed HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
          	"header": {
          		"opUsername": "example",
          		"tgUsername": "example",
          		"bceUser": "example",
          		"opPassword": "example",
          		"tgPassword": "example"
          	},
          	"body": {
          		"atpFeedTypes": [
                      {
                          "atpFeedId": 3739688195,
                          "atpFeedName": "修改定向包",
                          "atpFeedDesc": "修改了定向包",
                          "audience":{
                              "age": "1"
                          }
                      }
                  ]
          	}
          }

          响应示例

          {
            "body": {
              "data": [
                      {
                          "atpFeedId": 3739688195,
                          "atpFeedName": "修改定向包",
                          "atpFeedDesc": "修改了定向包",
                          "audience":{
                              "age": "1"
                          }
                      }
                  ]
            },
            "header": {
              "oprs": 1,
              "failures": [],
              "succ": 1,
              "oprtime": 0,
              "desc": "success",
              "status": 0
            }
          }

          删除定向包

          接口描述

          删除定向包。

          注意:删除后不可恢复,请谨慎操作。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/AtpFeedService/deleteAtpFeed

          请求参数说明

          字段名称 类型 描述
          atpFeedIds array(number) 需要删除的定向包ID。一次最多删除100个定向包。

          响应参数说明

          响应为定向包对象数组,但是仅包含被删除的定向包ID信息。

          请求示例

          POST /v1/feed/cloud/AtpFeedService/deleteAtpFeed HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
          	"header": {
          		"opUsername": "example",
          		"tgUsername": "example",
          		"bceUser": "example",
          		"opPassword": "example",
          		"tgPassword": "example"
          	},
          	"body": {
          		"atpFeedIds": [
          			3739688195,
          			3739688196,
          			3739688197
          		]
          	}
          }

          响应示例

          {
            "body": {
              "data": [
                {
                  "atpFeedId": 3739688195
                },
                {
                  "atpFeedId": 3739688196
                },
                {
                  "atpFeedId": 3739688197
                }
              ]
            },
            "header": {
              "oprs": 1,
              "failures": [],
              "succ": 1,
              "oprtime": 0,
              "desc": "success",
              "status": 0
            }
          }

          定向包绑定单元

          接口描述

          定向包绑定单元。

          注意:被绑定的单元定向会被定向包的定向完全覆盖,请谨慎操作。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/AtpFeedService/bindAtpFeed

          请求参数说明

          字段名称 类型 描述
          atpBindFeedTypes array(object) 定向包绑定对象数组,请参考其定义。

          响应参数说明

          响应为定向包绑定对象数组,仅返回绑定成功的单元ID。

          请求示例

          POST /v1/feed/cloud/AdgroupFeedService/bindAtpFeed HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header": {
                  "opUsername": "example",
                  "tgUsername": "example",
                  "bceUser": "example",
                  "opPassword": "example",
                  "tgPassword": "example"
              },
              "body": {
                  "atpBindFeedTypes": [
                      {
                          "atpFeedId": 3739688195,
                          "adgroupFeedIds": [3739688196,3739688197]
                      }
                  ]
              }
          }

          响应示例

          {
            "body": {
              "data": [
                {
                  "atpFeedId": 3739688195,
                  "adgroupFeedIds": [3739688196,3739688197]
                }
              ]
            },
            "header": {
              "oprs": 1,
              "failures": [],
              "succ": 1,
              "oprtime": 0,
              "desc": "success",
              "status": 0
            }
          }
          上一篇
          定向包对象
          下一篇
          定向包绑定对象