Bidders - リージョン サービス
- [アーティクル]
-
-
読み取り専用リージョン サービスを使用すると、各リージョン/状態が属する国など、Xandr システムに登録されているリージョンと状態に関する情報を表示できます。 このサービスを使用して、 プロファイルでターゲット設定するリージョン ID を取得できます。
HTTP メソッド |
エンドポイント |
説明 |
GET |
https://api.adnxs.com/region |
すべてのリージョンを表示します。 |
取得 |
https://api.adnxs.com/region?id=ID |
特定のリージョンを表示します。 |
取得 |
https://api.adnxs.com/region?name=NAME |
特定のリージョンを表示します。 |
取得 |
https://api.adnxs.com/region?code=CODE |
特定のリージョンを表示します。 |
取得 |
https://api.adnxs.com/region/meta |
フィルター処理および並べ替えの対象となるフィールドを確認します。 |
フィールド |
種類 |
説明 |
code |
列挙 |
リージョンの ISO または FIPS コード。 |
country_code |
列挙 |
リージョンが属する国の ISO コード 。 Country Service を使用して、国コードの完全な一覧を取得できます。 |
country_id |
int |
リージョンが属する国の ID。 |
country_name |
string |
リージョンが属する国の名前。 Country Service を使用して、国名の完全な一覧を取得できます。 |
id |
int |
リージョンの ID。 |
name |
string |
リージョンの名前。 |
$ curl -b cookies -c cookies 'https://api.adnxs.com/region?country_code=DE'
{
"response": {
"status": "OK",
"count": 16,
"start_element": null,
"num_elements": null,
"regions": [
{
"id": 825,
"name": "Baden-Wurttemberg",
"code": "01",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 826,
"name": "Bayern",
"code": "02",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 827,
"name": "Bremen",
"code": "03",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 828,
"name": "Hamburg",
"code": "04",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 829,
"name": "Hessen",
"code": "05",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 830,
"name": "Niedersachsen",
"code": "06",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 831,
"name": "Nordrhein-Westfalen",
"code": "07",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 832,
"name": "Rheinland-Pfalz",
"code": "08",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 833,
"name": "Saarland",
"code": "09",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 834,
"name": "Schleswig-Holstein",
"code": "10",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 835,
"name": "Brandenburg",
"code": "11",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 836,
"name": "Mecklenburg-Vorpommern",
"code": "12",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 837,
"name": "Sachsen",
"code": "13",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 838,
"name": "Sachsen-Anhalt",
"code": "14",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 839,
"name": "Thuringen",
"code": "15",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 840,
"name": "Berlin",
"code": "16",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
}
],
"dbg_info": {
...
}
}
}
$ curl -b cookies -c cookies 'https://api.adnxs.com/region?country_code=DE,FR'
{
"response": {
"status": "OK",
"count": 38,
"start_element": null,
"num_elements": null,
"regions": [
{
"id": 825,
"name": "Baden-Wurttemberg",
"code": "01",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 826,
"name": "Bayern",
"code": "02",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 827,
"name": "Bremen",
"code": "03",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
{
"id": 828,
"name": "Hamburg",
"code": "04",
"country_id": 69,
"country_code": "DE",
"country_name": "Germany"
},
...
{
"id": 1070,
"name": "Aquitaine",
"code": "97",
"country_id": 78,
"country_code": "FR",
"country_name": "France"
},
{
"id": 1071,
"name": "Auvergne",
"code": "97",
"country_id": 78,
"country_code": "FR",
"country_name": "France"
},
{
"id": 1072,
"name": "Basse-Normandie",
"code": "99",
"country_id": 78,
"country_code": "FR",
"country_name": "France"
},
...
],
"dbg_info": {
...
}
}
}
名前に "カリフォルニア" が含まれているすべてのリージョンを表示する
$ curl -b cookies -c cookies 'https://api.adnxs.com/region?like_name=California'
{
"response": {
"status": "OK",
"count": 3,
"start_element": null,
"num_elements": null,
"regions": [
{
"id": 2600,
"name": "Baja California",
"code": "02",
"country_id": 42,
"country_code": "MX",
"country_name": "Mexico"
},
{
"id": 2601,
"name": "Baja California Sur",
"code": "03",
"country_id": 42,
"country_code": "MX",
"country_name": "Mexico"
},
{
"id": 3922,
"name": "California",
"code": "CA",
"country_id": 233,
"country_code": "US",
"country_name": "United States"
}
]
}
}