查看协议
您可以使用本接口查看协议内容。您需要使用term_type字段指定希望查看的协议类型,目前仅支持查看线索广告协议。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/term/get/|/v1.3/term/get/|
|请求参数类型 |`advertiser_id`: number|`advertiser_id`: string|
请求
地址 https://business-api.tiktok.com/open_api/v1.3/term/get/
方法 GET
Header
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌,可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告主ID。|
|lang |string|想查看的协议的语言。 <br>枚举值: `EN`,`JA`,`ZH`。<br>默认值: `EN`。|
|term_type {必填}|string|协议的类型。<br>枚举值: `LeadAds`。 |
示例
(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "advertiser_id=< advertiser_id >" \
--data-urlencode "lang=< lang >" \
--data-urlencode "term_type=< term_type >" \
https://business-api.tiktok.com/open_api/v1.3/term/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|返回数据。 |
#|terms |string[]|协议的具体内容。|
|request_id |string|请求的日志ID,唯一标识一个请求。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"terms": [
"Please refer to the following link,",
"https://ads.tiktok.com/i18n/official/policy/lead-gen-terms"
]
},
"request_id": "2021061803333901023604122050CA85D1"
}
(/code);