修改账单组
您可以使用本接口修改账单组的设置。
代理商商务中心和直客商务中心都能执行账单组相关操作。
注意
只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可通过/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/update/|/v1.3/bc/billing_group/update/ |
|请求参数名称|billing_group_name<br>billing_group_emails|new_billing_group_name<br>new_billing_group_emails|
| 请求参数类型 |bc_id: number <br>billing_group_id: number <br>delete_advertiser_ids: number[]<br>add_advertiser_ids: number[] |bc_id: string <br>billing_group_id: string <br>delete_advertiser_ids: string[]<br>add_advertiser_ids`: string[] |
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/update/
**方法** POST
**Header**
``` xtable
|字段{30%}|类型{35%}|描述{35%}|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type{必填}|string|请求消息类型。<br>允许值: `"application/json"`。|
参数
|字段|类型|描述|
|---|---|---|
|bc_id {必填} | string | 商务中心ID |
|billing_group_name {必填} |string | 账单组名称 |
| new_billing_group_name | string | 新的账单组名称 |
| new_billing_group_emails | string[] | 账单组的电子邮件列表。如果您提供了这个字段,那么新的电子邮件列表将覆盖账单组现有的电子邮件。 |
| add_advertiser_ids | string[] |您想要加入到本账单组的广告账号ID |
| delete_advertiser_ids | string[] | 您想要从本账单组移除的广告账号ID |
| is_primary | boolean |是否将本账单组设为当前商务中心的默认账单组|
示例
(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
"bc_id": "BC_ID",
"billing_group_id": "BILLING_GROUP_ID",
"new_billing_group_name": "NEW_BILLING_GROUP_NAME",
"new_billing_group_emails": "NEW_BILLING_GROUP_EMAILS",
"add_advertiser_ids": [
"ADD_ADVERTISER_IDS"
],
"delete_advertiser_ids": [
"DELETE_ADVERTISER_IDS"
],
"is_primary": "IS_PRIMARY"
}' \
https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/update/
(/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| 返回数据。|
#|billing_group_id|string|刚刚创建的账单组的ID。 |
|request_id|string|请求的日志ID,唯一标识一个请求。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {}
}
(/code)