获取商务中心的日志
您可以使用本接口获取商务中心的日志。日志中记录了商务中心的操作历史。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/changelog/get/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](1738373164380162.html)接口获取。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| bc_id {必填} | string | 商务中心 ID。<br><br>若想获取您可访问的商务中心列表，可使用[/bc/get/](1737115687501826.html)。|
| filtering | object |筛选条件。|
#| start_date | string | 查询起始时间，格式为`YYYY-MM-DD`（UTC+0）。<br><br><ul><li>您需同时传入`start_date` 和 `end_date` 或两者均不传入。 </li><li>若 `start_date` 和 `end_date` 均不传入，将默认返回过去 7 天的日志。</li></ul><br>推荐查询的时间范围：6 个月。<br><br>示例：`2025-01-01`。 |
#| end_date | string | 查询终止时间，格式为`YYYY-MM-DD`（UTC+0）。<br><br><ul><li>您需同时传入`start_date` 和 `end_date` 或两者均不传入。 </li><li>若 `start_date` 和 `end_date` 均不传入，将默认返回过去 7 天的日志。</li></ul><br>推荐查询的时间范围：6 个月。<br><br>示例：`2025-01-01`。 |
#| activity_type | string | 查询的日志类型。<br><br>枚举值：<ul><li>`ALL`: 所有类型。</li><li>`USER`: 用户。主要与成员和组织相关的改动，包括但不仅限于以下场景：<ul><li>邀请用户成为商务中心的成员</li><li>接受邀请成为商务中心的成员</li><li>将成员从商务中心中移除</li></ul></li><li>`ACCOUNT`：账号。主要与广告账号的创建和权限管理相关的改动，包括但不仅限于以下场景：<ul><li>创建广告账号</li><li>为成员分配广告账号的权限</li><li>取消成员的广告账号权限 </li><li>与合作伙伴分享广告账号的权限</li><li>取消合作伙伴的广告账号权限</li></ul></li><li>`ASSET`：资产。主要与资产相关的改动，包括但不仅限于以下场景：<ul><li>创建或删除商品库</li><li>请求添加 TikTok Shop 或同意添加 TikTok Shop 的请求</li><li>为成员分配资产的权限</li><li>取消成员的资产权限</li></ul></li><li>`BUSINESS`: 商务中心。主要与商务中心相关的改动，包括但不仅限于以下场景：<ul><li> 创建商务中心</li><li>修改商务中心的设置，包括名称和公司名称</li></ul></li></ul>默认值：`ALL`。 |
| lang | string | 日志的语言。<br><br>默认值：`en`。<br><br>若想获取枚举值，可查看<a href="#item-link-lang枚举值">lang枚举值</a>。|
| sort_field | string | 排序字段。<br><br>枚举值： <ul><li>`operation_time`：按改动发生的时间排序，对应返回中对象数组 `changelog_list` 中的 `time` 参数。</li></ul>默认值： `operation_time`。|
| sort_type | string |排序顺序。<br><br>枚举值：<ul><li>`DESC`：降序。<ul><li>`sort_field` 为 `operation_time` 或未传入时，本值代表按改动发生时间从近到远排序。</li></ul></li><li>`ASC`：升序。<ul><li>`sort_field` 为 `operation_time` 或未传入时，本值代表按改动发生时间从远到近排序。 </li></ul></li></ul> 默认值：`DESC`。 |
| page | integer | 当前页数。 <br><br> 取值范围：≥ 1。<br> 默认值：1。|
| page_size | integer | 分页大小。<br><br>取值范围：1-50。<br> 默认值：10。|
lang枚举值
| 值 {30%}| 描述{70%} |
|---|---|
| `ar` | 阿拉伯语 |
| `cs-CZ` | 捷克语 |
| `de` | 德语 |
| `en` | 英语 |
| `es` | 西班牙语 |
| `fil` | 菲律宾语 |
| `fr` | 法语 |
| `id` | 印度尼西亚语 |
| `it` | 意大利语 |
| `ja` | 日语 |
| `ko` | 韩语 |
| `ms` | 马来语 |
| `pl-PL` | 波兰语 |
| `pt` | 葡萄牙语（巴西） |
| `ru` | 俄语 |
| `sv-SE` | 瑞典语 |
| `th` | 泰语 |
| `tr` | 土耳其语 |
| `vi` | 越南语 |
| `zh` | 中文 |
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/changelog/get/?bc_id={{bc_id}}&filtering={"start_date":"{{start_date}}","end_date":"{{end_date}}", "activity_type":"ALL"}&page_size=50' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| changelog_list | object[] | 日志相关信息。 |
##| time | string | 改动发生的时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC+0）。.<br><br>示例： `2025-01-01 00:00:01`。 |
##| activity_type | string | 日志类型。<br><br>枚举值：<ul><li>`USER`: 用户。主要与成员和组织相关的改动，包括但不仅限于以下场景：<ul><li>邀请用户成为商务中心的成员</li><li>接受邀请成为商务中心的成员</li><li>将成员从商务中心中移除</li></ul></li><li>`ACCOUNT`：账号。主要与广告账号的创建和权限管理相关的改动，包括但不仅限于以下场景：<ul><li>创建广告账号</li><li>为成员分配广告账号的权限</li><li>取消成员的广告账号权限 </li><li>与合作伙伴分享广告账号的权限</li><li>取消合作伙伴的广告账号权限</li></ul></li><li>`ASSET`：资产。主要与资产相关的改动，包括但不仅限于以下场景：<ul><li>创建或删除商品库</li><li>请求添加 TikTok Shop 或同意添加 TikTok Shop 的请求</li><li>为成员分配资产的权限</li><li>取消成员的资产权限</li></ul></li><li>`BUSINESS`: 商务中心。主要与商务中心相关的改动，包括但不仅限于以下场景：<ul><li> 创建商务中心</li><li>修改商务中心的设置，包括名称和公司名称</li></ul></li></ul> |
##| operator_id | string | 操作人的用户 ID。 |
##| activity_log | string | 日志详情。 |
#| page_info | object | 分页信息。|
##| page | number | 当前页数。|
##| page_size | number | 分页大小。 |
##| total_number | number | 总结果数。 |
##| total_page | number | 总页数。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"changelog_list": [
{
"activity_type": "USER",
"activity_log": "{{activity_log}}",
"operator_id": "{{operator_id}}",
"time": "{{time}}"
},
{
"activity_type": "ASSET",
"activity_log": "{{activity_log}}",
"operator_id": "{{operator_id}}",
"time": "{{time}}"
}
],
"page_info": {
"total_number": 2,
"page_size": 50,
"total_page": 1,
"page": 1
}
}
}
(/code)