获取覆盖和频次广告投放地区的时区信息
您可以使用本接口根据地点(地区代码)获取覆盖和频次广告的投放地区的时区信息(仅适用于覆盖和频次广告)。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/rf/delivery/timezone/|/v1.3/rf/delivery/timezone/|
|请求参数名称|country_codes|region_codes|
|请求参数类型 |advertiser_id: number|advertiser_id: string|
|返回参数名称|country_code|region_code`|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/rf/delivery/timezone/
**方法** GET
**Header**
``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌,可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。 |
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|region_codes {必填}|string[]| 要查询的地区代码。详见 [附录-地区代码](https://ads.tiktok.com/marketing_api/docs?id=1737585867307010) 。|
示例
(code curl http)
curl --location --request GET \
'https://business-api.tiktok.com/open_api/v1.3/rf/delivery/timezone/?advertiser_id={{advertiser_id}}®ion_codes=[%22DE%22%2C%22FR%22%2C%22IT%22%2C%22ES%22]' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段|类型|描述|
|---|---|---|
|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|返回数据。 |
#|timezone_info |object[]| 时区信息。 |
##|region_code |string| 地区代码。|
##|delivery_timezone |string[]| 对应地区的覆盖和频次广告投放时区。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"timezone_info": [
{
"region_code": "GB",
"delivery_timezone": [
"Etc/GMT-0"
]
},
{
"region_code": "US",
"delivery_timezone": [
"Etc/GMT+5"
]
}
]
},
"request_id": "21C36FC53"
}
(/code);