Saltar al contenido principal

​
Cómo obtener acceso a la Ads API

  1. Regístrate para obtener una cuenta de desarrollador.
  2. Crea una App de desarrollador y protege tu token.
  3. Visita ads.x.com/help para enviar una solicitud de acceso a la Ads API para cada una de tus Apps de desarrollador.
Nota: Si ya estás desarrollando en la X Developer Platform y tienes una cuenta de desarrollador, pasa al paso tres.

​
Paso uno: Regístrate para obtener una cuenta de desarrollador

Para realizar solicitudes a cualquiera de los productos de la API de X, primero debes registrarte para obtener una cuenta de desarrollador. En el Portal de desarrolladores, crea un Proyecto y una App de desarrollador. Esto te proporcionará un conjunto de credenciales que usarás para autenticar todas las solicitudes a la API.

​
Paso dos: guarda la clave y los tokens de tu App y mantenlos seguros

En tu App de desarrollador, se te proporcionará un conjunto de API Keys (también conocidas como Consumer Keys). También podrás generar un conjunto de Access Tokens que pueden usarse para realizar solicitudes en nombre de tu cuenta personal de X, y un Bearer Token que puede usarse para autenticar endpoints que requieren un Bearer Token de OAuth 2.0. Como estas claves y tokens no vencen a menos que se regeneren, te recomendamos crear variables de entorno o usar un gestor de contraseñas seguro. Toma nota también de tu App ID, que puedes encontrar en la URL de los detalles de tu App. Esto facilitará solicitar acceso a la Ads API en el siguiente paso.
Nota: Tus claves y tokens solo se mostrarán una vez en el Portal de desarrolladores, por lo que es importante que almacenes estas credenciales en tu gestor de contraseñas en cuanto las generes.Si pierdes u olvidas las claves o los tokens, tendrás que regenerarlos, lo que creará nuevas claves y nuevos tokens, e invalidará los anteriores. Esto significa que tendrás que actualizar cualquier integración que hayas configurado con tus credenciales anteriores.Obtén más información sobre nuestras mejores prácticas de Autenticación.

​
Paso tres: Solicitar acceso a la Ads API

En este punto tendrás acceso Básico a la X API, pero no a la funcionalidad específica de la X Ads API. A continuación, deberás solicitar y obtener aprobación para acceder a la Ads API. Visita ads.x.com/help para enviar una solicitud de acceso a la Ads API para cada una de tus App(s) de desarrollador.

​
Niveles de acceso

Como parte del proceso de solicitud, deberás especificar el nivel de acceso que necesitas. Obtén más información sobre los permisos a nivel de App y a nivel de cuenta de anuncios.

​
Solo conversiones

Acceso a los endpoints de conversiones para dispositivos móviles y web, con permisos de lectura y escritura.

​
Acceso estándar

Acceso a los endpoints de Analytics, Campaign Management, Creatives, Custom Audiences y Conversion con permisos de lectura y escritura.
Nota: Después de que tu App sea aprobada para el acceso a la Ads API, deberás regenerar cualquier token de acceso de usuario para realizar correctamente solicitudes autenticadas a la Ads API.
Nota: Los desarrolladores de la Ads API que solicitaron acceso antes de julio de 2023 pueden tener distintos niveles de acceso y permisos, y pueden estar limitados a cinco tokens de OAuth. Consulta nuestra guía sobre cómo aumentar el acceso para obtener acceso a endpoints adicionales o eliminar los límites de tokens para las aplicaciones existentes.

​
Realiza tu primera solicitud

Para probar tu acceso a la Ads API, realiza una solicitud al endpoint GET accounts. Este endpoint devolverá las cuentas publicitarias a las que tiene acceso el usuario actualmente autorizado. Usa los id de cuentas publicitarias de esta solicitud en solicitudes posteriores de la API para leer y escribir data para una cuenta publicitaria específica. Con Twurl desde la línea de comandos, la solicitud se vería como lo siguiente. Solicitud de ejemplo 
twurl -H ads-api.x.com "/11/accounts"
Ejemplo de respuesta 
{
  "request": {
    "params": {}
  },
  "data": [
   {
    "name": "Furni",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-04-06T07:00:00Z",
    "id": "18ce54ayf0z",
    "created_at": "2016-04-07T14:40:15Z",
    "salt": "b88939e5cabbca720159cb3659d73c06",
    "updated_at": "2017-02-08T08:49:53Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
     }
   ]
}

​
A continuación …