获取账单组广告账户列表
您可以使用本接口获取一个账单组绑定的广告账户列表。
代理商商务中心和直客商务中心都能执行账单组相关操作。
注意
只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用/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/advertiser/list/| /v1.3/bc/billing_group/advertiser/list/|
|请求参数类型|bc_id: number<br>billing_group_id: number|bc_id: string <br>billing_group_id: string|
|返回参数类型|advertiser_id: number<br>| advertiser_id`: string |
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/advertiser/list/
**方法** GET
**Header**
``` xtable
|字段{30%}|类型{35%}|描述{35%}|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心ID |
|billing_group_id {必填}|string| 账单组ID |
|page| number| 页码。默认值为1。|
|page_size| number| 页面大小。范围为1-50，默认值为10。|
示例
(code curl http)
curl --location --request GET https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/advertiser/list/?bc_id={{bc_id}}&billing_group_id={{billing_group_id}}
--header 'Content-Type: application/json' \
--header 'Access-Token: {{Access-Token}}'
(/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[]|广告账户列表|
##|advertiser_id|string|广告账户|
#|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
{
"code": 40104,
"message": "The access_token is empty.",
"request_id": "{{request_id}}"
}
(/code)