百度信息流推广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
      }
    }
    上一篇
    定向包对象
    下一篇
    定向包绑定对象