作者： jqsz

广告账户充值状态查询

通过账号ID，查询账号的充值状态，GET请求

GET /account_recharge_status  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>, 
    "access_token": <String>,                                   
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString账号ID
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header": {
        "code": <Int> ,
        "message": <String> ,
        "search_id": <String>
    },
    "data": {
        "status": <Bool> ,
        "reason": <String> 
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回提示信息
search_idString唯一标识一个请求
dataObject
statusBool能否充值状态 True:可以充值, False:无法充值
reasonString无法充值原因

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1020该广告账户已被设置成违规账户
1021该广告账户的开户公司已被列入黑名单

广告账户breakdowns数据

通过账号ID，时间范围，查询账号的breakdowns数据，GET请求

GET /account_insights_breakdowns  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,                    
    "access_token": <String>, 
    "breakdowns":<String>,
    "time_range":{
        "since":<String>,
        "until":<String>
    },
    "fields": List<String>, 
    "limit": <Int>,
    "sort":  <String>,                   
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString广告账户ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
time_rangeObject
sinceString开始时间，YYYY-MM-DD
untilString结束时间，YYYY-MM-DD
fieldsList<String>查询的账户字段 eg[:’id’,’account_id’,’name’] 根据传入的字段返回相应字段值
limitInt最大值是200
sortString排序规则
req_headerObject
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header": {
        "code": <Int> ,
        "message": <String> ,
        "search_id": <String>
    },
    "data": [{
        "account_id": <String> ,
        "spend": <String> ,
        "country": <String> ,
        …
    }]
}
字段类型注释
resp_headerObject
codeInt
messageString
search_idString
dataJsonArray
account_idString
spendString
countryString
…

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1009fields 不能为空
1010fields 参数无效
1011Facebook API 请求超时
1015缺少时间范围相关参数或参数错误
1016时间范围的开始日期不能超过当前日期的37个月
1017total_postbacks 字段只能单独查询
1018缺少 breakdowns 参数或参数错误
1019sort 参数错误
1026limit最大值不能超过

广告账户消耗信息

通过账号ID，时间范围，spend，purchase_roas等条件查询账号的消耗数据，GET请求。

GET /account_insights  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,                    
    "access_token": <String>, 
    "time_range":{
        "since":<Date>,
        "until":<Date>,
    },
    "date_preset":<String>, 
    "fields": List<String>, 
    "time_increment":<String>,                   
    "req_header": { ​                               
        "search_id": <String>  ​                   
    },
    "platform":1
}
字段类型注释
idString广告账户ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
sinceDate开始时间，YYYY-MM-DD
untilDate结束时间，YYYY-MM-DD
date_presetString报告时间(如果传入time_range则忽略该字段)
enum{today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year}
fieldsList<String>查询的账户字段 eg[:’id’,’account_id’,’name’] 根据传入的字段返回相应字段值
time_incrementStringtime_increment=1是每天一条数据,time_increment=monthly是每个月一条数据,time_increment=all_days是整个时间段一条数据(不传time_increment默认就是all_days)
search_idString唯一标识一个请求
platformint1:meta；2:twitter；3:google；5:tiktok；12:taboola（只有meta平台支持按照字段查询）

返回的结果：

{
    "resp_header": {
        "code": <Int>,
        "message": <String>,
        "search_id": <String>
    },
    "data": [{
        "spend": <Decimal>,
        "purchase_roas": [{
            "action_type": <String>,
            "value": <String>
        }],
        …
        "date_start": <Date>,
        "date_stop": <Date>
    }]
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求
dataJsonArray
spendDecimal花费金额
purchase_roasJsonArray购买广告支出的总回报率（ROAS）
action_typeString行动类型，app_custom_event
valueString数值
…
date_startDate开始时间
date_stopDate结束时间

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1009fields 不能为空
1010fields 参数无效
1011Facebook API 请求超时
1015缺少时间范围相关参数或参数错误
1016时间范围的开始日期不能超过当前日期的37个月
1017total_postbacks 字段只能单独查询
1024time_increment 参数无效
1025单次查询分天消耗最多不能超过N天

广告账户信息

通过接口，获取账号详细的信息，GET请求

GET /account_info  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,                    
    "access_token": <String>,          
    "fields": List<String>,                    
    "req_header": { ​                               
        "search_id": <String>  ​                   
    },
    "platform":1     
}
字段类型注释
idString广告账户ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
fieldsList<String>查询的账户字段 eg[:’id’,’account_id’,’name’] 根据传入的字段返回相应字段值
search_idString唯一标识一个请求
platformint1:meta；3:google；5:tiktok；（只有meta平台支持按照字段查询）

返回的结果：

{
    "resp_header": {
        "code": <Int> ,
        "message": <String> ,
        "search_id": <String>
    },
    "data": {
        "account_id": <String>,
        "name": <String>,
        "spend_cap": <Int>,
        "amount_spent": <Int>,
        "account_status": <Int>,
        "created_time": <String>,
        "disable_reason": <Int>
        ……
    }
}
字段类型注释
resp_headerObject
codeInt返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求
dataObject
account_idString广告账户ID
nameString广告账户名称
spend_capInt额度-美分
amount_spentInt帐户当前花费的总金额
account_statusInt广告账户状态
created_timeString创建时间
disable_reasonInt帐户被禁用的原因
……

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1009fields 不能为空
1010fields 参数无效
1011Facebook API 请求超时

广告账号余额清零

通过接口，设置spend_cap:0.01; amount_spent:0 ,POST请求

POST /account_spend_cap_reset  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,                    
    "access_token": <String>,                   
    "req_header": { ​                               
        "search_id": <String>  ​                   
    },
    "platform":1   
}
字段类型注释
idString广告账户ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
search_idString唯一标识一个请求
platformint1:meta；3:google；5:tiktok

返回的结果：

{
    "resp_header":{
        "code":,
        "message": ,
        "search_id":
    },
    "data": {
        "amount": <Float>
    }
}
字段类型注释
codeString返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求
amountFloat金额

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1011Facebook API 请求超时
1013广告账户状态异常

广告账户已绑定BM列表

接口实现了通过账号ID，获取此账号已绑定的BM，GET请求。

GET /account_business_list  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,                    
    "access_token": <String>,          
    "fields": List<String>,                    
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString广告账户ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
fieldsList<String>查询的字段 eg:[‘id’,’name’,’permitted_tasks’]
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code": <Int>,
        "message" <String>:,
        "search_id" <String>:
}
    "data":[{
        "id": <String>,
        "name" <String>:,
        "permitted_tasks": List<String>,
        ...
    }]
}
字段类型注释
codeInt返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求
dataObject
idStringBM ID
nameStringBM名称
permitted_tasksList<String>被允许的任务列表

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1008business_id 不能为空
1011Facebook API 请求超时
1022Meta广告账户解绑BM功能暂停

广告账户解绑BM

通过接口，解除已绑定的BM，POST请求

POST /account_remove_bm  HTTP/1.1     
Host: /lb/api/v1/    
请求参数:    
{                    
    "id": <String>,                    
    "access_token": <String>,          
    "business_id": <String>,                    
    "req_header": { ​                               
        "search_id": <String>  ​                   
    }     
}
字段类型注释
idString广告账户ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
business_idStringBusiness Manager Id
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code":,
        "message": ,
        "search_id":
    }
}
字段类型注释
codeString返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1008business_id 不能为空
1011Facebook API 请求超时
1022Meta广告账户解绑BM功能暂停

广告账户绑定BM

通过接口，account_id绑定BM，POST请求

POST /account_binding_bm  HTTP/1.1    
Host: /lb/api/v1/   
请求参数:   
{               
    "id": <String>,               
    "access_token": <String>,     
    "business_id": <String>,               
    "req_header": { ​                      
        "search_id": <String>  ​              
    }    
}
字段类型注释
idString广告账户ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
business_idStringBusiness Manager Id
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header":{
        "code":,
        "message": ,
        "search_id":
    }
}
字段类型注释
codeString返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1008business_id 不能为空
1011Facebook API 请求超时

广告账户余额修改

通过接口修改账号的消耗上限，post请求

POST /change_spend_cap  HTTP/1.1   
Host: /lb/api/v1/  
请求参数:  
{          
    "id": <String>,          
    "access_token": <String>,
    "amount_usd": <Int>,          
    "req_header": { ​             
        "search_id": <String>  ​         
    },
    "platform":1
}
字段类型注释
idString账号ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
amount_usdInt金额美分 减少余额传负值，增加余额传正值
search_idString唯一标识一个请求
platformint1:meta；3:google；5:tiktok；12:taboola

返回的结果：

{
    "resp_header": {
        "code": <String>,
        "message": <String>,
        "search_id": <String>
    }
}
字段类型注释
codeString返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求

错误编码：

编码注释
1001系统异常
1002id 不能为空
1003id 参数无效
1004amount_usd 不能为空
1005amount_usd 参数无效
1007amount_usd 金额设置过低(spend_cap不能小于等于0)
1011Facebook API 请求超时
1013广告账户状态异常
1020该广告账户已被设置成违规账户
1021该广告账户的开户公司已被列入黑名单

下户详情

获取下户详情，包含账号信息，account_id,account_name等，GET请求

GET /get_aac_request_detail  HTTP/1.1  
Host: /lb/api/v1/ 
请求参数: 
{     
    "ad_account_creation_request_id": <String>,     
    "access_token": <String>,     
    "req_header": { ​        
    "search_id": <String>  ​    
    }  
}
字段类型注释
ad_account_creation_request_idString获取账号的请求ID
access_tokenString联系开发人员获取token，token是和公司主体绑定的
search_idString唯一标识一个请求

返回的结果：

{
    "resp_header": {
        "code": <Int> ,
        "message": <String> ,
        "search_id": <String>
    },
    "data": {
        "id": <String>,
        "status": <String>,
        "contact": {
        "name": <String> ,
        "email": <String>
    },
    "disapproval_reasons": [{
        "reason": <String> ,
        "note": <String>
    }],
    "request_change_reasons": [{
    "field": <String> ,
    "reason": <String> ,
    "note": <String>
    }],
    "official_website_url": <String> ,
    "legal_entity_name_in_local_language": <String> ,
    "address_in_local_language": <String> ,
    "promotable_page_ids": <List> ,
    "promotable_urls": <List> ,
    "promotable_app_ids": <List> ,
    "business_registration_id": <String> ,
    "vertical_v2": <String> ,
    "subvertical_v2": <String> ,
    "adaccounts": {
        "data": [{
            "name": <String> ,
            "account_id": <String> ,
        }]
    }
}
字段类型注释
codeInt返回的编码，1：成功
messageString返回的提示信息
search_idString唯一标识一个请求
dataObject
idString获取账号的请求ID
statusString下户状态
contactObject
nameString提交申请的人员名称
emailString联系邮箱
disapproval_reasonsObject
reasonString审批不通过的原因
noteString原因的详细注释
request_change_reasonsObject
fieldString申请需要修改的字段
reasonString申请需要修改的原因
noteString原因的详细解释
official_website_urlString官网
legal_entity_name_in_local_languageString开户公司名称
address_in_local_languageString地址
promotable_page_idsList<String>粉丝页ID列表
promotable_urlsList<String>推广链接列表
promotable_app_idsList<String>应用ID列表
business_registration_idString营业执照ID
vertical_v2String行业-新版本
subvertical_v2String子行业-新版本
adaccountsObject
dataJsonArray
nameString账号名称
account_idString账号ID

错误编码：

编码注释
1001系统异常