获取账单组列表

您可以使用本接口获取一个商务中心下的所有账单组。

代理商商务中心和直客商务中心都能执行账单组相关操作。

注意
只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用/bc/member/invite/ 和 /bc/member/update/设置或更改成员权限。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3 接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/bc/billing_group/get/| /v1.3/bc/billing_group/get/| |请求参数名称 |recon_object<br>advertiser_type|invoice_mode<br>billing_group_type| |请求参数类型|bc_id: number<br>billing_group_id: number|bc_id: string <br>billing_group_id: string| |新增请求参数 | / |status| |返回参数名称|recon_object<br>advertiser_type<br> advertiser_list|invoice_mode<br>billing_group_type<br>advertisers| |返回参数类型|advertiser_id: number<br>billing_group_id: number| advertiser_id: string <br>billing_group_id: string| |新增返回参数 | / |status` |

## 请求

**地址**
https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/get/

**方法**  GET

**Header**

``` xtable
|字段{30%}|类型{35%}|描述{35%}|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填} | string | 商务中心ID |
|filtering  |object|筛选条件|
#|status|string|您想要筛选的账单组状态。枚举值：`VALID`（有效），`INVALID`（无效）。 |
#|invoice_mode |string| 出账模式。 <br>枚举值： `ACCOUNT`: 合并出账。<br>`ADVERTISER`: 单独出账。|
#|billed_to_type|string |账单抬头类型。 <br>枚举值：`ACCOUNT`: 账单由代理商支付。<br>`ADVERTISER`: 账单由广告主支付。|
#|billing_group_id |string  |账单组ID|
#|billing_group_name|string |账单组名称 |
#|billing_group_type |string|   账单组中所有广告账户的广告类型。该设置无法更改。<br>枚举值：`AUCTION`, `RESERVATION`。|
|page|  number| 页码。默认值为1。|
|page_size| number| 页面大小。范围为1-50，默认值为10。|

示例

(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "bc_id=BC_ID" \
--data-urlencode "filtering={\"invoice_mode\": \"INVOICE_MODE\", \"billed_to_type\": \"BILLED_TO_TYPE\", \"billing_group_id\": \"BILLING_GROUP_ID\", \"billing_group_name\": \"BILLING_GROUP_NAME\", \"billing_group_type\": \"BILLING_GROUP_TYPE\"}" \
--data-urlencode "page=PAGE" \
--data-urlencode "page_size=PAGE_SIZE" \
https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/get/
(/code)

返回

|字段|类型|描述|
|---|---|---|
|code |number | 返回码。完整返回码列表及描述，可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string | 返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object| 返回数据|
#|list|object[]|账单组列表|
##|status|string|账单组状态。枚举值：`VALID`（有效），`INVALID`（无效）。 |
##|billing_group_id|string|账单组ID|
##|billing_group_name|string|账单组名称|
##|invoice_object_name|string|账单抬头名称|
##|is_primary|bool|本账单组是否是当前商务中心的默认账单组|
##|advertisers|object[]|本账单组内的广告账号列表|
###|advertiser_id|string|广告账号ID|
###|advertiser_name |string |广告账号名|
##|billing_group_emails|string[]|账单组邮件|
##|invoice_mode |string|出账模式。 <br>枚举值： `ACCOUNT`: 合并出账。<br>`ADVERTISER`: 单独出账。|
##|billed_to_type|string|账单抬头类型。 <br>枚举值：`ACCOUNT`: 账单由代理商支付。<br>`ADVERTISER`: 账单由广告主支付。|
##|billing_group_type|string|账单组中所有广告账户的广告类型。该设置无法更改。<br>枚举值：`AUCTION`, `RESERVATION`。 |
#|page_info|object|分页信息|
##|page|number|当前页码 |
##|page_size|number|页面大小|
##|total_number|number|总结果数|
##|total_page|number|总页数|
|request_id|string|请求的日志ID，唯一标识一个请求 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {}
} 
(/code)