API de plataforma digital: Servicio de categoría

El servicio de categoría de solo lectura le permite ver todas las categorías del lado de la compra que están registradas en nuestro sistema. Las categorías se aplican tanto a las marcas como a los creativos: puede ver qué categorías se asignan a una marca o creatividad mediante el servicio de marca o el servicio creativo. Los vendedores pueden permitir o no permitir estas categorías de marcas y creatividades mediante el servicio de perfiles de anuncios. Al examinar una creatividad en , verá "Categorías confidenciales" y "Categoría de oferta", ambas extraídas del Servicio de categoría. Las categorías confidenciales tendrán el campo is_sensitive establecido en true.

Los vendedores clasificarán los sitios y las ubicaciones utilizando el Servicio de categoría de contenido.

API de REST

Método HTTP	Endpoint	Description
`GET`	https://api.appnexus.com/category	Ver todas las categorías.
`GET`	https://api.appnexus.com/category?id=CATEGORY_ID	Ver una categoría en particular.
`GET`	https://api.appnexus.com/category/meta	Obtenga información sobre los campos por los que puede filtrar y ordenar.

Campos JSON

Nota:

Nuestro sistema usa los campos countries_and_brands y countries_and_regions se definen a continuación para permitir que los creativos relacionados con las apuestas se publiquen en los países y regiones donde están legalmente permitidos, lo que nos pone en conformidad con las leyes aplicables.

Para obtener más información sobre nuestras políticas oficiales relacionadas con el juego, consulte nuestras políticas de juego de políticas de parte del servicio .
Para obtener más información sobre cómo funciona la lista de permitidos por país y región, ponte en contacto con el Portal de soporte técnico de Microsoft Advertising.

Campo	Tipo	Descripción
`id`	Entero	El identificador de la categoría.
`name`	string	Nombre de la categoría.
`is_sensitive`	bool	Si `true`, la categoría aparece como "sensible" y, a menudo, es prohibida por los editores.
`requires_allowlist`	booleano	Si las marcas o los recursos creativos de esta categoría requieren la inclusión en la lista de permitidos para poder publicar.
`requires_allowlist_on_managed`	booleano	Si las marcas o los creativos de esta categoría requieren la inclusión de permitidos para servir en el inventario administrado.
`requires_allowlist_on_external`	booleano	Si las marcas o los recursos creativos de esta categoría requieren la inclusión en la lista de permitidos para servir en el inventario externo (es decir, RTB).
`last_modified`	marca de tiempo	La fecha y hora en que se modificó por última vez la categoría.
`is_brand_eligible`	booleano	Si es cierto, el equipo de auditoría de Xandr puede asociar la categoría con marcas.
countries_and_brands	matriz de objetos	Esta matriz contiene la configuración de la lista de permitidos de marca agrupada por país o región. Para obtener más información, consulta Países y marcas a continuación.

Países y marcas

Campo	Tipo	Descripción
`brand_id`	Entero	El Id. de la marca.
`brand_name`	string	El nombre de la marca.
`brand`	multi_object	Un objeto que contiene información sobre la marca permitida en este país o región. Para obtener más información, consulte Brand a continuación.
`country`	string	Una cadena de 2 caracteres que hace referencia al país o región en el que la marca está en la lista de permitidos.

Marca

Campo	Tipo	Descripción
`id`	Entero	El Id. de la marca.
`name`	string	El nombre de la marca.

Ejemplos

Ver una sola categoría

{code}
$ curl -b cookies "https://api.appnexus.com/category?id=1"
{
  "response": {
    
    "category": {
      "allowlist": {
        "countries_and_brands": [
        ],
        "countries": [
        ]
      },
      "requires_allowlist": false,
      "is_brand_eligible": true,
      "requires_allowlist_on_managed": false,
      "requires_allowlist_on_external": false,
      "last_modified": "2010-03-19 17:48:36",
      "is_sensitive": false,
      "name": "Airlines",
      "id": 1
    },
    "num_elements": null,
    "start_element": null,
    "count": 1,
    "status": "OK"
  }
}
{code}

Ver todas las categorías

{code}
$ curl -b cookies "https://api.appnexus.com/category"
{
  "response": {
    
    "categories": [
      {
        "allowlist": {
          "country or region_and_brands": [
          ],
          "country or region": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Airlines",
        "id": 1
      },
      {
        "allowlist": {
          "country or region_and_brands": [
          ],
          "country or region": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Apparel",
        "id": 2
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Appliances",
        "id": 3
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Automotive and Vehicles",
        "id": 4
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Computers and Electronics",
        "id": 5
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-06-01 20:41:02",
        "is_sensitive": true,
        "name": "Context Link Providers",
        "id": 6
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-07-01 20:23:31",
        "is_sensitive": false,
        "name": "Cosmetics and Hygiene",
        "id": 7
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-06-02 19:23:05",
        "is_sensitive": true,
        "name": "Dating",
        "id": 8
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Education",
        "id": 9
      },
      {
        "allowlist": {
          "countries_and_brands": [
          ],
          "countries": [
          ]
        },
        "requires_allowlist": false,
        "is_brand_eligible": true,
        "requires_allowlist_on_managed": false,
        "requires_allowlist_on_external": false,
        "last_modified": "2010-03-19 17:48:36",
        "is_sensitive": false,
        "name": "Employment",
        "id": 10
      },
      ...
    ],
    "num_elements": null,
    "start_element": null,
    "count": 78,
    "status": "OK"
  }
}
{code}

Last updated on 2026-08-18