账户模块
所有文档

          百度信息流推广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
          	}
          }
          上一篇
          示例代码
          下一篇
          推广计划模块