百度信息流推广API

    账户模块

    账户信息对象

    账户信息对象定义了推广账户的属性,账户模块的多个接口均引用了其定义,请参考各个接口的使用说明。

    字段名称 类型 描述
    userId number 账户ID
    balance number 账户余额。
    此字段仅用于查询,updateAccountFeed接口传此字段无效。
    budget number 账户预算。
    默认为0,表示不限预算。
    正常取值范围为[100-9999999.99]
    balancePackage number 资金包类型。
    此字段仅用于查询,updateAccountFeed接口传此字段无效。
    取值范围如下:
    0:原生资金包
    1:凤巢资金包
    2:代理商原生资金包
    userStat number 账户状态。
    此字段仅用于查询,updateAccountFeed接口传此字段无效。
    取值范围如下:
    1:开户金未到
    2:生效
    3:账户余额为0零
    4:被拒绝
    6:审核中
    7:被禁用
    8:待激活
    11:账户预算不足
    uaStatus number 是否开通feed产品线权限。
    此字段仅用于查询,updateAccountFeed接口传此字段无效。
    取值范围如下:
    1:已开通
    2:待开通
    3:不允许开通(KA客户)
    validFlows array(number) 可投放流量。
    此字段仅用于查询,updateAccountFeed接口传此字段无效。
    数组为空时表示无可投放流量。流量类型与推广单元对象的ftypes字段定义保持一致,取值范围如下:
    1:手机百度
    2:贴吧
    4:百青藤
    8:好看视频

    RTA配置信息对象

    字段名称 类型 描述
    userId number userid,新增无效
    url string 接口地址,长度不超过1024个字符,http/https开头,不含空格,必填
    qps number 请求qps,大于等于0,0表示不限制(默认),单位次/秒,选填,此字段暂不生效
    cacheTime number 缓存时长,大于等于0,0表示不使用缓存(默认),单位秒,选填,此字段暂不生效
    strategyIds array(number) 策略ids,大于0,上限100个,选填
    customToken string 自定义token,最大256个字符,选填
    token string 百度认证token,系统自动生成,新增无效

    查询账户信息

    接口描述

    查询账户信息。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/getAccountFeed

    请求参数说明

    字段名称 类型 描述
    accountFeedFields array(string) 需要查询的账户属性。取值范围参考账户信息对象中的字段取值

    响应参数说明

    响应内容为账户信息对象,请参考其定义。

    请求示例

    POST /v1/feed/cloud/AccountFeedService/getAccountFeed 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: '*/*'
    // 普通权限
    {
      "body": {
        "accountFeedFields": [
          "userId",
          "balance",
          "budget",
          "balancePackage",
          "userStat"
        ]
      },
      "header": {
        "opUsername":"operator_username",       // 操作账户用户名(信息流账户用户名)
        "opPassword":"*********"                // 操作账户密码(信息流账户密码)
        "tgUsername":"target_username", 		// 操作账户用户名(普通权限下tgUsername和opUsername传相同的用户名)
        "tgPassword":"*********", 		// 操作账户密码(普通权限下opPassword和tgPassword传相同的密码)
        "bceUser":"014df051fa131234a2a*****"    // 普通权限的操作账户,对应的百度智能云ID
      }
    }
    
    //账户管家权限
    {
      "body": {
        "accountFeedFields": [
          "userId",
          "balance",
          "budget",
          "balancePackage",
          "userStat"
        ]
      },
      "header": {
        "opUsername":"operator_username",       // 管家账户用户名
        "opPassword":"*********",               // 管家账户密码
        "tgSubname":"target_username",          // 被操作的子账户
        "bceUser":"014df051fa131234a2a*****"    // 账户管家权限的操作账户,对应的百度智能云ID
      }
    }
    
    // 代理商权限&工具商权限
    {
      "body": {
        "accountFeedFields": [
          "userId",
          "balance",
          "budget",
          "balancePackage",
          "userStat"
        ]
      },
      "header": {
        "opUsername":"operator_username",       // 操作账户用户名(代理商账户用户名)
        "opPassword":"*********"                // 操作账户密码(代理商账户密码)
        "tgUsername":"target_username", 		// 被操作账户名(客户信息流账户用户名)
        "tgPassword":"*********", 		// 被操作账户密码(客户信息流账户密码)
        "bceUser":"014df051fa131234a2a*****"    // 代理商或工具商权限的操作账户,对应的百度智能云ID
      }
    }

    响应示例

    {
        "body": {
            "data": [
    			{
                    "userId": 123456,
                    "balance": 1234.56,
                   	"budget": 333.44,
                   	"balancePackage": 1,
                   	"userStat": 2,
                   	"uaStatus": 1,
                   	"validFlows": [1,2,4,8]
    			}
    		]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    更新账户设置

    接口描述

    更新账户设置。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/updateAccountFeed

    请求参数说明

    字段名称 类型 描述
    budget number 账户预算。
    默认为0,表示不限预算。
    正常取值范围为[50-9999999.99]

    响应参数说明

    响应内容为账户信息对象,请参考其定义。

    请求示例

    POST /v1/feed/cloud/AccountFeedService/updateAccountFeed 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": {
    		"accountFeedType": {
    			"budget": 3333.33
    		}
    	}
    }

    响应示例

    {
        "body": {
            "data": [
                {
                    "userId": 630152,
                    "budget": 3333.33
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    查询待加款项

    接口描述

    KA账户查询待加款项,此接口仅供KA账户使用

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/PaymentFeedService/getPaymentRecord

    请求参数说明

    字段名称 类型 描述
    id number 记录id,第一页数据不填,第二页及往后的数据必须填,升序填当前页最大id值,降序填当前页最小id值
    pageSize number 每页数量大小
    status number 待查询付款记录支付状态,0:待支付,1:已付款,2:已取消
    startTime string 支付时间-开始时间,选填,格式:yyyy-MM-dd HH:mm:ss
    endTime string 支付时间-结束时间,选填,格式:yyyy-MM-dd HH:mm:ss

    响应参数说明

    字段名称 类型 描述
    id number 付款记录 id
    uid number 实际支付用户 id
    payTime string 付款时间
    actTime string 资金到账时间
    cash number 现金金额
    bonus number 优惠金额
    actflag number 支付状态,0:待支付,1:已付款,2:已取消
    orderRow number 订单行号
    productName string 资金池名称
    accountName string 资金类型账号名
    payMethodName string 支付方式名称
    billStatus string 支付状态说明
    cacheTypeName string 待加款类型

    请求示例

    POST /v1/feed/cloud/PaymentFeedService/getPaymentRecord 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": {
            "id":3223423,
            "pageSize":50,
            "status":1,
            "startTime":"2018-12-01 12:12:12",
            "endTime":"2019-03-01 11:11:11"
        }
    }

    响应示例

    {
    	"body": {
            "data": [
                {
                    "uid": "21577",
                    "orderRow": "2",
                    "productName": "推广共享资金",
                    "billStatus": "尚未支付",
                    "cacheTypeName": "加款缓存",
                    "payTime": "2019-04-04 14:18:44",
                    "actFlag": "0",
                    "accountName": "推广总账户",
                    "id": "541027",
                    "actTime": "2019-01-02 00:00:00",
                    "cash": "100.00",
                    "bonus": "10.00",
                    "payMethodName": "大客户付款"
                }
            ]
        },
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    付款记录查询

    接口描述

    支持KA账户查询付款记录,此接口仅供KA账户使用

    请求路径

    http://sem.baidubce.com/v1/feed/cloud/PaymentFeedService/getPaymentHistory

    请求

    字段名称 类型 描述
    fundType number 资金类型,必填,21(ka 现金),22(ka 优惠)
    id number 记录id,第一页数据不填,第二页及往后的数据必须填,升序填当前页最大id值,降序填当前页最小id值,当前只支持降序
    pageSize number 每页数量大小,必填,每页数量必须大于0,小于等于1000
    startTime string 支付时间-开始时间,选填,格式:yyyy-MM-dd HH:mm:ss
    endTime string 支付时间-结束时间,选填,格式:yyyy-MM-dd HH:mm:ss

    响应

    字段名称 类型 描述
    id number 流水号
    userId number 用户id
    userName string 用户名
    mainAccountId number 主账户id
    mainAccountName string 主账户名
    fund number 金额,单位:元,正数表示加款,负数表示退款
    accountName string 账户类型
    fundPurpose string 资金用途
    payMethodName string 支付方式
    payTime string 加款时间,格式:yyyy-MM-dd HH:mm:ss
    orderId number 订单号

    请求示例

    POST /v1/feed/cloud/PaymentFeedService/getPaymentHistory 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": {
            "fundType": 21,
            "pageSize": 50,
            "startTime": "2019-01-01 00:00:00",
            "endTime": "2019-06-01 00:00:00",
        }
    }

    响应示例

    {
        "body": {
            "data": [
                {
                    "id": 4212131,
                    "userId": 3423,
                    "userName": "example",
                    "mainAccountId": 2347,
                    "mainAccountName": "example",
                    "fund": 1243.12,
                    "accountName": "推广总账户",
                    "fundPurpose": "推广共享资金",
                    "payMethodName": "产品转账",
                    "payTime": "2019-05-01 12:11:11",
                    "orderId": 327498237423
                }
            ]
        },
        "header": {
            "oprs": 1,
            "failures": [],
            "succ": 1,
            "oprtime": 0,
            "desc": "success",
            "status": 0
        }
    }

    账户管家查询下辖子账户

    接口描述

    账户管家查询下辖子账户,此接口仅供账户管家权限使用,查询操作账户即账户管家的下辖账户列表。header中的被操作账户可以传子账户中任意一个,对该接口功能无影响。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/MccFeedService/getUserListByMccid

    请求参数说明

    无请求内容

    响应参数说明

    字段名称 类型 描述
    userid number 用户id
    username string 用户名
    mccid number 账户管家id
    fatname string 账户管家名称
    remark string 备注

    请求示例

    POST /v1/feed/cloud/MccFeedService/getUserListByMccid 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",
                    "opPassword":"example",
    		"tgSubname":"example",
    		"bceUser":"example" 		
    	},
    	"body": {
    
        }
    }

    响应示例

    {
    	"body": {
            "data": [
                {
                    "userid": 234,
                    "username": "example",
                    "mccid": 32423,
                    "fatname": "example",
                    "remark": "备注"
                }
            ]
        },
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    账户管家查询子账户间转账记录

    接口描述

    账户管家查询其下辖子账户间的转账记录。header中的被操作账户可以传子账户中任意一个,对该接口功能无影响。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/MccHistoryService/getAccountTransferHistory

    请求参数说明

    字段名称 类型 描述
    startTime string 起始日期(包含)。格式为"YYYY-MM-DD",如"2019-01-01"。
    endTime string 结束日期(不包含)。格式为"YYYY-MM-DD",如"2019-01-31"。

    响应参数说明

    字段名称 类型 描述
    optid number 操作者账户ID
    optName string 操作者账户名称
    outUcId number 转出账户ID
    outUcName string 转出账户名称
    inUcId number 转入账户ID
    inUcName string 转入账户名称
    transferType string 转账类型
    transferMoney number 转账金额(单位:元)
    uuid string 转账记录ID
    transferTime string 转账时间。格式为"YYYY-MM-DD HH-MM-SS",如"2019-01-01 15:00:00"。

    请求示例

    POST /v1/feed/cloud/MccHistoryService/getAccountTransferHistory 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",
    		"opPassword":"example",
    		"tgSubname":"example",
    		"bceUser":"example" 		
    	},
    	"body": {
    		"startTime":"2019-11-12",
    		"endTime":"2019-11-13"
    	}
    }

    响应示例

    {
    	"body": {
    		"data": [
    			{
    				"optid": 12345,
    				"optName": "管家账户A",
    				"outUcId": 12346,
    				"outUcName": "推广账户B",
    				"inUcId": 12347,
    				"inUcName": "推广账户C",
    				"transferType": "推广资金池",
    				"transferMoney": "100.00",
    				"uuid": "25323463-26598762-22830277-100-feed-bf4we60a-23a4-4d8b-83aa-94c",
    				"transferTime": "2019-11-12 18:22:31"
    			}
    		]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    设置RTA配置信息

    接口描述

    设置账户RTA配置信息。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/updateRtaSettingFeed

    请求参数说明

    请求参数为RTA配置信息对象

    响应参数说明

    响应内容为RTA配置信息对象

    请求示例

    POST /v1/feed/cloud/AccountFeedService/updateRtaSettingFeed 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",
    		"opPassword":"example",
    		"tgSubname":"example",
    		"bceUser":"example" 		
    	},
    	"body": {
    		"url": "http://xxx.com",
        	"qps": 0,
    	    "cacheTime": 0,
    	    "strategyIds": [1,2,7],
    	    "customToken": "123abc"
      	}
    }

    响应示例

    {
    	"body": {
    		"data": [
                {
                    "userId": 123,
                    "url": "http://xxx.com",
        			"qps": 0,
    	    		"cacheTime": 0,
    	    		"strategyIds": [1,2,7],
    	    		"customToken": "123abc",
    	    		"token": "e7f7410ced6615749fd067ab6a0ff45b"
                }
            ]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    查询RTA配置信息

    接口描述

    查询账户RTA配置信息。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/getRtaSettingFeed

    请求参数说明

    响应参数说明

    响应内容为RTA配置信息对象

    请求示例

    POST /v1/feed/cloud/AccountFeedService/getRtaSettingFeed 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",
    		"opPassword":"example",
    		"tgSubname":"example",
    		"bceUser":"example" 		
    	},
    	"body": {}
    }

    响应示例

    {
    	"body": {
    		"data": [
                {
                    "userId": 123,
                    "url": "http://xxx.com",
        			"qps": 0,
    	    		"cacheTime": 0,
    	    		"strategyIds": [1,2,7],
    	    		"customToken": "123abc",
    	    		"token": "e7f7410ced6615749fd067ab6a0ff45b"
                }
            ]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }
    上一篇
    示例代码
    下一篇
    推广计划模块