获取互联网服务提供商列表
您可以使用本接口获取定向标签。
仅支持获取一种用于定向受众的定向标签：互联网服务提供商ID。若要将定向标签应用于广告中，需在调用/adgroup/create/，/adgroup/update/，或/ad/audience_size/estimate/时，将本接口返回的互联网服务提供商ID传给isp_ids字段。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tool/targeting/list/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主ID。 |
| location_ids{必填} | string[] | 地域ID列表，用于获取对应支持的互联网服务提供商ID。 <br>最大数量：1000。<br>详细地域ID列表参见[地域ID](https://ads.tiktok.com/marketing_api/docs?id=1739311040498689)。<br><p><span style="color:darkred"><b>注意</b></span>：您需传入国家或地区层级的地域ID。您可以使用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)接口，根据您的版位和推广目标来查询您可以投放的地域以及相应ID，国家或地区层级的地域ID对应的`level`为`COUNTRY`。 |
| scene {必填} | string | 定向标签适用的定向类型。<br>允许的枚举值： `ISP`（互联网服务提供商定向）。 |
示例
(code curl http)
curl --location "https://business-api.tiktok.com/open_api/v1.3/tool/targeting/list/?advertiser_id={{advertiser_id}}&location_ids=["357994"]&scene=ISP" \
--header "Access-Token: {{Access-Token}}" \
--header "Content-Type: application/json" \
(/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| 返回数据。 |
#| targeting_tag_list | object[] | 定向标签相关信息。 |
##| targeting_type | string | 定向标签所适用的定向类型。<br> 枚举值：`ISP` （互联网服务提供商定向）。 |
##| name | string | 定向标签的名称。 |
##| status_info | object | 定向标签的状态信息。 |
###| status | string | 定向标签的状态。<br>枚举值: `ENABLED`（可用于定向）, `DISABLED`（不可用于定向）。 |
###| reason | string | 定向标签不可用于定向的原因。仅当`status`为`DISABLED`时返回。枚举值：<ul><li>`OFFLINE`：该定向标签已下线。 </li><li>`NOT_SUPPORTED`：该定向标签未下线，但在所选的设置下不支持。</li></ul>|
##| isp | object | 用于互联网服务提供商定向的定向标签的信息。 |
###| isp_id | string | 可定向的互联网服务提供商ID。 |
###| location_id | string | 可与该`isp_id`同时使用的地域ID。仅支持国家或地区层级的地域ID。 |
###| region_code | string | `isp_id` 所对应的国家或地区代码。 |
##| geo | object | 用于地域定向的定向标签的信息。 |
#| parent_tags | object[] | 所有父层级定向标签的相关信息。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"parent_tags": [],
"targeting_tag_list": [
{
"name": "Etisalat Misr",
"targeting_type": "ISP",
"geo": null,
"status_info": {
"status": "ENABLED",
"reason": null
},
"isp": {
"isp_id": "EG00045",
"location_id": "357994",
"region_code": "EG"
}
},
{
"name": "Orange Egypt",
"targeting_type": "ISP",
"geo": null,
"status_info": {
"status": "ENABLED",
"reason": null
},
"isp": {
"isp_id": "EG00081",
"location_id": "357994",
"region_code": "EG"
}
},
{
"name": "Telecom Egypt",
"targeting_type": "ISP",
"geo": null,
"status_info": {
"status": "ENABLED",
"reason": null
},
"isp": {
"isp_id": "EG00098",
"location_id": "357994",
"region_code": "EG"
}
},
{
"name": "Vodafone Egypt",
"targeting_type": "ISP",
"geo": null,
"status_info": {
"status": "ENABLED",
"reason": null
},
"isp": {
"isp_id": "EG00105",
"location_id": "357994",
"region_code": "EG"
}
},
{
"name": "other",
"targeting_type": "ISP",
"geo": null,
"status_info": {
"status": "ENABLED",
"reason": null
},
"isp": {
"isp_id": "EG0",
"location_id": "357994",
"region_code": "EG"
}
}
]
}
}
(/code)