获取广告账户交易记录

您可以使用本接口获取商务中心下的广告账户交易记录。本接口只返回该商务中心对广告账户具有管理员权限的广告账户。

代理商商务中心和直客商务中心都能执行资金管理相关操作。

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

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/advertiser/transaction/get/ | /v1.3/advertiser/transaction/get/| |请求参数名称|trans_type|transfer_type| |请求参数类型 |bc_id: number |bc_id: string| |请求参数名称和类型|is_group: number|summary_by_account: boolean | |请求参数层级|start_date<br>end_date|start_date(infiltering) <br>end_date(infiltering) | |返回参数名称|list<br>trans_type|transaction_list<br>transfer_type| |返回参数类型|advertiser_id: number|advertiser_id`: string |


## 请求

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

**方法** GET

**Header**

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

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心ID。<br><p><span style="color:darkred"><b>注意</b></span>：您仅可获取类型（`type`） 非 `NORMAL`的商务中心下广告账户的交易记录。您可以使用 [/bc/get/](https://ads.tiktok.com/marketing_api/docs?id=1737115687501826) ，并根据返回中的 `type` 字段判断商务中心类型。 |
|filtering |object| 搜索条件 |
#|transfer_type |string| 账单类型。枚举值：`TRANS_TYPE_TRANSFER`(转账), `TRANS_TYPE_TAX`(税), `TRANS_TYPE_COST`(消耗)，`TRANS_TYPE_PAYMENT`(支付)， 见 [附录-枚举值-广告账户账单类型](https://ads.tiktok.com/marketing_api/docs?id=100585)。默认值： `TRANS_TYPE_TRANSFER`。<br><p><span style="color:darkred"><b>注意</b></span>:  当`transfer_type` 设置为 `TRANS_TYPE_TAX`或 `TRANS_TYPE_COST`时, 返回中的`funds_type` 会显示为`null` ，因为这两种账单类型无对应的资金类型设置。|
#|funds_type |string[]| 资金类型，枚举值：`FUNDS_TYPE_CASH`(现金), `FUNDS_TYPE_GRANT`(赠款),默认为全部 。|
#|summary_by_account |boolean| 是否按账户汇总，`false` 表示不汇总，`true` 表示汇总。默认为 `false`。 |
#|keyword |string| 搜索关键词，可以搜索广告账户名或者广告账户id。 |
#|start_date |string|  交易记录搜索开始时间,(UTC+0)格式：`2020-10-12`，默认为90天前。|
#|end_date |string|  交易记录搜索结束时间,(UTC+0)格式：`2020-11-12`，默认为当天。<br><p><span style="color:darkred"><b>注意</b></span>: 最大查询时间间隔为一年，请选择在`start_date`后一年以内的日期作为`end_date`。|
|page |number|当前页数，默认值: `1`，取值范围: ≥ 1。|
|page_size |number|分页大小，默认值: `10`，取值范围: 1-50。|

示例

(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "bc_id=BC_ID" \
--data-urlencode "end_date=END_DATE" \
--data-urlencode "filtering={\"funds_type\": [\"FUNDS_TYPE\"], \"summary_by_account\": \"SUMMARY_BY_ACCOUNT\", \"keyword\": \"KEYWORD\", \"transfer_type\": \"TRANSFER_TYPE\"}" \
--data-urlencode "page=PAGE" \
--data-urlencode "page_size=PAGE_SIZE" \
--data-urlencode "start_date=START_DATE" \
https://business-api.tiktok.com/open_api/v1.3/advertiser/transaction/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|返回数据  |
#|transaction_list|object[]| 广告账户交易记录。 |
##|advertiser_id|string| 广告账户 ID。 |
##|advertiser_name |string| 广告账户名称。 |
##|amount |number| 交易金额，保留两位小数。 |
##|currency |string| 交易币种，取值范围见[附录-币种](1737585839634433.html)。 |
##|date|string| 交易时间，格式：`2020-10-12 00:00:00` (UTC+0)。|
##|funds_type |string| 资金类型，枚举值：`FUNDS_TYPE_CASH`(现金), `FUNDS_TYPE_GRANT`(赠款) 。|
##|transfer_type|string| 账单类型，枚举值：`TRANS_TYPE_TRANSFER`(转账), `TRANS_TYPE_TAX`(消耗), `TRANS_TYPE_COST`(税)。|
##|timezone |string| 交易时区，取值范围见[附录-时区信息](https://ads.tiktok.com/marketing_api/docs?id=1737586324313089) 。|
#|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);