Servicio de distrito político
El Servicio de Distrito Político permite a los compradores políticos dirigirse a zonas geográficas basadas en los límites del distrito legislativo.
La característica está disponible en el módulo de segmentación geográfica existente en Microsoft Invest y se denomina "Distrito político (solo EE. UU.)". Permite a los compradores políticos dirigirse a los siguientes niveles de geografía política:
- Distrito del Congreso
- Distrito del Senado del Estado
- Distrito de La Casa del Estado
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/political-district?id=DISTRICT_ID | Ver un distrito político existente. |
GET |
https://api.appnexus.com/political-district?search=SEARCH_TERM | Busque un distrito político (solo disponible para district_id, district_name, district_type_id). region_id |
Campos JSON
General
| Campo | Tipo (longitud) | Descripción |
|---|---|---|
id |
Entero | El identificador del distrito político. |
name |
string | El nombre del distrito político. |
description |
string | (Opcional) La descripción detallada de la información del distrito político. |
postal_codes_count |
Entero | Número total de códigos postales que pertenecen a un distrito determinado. |
postal_code_list_id |
Entero | Id. de la lista de códigos postales asociada con el distrito político. |
postal_codes |
matriz de objetos | Códigos postales que se incluirán en la lista de códigos postales. Vea el ejemplo. Obligatorio activado: POST y PUT. |
political_district |
matriz de objetos | En la lista se detalla la información completa del distrito político. |
postal_codes ejemplo
"postal_codes":[
{"id": 1},
{"id": 2},
{"id": 3}
]
Objeto de código postal
El postal_codes objeto contiene los campos siguientes:
| Campo | Tipo (longitud) | Descripción |
|---|---|---|
id |
Entero | Identificador del código postal. |
code |
string | El código postal, que puede ser una cadena alfanumérica que contiene 5 caracteres. |
country_id |
Entero | Identificador asociado al país. |
active |
string | Estado del código postal, que resalta si el código postal es active/inactive. |
country_code |
string | Código ISO Alfa-2 para el país al que pertenece la ciudad. Para recuperar una lista completa de códigos de país, consulte Country Service. |
country_name |
string | Nombre del país al que pertenece la ciudad. Para recuperar una lista completa de nombres de país, consulte Country Service. |
Objeto de distrito político
El political_district objeto contiene los campos siguientes:
| Campo | Tipo (longitud) | Descripción |
|---|---|---|
id |
Entero | El identificador del distrito político. |
district_name |
string | El nombre del distrito político. |
district_type_id |
Entero | Tipo de distrito. Los posibles valores son: - Congress- State House- State Senate |
region_id |
Entero | la region_id obtiene la API, de la region_code que se pasa en el encabezado de solicitud. |
postal_code_list_id |
Entero | Identificador de la lista de códigos postales. |
created_on |
Timestamp |
Solo lectura. El momento de la creación de la lista de distritos políticos. |
last_modified |
Timestamp |
Solo lectura. La hora de la última modificación realizada en la lista de distritos políticos. |
country_id |
Entero | Identificador asociado al país. |
region_code |
string |
region_code está presente en el encabezado de solicitud que usa la API para buscar region_id. |
Ejemplos
Visualización de un distrito político existente por identificador
curl -b cookies -c cookies -s "https://api.appnexus.com/political-district?id=145125" {
"response": {
"status": "OK",
"start_element": 0,
"num_elements": 100,
"political-district": {
"id": 145125,
"name": "AR State House 012",
"description": null,
"postal_codes_count": 7,
"postal_code_list_id": "145125",
"postal_codes": [
{
"id": 53520,
"code": "72714",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 53521,
"code": "72715",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 53527,
"code": "72722",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 53535,
"code": "72736",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 53538,
"code": "72739",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 53544,
"code": "72747",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 53563,
"code": "72768",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
}
],
"political_district": [
{
"id": 5199,
"district_name": "AR State House 012",
"district_type_id": 2,
"region_id": 3921,
"postal_code_list_id": 145125,
"created_on": "2022-04-11 16:10:08",
"last_modified": "2022-04-11 16:10:08",
"country_id": 233
}
]
},
"count": 1,
"dbg_info": {
"warnings": [],
"version": "1.1.61",
"output_term": "political-district"
}
}
}
Visualización de un distrito político existente por nombre de distrito
curl -b cookies -c cookies -s "https://api.appnexus.com/political-district?district_name=NY+State+House+001" {
"response": {
"status": "OK",
"start_element": 0,
"num_elements": 100,
"political-districts": [
{
"id": 144908,
"name": "NY State House 001",
"description": null,
"postal_codes_count": 36,
"postal_code_list_id": "144908",
"postal_codes": [
{
"id": 8190,
"code": "11954",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8191,
"code": "11955",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8192,
"code": "11956",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8193,
"code": "11957",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8194,
"code": "11958",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8195,
"code": "11959",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8197,
"code": "11960",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8199,
"code": "11962",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8200,
"code": "11963",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8201,
"code": "11964",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8202,
"code": "11965",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8204,
"code": "11968",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8205,
"code": "11969",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8207,
"code": "11971",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8208,
"code": "11972",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8212,
"code": "11977",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 8213,
"code": "11978",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
}
],
"political_district": [
{
"id": 4987,
"district_name": "NY State House 001",
"district_type_id": 2,
"region_id": 3950,
"postal_code_list_id": 144908,
"created_on": "2022-04-11 16:09:07",
"last_modified": "2022-04-11 16:09:07",
"country_id": 233
}
]
}
],
"count": 1,
"dbg_info": {
"warnings": [],
"version": "1.1.61",
"output_term": "political-districts"
}
}
}
Ver un distrito político existente postal_code_list_id
$ curl -b cookies -X GET --url 'https://api.appnexus.com/political-district?postal_code_list_id=139897' {
"response": {
"status": "OK",
"start_element": 0,
"num_elements": 100,
"political-districts": [
{
"id": 139897,
"name": "AK Congress 01",
"description": null,
"postal_codes_count": 267,
"postal_code_list_id": "139897",
"postal_codes": [
{
"id": 70153,
"code": "99501",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},
{
"id": 70154,
"code": "99502",
"country_id": 233,
"active": true,
"country_code": "US",
"country_name": "United States"
},