创建账单组
您可以使用本接口在商务中心下创建一个账单组。
代理商商务中心和直客商务中心都能执行账单组相关操作。
注意
只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用/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/create/| /v1.3/bc/billing_group/create/
|新增请求参数| / |billing_group_type: string|
|请求参数类型|bc_id: number<br>advertiser_ids: number[] |bc_id: string<br>advertiser_ids: string[]|
|返回参数类型|billing_group_id: number|billing_group_id`: string|
## 请求
**地址**
https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/create/
**方法** 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 | 账单组名称。 |
|advertiser_ids{必填}| string[]| 包含在该账单组中的广告账号ID列表。<br><p><span style="color:darkred"><b>注意</b></span>:如果您想为竞价广告账户创建一个账单组,您必须将所有竞价广告账户添加到一个账单组(在法国、巴西或墨西哥注册的广告账户除外)。但如果您想创建一个合约广告账户的账单组,您只能将一个合约广告账户添加到一个账单组。
|billing_group_emails| string[] |账单组邮件列表。|
|is_primary |bool|是否将此账单组作为本商务中心的默认账单组。|
|billing_group_type| string|账单组中所有广告账户的广告类型。该设置无法更改。<br>枚举值:`AUCTION`, `RESERVATION`。|
示例
(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
"bc_id": "BC_ID",
"billing_group_name": "BILLING_GROUP_NAME",
"advertiser_ids": [
"ADVERTISER_IDS"
],
"billing_group_emails": [
"BILLING_GROUP_EMAILS"
],
"is_primary": "IS_PRIMARY"
}' \
https://business-api.tiktok.com/open_api/v1.3/bc/billing_group/create/
(/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)