> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Versiones
Para obtener la información más reciente sobre las versiones históricas de la Ads API de X, consulta la información a continuación.
| Versión | Ruta | Fecha de introducción | Fecha de deprecación | Fecha de fin de vida útil |
| :------------------------------------------------------------- | :--- | :---------------------- | :---------------------- | :------------------------ |
| [12.0](#) | /12/ | 27 de octubre de 2022 | Por determinar | Por determinar |
| [11.0](https://devcommunity.x.com/t/ads-api-version-11/168814) | /11/ | 31 de marzo de 2022 | Por determinar | Por determinar |
| [10.0](#v9) | /10/ | 31 de agosto de 2021 | 31 de marzo de 2022 | 27 de octubre de 2022 |
| [9.0](#v9) | /9/ | 2 de marzo de 2021 | 31 de agosto de 2021 | 31 de marzo de 2022 |
| [8.0](#v8) | /8/ | 8 de septiembre de 2020 | 2 de marzo de 2021 | 31 de agosto de 2021 |
| [7.0](#v7) | /7/ | 3 de marzo de 2020 | 1 de septiembre de 2020 | 2 de marzo de 2021 |
| [6.0](#v6) | /6/ | 28 de agosto de 2019 | 3 de marzo de 2020 | 1 de septiembre de 2020 |
| [5.0](#v5) | /5/ | 28 de febrero de 2019 | 28 de agosto de 2019 | 3 de marzo de 2020 |
| [4.0](#v4) | /4/ | 28 de agosto de 2018 | 28 de febrero de 2019 | 28 de agosto de 2019 |
| [3.0](#v3) | /3/ | 1 de febrero de 2018 | 28 de agosto de 2018 | 28 de febrero de 2019 |
| [2.0](#v2) | /2/ | 10 de julio de 2017 | 1 de febrero de 2018 | 1 de agosto de 2018 |
| [1.0](#v1) | /1/ | 31 de marzo de 2016 | 7 de julio de 2017 | 10 de enero de 2018 |
| [0.0](#v0) | /0/ | 21 de febrero de 2013 | N/D | 31 de octubre de 2016 |
## Descripción general
Cada mes realizamos cambios y lanzamos varias funciones nuevas en la X Ads API. Estos cambios casi siempre son compatibles con versiones anteriores; sin embargo, solemos tener un puñado de cambios incompatibles cada año. Hemos recibido comentarios de desarrolladores sobre los desafíos que nuestro rápido ritmo de cambios en la Ads API supone para sus ciclos de desarrollo a la hora de implementar nuevas funciones, gestionar deprecaciones y probar cambios. Queremos mejorar la experiencia de los desarrolladores al usar nuestra plataforma de Ads, y por eso introdujimos el concepto de versionar nuestros endpoints.
Algunas definiciones de los conceptos de los que hablamos:
**Versión**: Se refiere al número de versión que se encuentra en la ruta de la URL de cualquier solicitud a la Ads API, por ejemplo: GET /{version_number}/accounts. Este estilo de versionado se conoce como versionado por URI.
**Cambios incompatibles**: Los cambios incompatibles son cualquier cambio que requiera recursos de desarrollo para mantener la funcionalidad existente. Esto incluye recursos utilizados para investigar los cambios que deben realizarse, determinar las funciones/endpoints que se están deprecando y la implementación final de todos estos cambios. Una lista de cambios incompatibles incluye cosas como:
* Eliminar un parámetro de la solicitud/respuesta de la API
* Modificar el nombre de cualquier parámetro o endpoint
* Cambio en la representación de valores (preview\_url → card\_uri)
* Cambio en el comportamiento de los endpoints (por ejemplo, estadísticas async vs sync)
* Agregar/cambiar parámetros opcionales u obligatorios (por ejemplo, hacer que name sea un campo obligatorio en la solicitud)
**Deprecación**: Las versiones o productos en desuso dejarán de estar admitidos y se recomienda que los desarrolladores dejen de usar estas APIs.
**Retirada (sunset)**: Una vez que un producto o una API se retira (sunset), el conjunto correspondiente de endpoints dejará de ser accesible a través de la API.
## Estrategia de versionado
Los principios principales de la estrategia son:
1. Todos los cambios incompatibles se agruparán en una nueva versión
2. El periodo de deprecación de las versiones existentes cuando se anuncie una nueva versión será de 6 meses
3. En cualquier momento, la API permitirá solicitudes desde dos versiones simultáneamente; sin embargo, la más antigua de las dos no tendrá soporte
4. Para facilitar una adopción más rápida de nuevos productos, estos se lanzarán de forma continua (fuera de la cadencia de versionado)
5. Todas las respuestas de la API contendrán un `x-current-api-version`, que se establecerá en la versión actual de la API, además de un encabezado `x-api-warn` cuando se llamen endpoints de API en deprecación.
Si hubiera cambios fundamentales en los requisitos del producto que requirieran un cambio incompatible en la API (por ejemplo, deprecar la segmentación por varios grupos de edad), enviaremos un aviso con 90 días de antelación para anunciar este cambio incompatible y, después de al menos 90 días desde que se emita el aviso, se implementará el cambio incompatible.
### v9
Hoy, 3 de marzo de 2021, la versión 9 (v9) de la X Ads API ya está disponible. Esta versión está diseñada para aumentar la paridad de funciones, simplificar la creación de campañas e introducir actualizaciones clave en nuestros endpoints de Cards y Mobile App Promotion.
Al igual que con nuestras versiones anteriores, habrá un periodo de transición de 6 meses para migrar a v9. El 31 de agosto de 2021, la versión 8 (v8) actual de la Ads API dejará de estar disponible. Recomendamos a todos los desarrolladores que migren a la versión más reciente de la Ads API lo antes posible para evitar interrupciones del servicio.
**Nota:** A partir de esta versión, la versión 7 (v7) de la Ads API ha llegado al final de su vida útil y ya no está disponible.
Para obtener todos los detalles, consulta el [anuncio en el foro para desarrolladores](https://devcommunity.x.com/t/ads-api-version-9/150316).
### v8
Hoy, 20 de septiembre de 2020, presentamos la versión 8 de la X Ads API, diseñada para introducir nueva funcionalidad de Tailored Audiences, aumentar la paridad de funcionalidades con ads.x.com y mejorar tu experiencia como desarrollador.
Al igual que con versiones anteriores, habrá un período de transición de 6 meses para migrar a v8. A partir del 2021-03-02, la versión 7 de la Ads API ya no estará disponible. Recomendamos a todos los desarrolladores que migren a la versión más reciente de la API lo antes posible para evitar cualquier interrupción del servicio.
Para más detalles, consulta el [anuncio en el foro para desarrolladores](https://devcommunity.x.com/t/ads-api-version-8/141914).
### v7
Hoy, 20 de marzo de 2020, presentamos la Versión 7 de la X Ads API, diseñada para aumentar la paridad de funciones con [ads.x.com](http://ads.x.com/).
Como en las [versiones](https://developer.x.com/en/docs/ads/general/overview/versions) anteriores, habrá un período de transición de 6 meses para migrar a v7. El 1 de septiembre de 2020, la versión 6 de la Ads API dejará de estar disponible. Recomendamos a todos los desarrolladores que migren a la versión más reciente de la API lo antes posible para evitar cualquier interrupción del servicio. La versión 5 de la Ads API ha llegado al final de su vida útil y ya no está disponible.
Para obtener todos los detalles, consulta el [anuncio en el foro de desarrolladores](https://devcommunity.x.com/t/ads-api-version-7/135093).
### v6
Hoy, 28 de agosto de 2019, X presenta Ads API v6, con actualizaciones centradas en la coherencia y en mejorar la experiencia de desarrollador.
Esta versión incluye un nuevo endpoint para obtener Tweets, estadísticas para Promoted Accounts, la capacidad de buscar entidades por nombre e información sobre el número actual de trabajos asíncronos de analítica que se están procesando. Además, hemos realizado actualizaciones centradas en la coherencia en los endpoints que utilizan contenido multimedia y en nuestros endpoints de criterios de segmentación. Por último, hemos realizado pequeñas actualizaciones en algunos de nuestros nombres de parámetros y atributos de respuesta y estamos marcando como obsoleto el endpoint Scoped Timeline.
Para obtener todos los detalles, consulta el [anuncio en el foro para desarrolladores](https://devcommunity.x.com/t/ads-api-version-6/129060).
### v5
Hoy, 28 de febrero de 2019, X presenta Ads API v5, con actualizaciones centradas en mejorar la escalabilidad y la eficiencia.
Esta versión incluye un nuevo endpoint para determinar qué entidades estuvieron activas en un período de tiempo determinado, estadísticas para Media Creatives (es decir, videos in-stream e imágenes en la X Audience Platform), la capacidad de obtener *múltiples* cards por URI de la card y más flexibilidad para recuperar criterios de segmentación y otras entidades. Además, hemos corregido algunos bugs y realizado actualizaciones en los nombres de parámetros y atributos de respuesta. Por último, las app cards sin contenido multimedia y el endpoint POST `accounts/:account_id/account_media` se han declarado obsoletos.
Como en versiones anteriores, habrá un período de transición de 6 meses para migrar a v5. El **2019-08-28**, la versión 4 de la Ads API dejará de estar disponible. Recomendamos a todos los socios que migren a la versión más reciente de la API tan pronto como sea posible para evitar cualquier interrupción del servicio. *La versión 3 de la Ads API ha llegado al final de su vida útil y ya no está disponible.*
#### Nuevo
**Determinación de qué entidades estuvieron activas**
El endpoint [Active Entities](/es/x-ads-api/analytics#active-entities-2) indica si las métricas de analítica para entidades de anuncios han cambiado. Diseñado para utilizarse junto con los endpoints de analítica, Active Entities funciona especificando un tipo de entidad y un intervalo de fechas —un máximo de 90 días— y devuelve un array de IDs de entidad para los que tu plataforma debe solicitar analíticas. No se deben consultar IDs distintos de los que se devuelven en solicitudes de analíticas posteriores.
Este endpoint admite los siguientes tipos de entidad: `CAMPAIGN`, `FUNDING_INSTRUMENT`, `LINE_ITEM`, `MEDIA_CREATIVE` y `PROMOTED_TWEET`.
**Estadísticas de `MEDIA_CREATIVE`**
Los endpoints de analítica del Ads API ahora proporcionan métricas para entidades Media Creative. Los Media Creatives son la forma en que se promocionan los anuncios in-stream o las imágenes en la X Audience Platform. La interfaz de X Ads muestra las métricas de Media Creative en las pestañas “In-stream videos” y “Display creatives”. Tanto los endpoints de analítica [sincrónicos](/es/x-ads-api/analytics#get-stats-accounts-account-id) como [asincrónicos](/es/x-ads-api/analytics#asynchronous-analytics) ahora admiten el enum de entidad `MEDIA_CREATIVE`.
**Obtener varias cards**
Mejorando la [versión v3](https://devcommunity.x.com/t/ads-api-version-3/100732) del endpoint diseñado para recuperar una sola card por su valor de URI de card, ahora es posible obtener *varias* cards utilizando el endpoint [GET accounts/:account\_id/cards/all](/es/x-ads-api/creatives#cards-fetch). Ahora, en lugar de hacer una solicitud por cada card, puedes recuperar hasta 200 cards en una sola solicitud.
Dos cosas a tener en cuenta:
1. La ruta de URL ahora es `accounts/:account_id/cards/all`. (La ruta anterior ya no está disponible.) Esto es para mantener la coherencia con [el endpoint](/es/x-ads-api/creatives#cards-fetch) diseñado para recuperar una card por ID.
2. El parámetro de solicitud obligatorio ahora se llama card\_uris (plural).
**Flexibilidad en la recuperación**
El endpoint [GET accounts/:account\_id/targeting\_criteria](/es/x-ads-api/campaign-management#get-accounts-account-id-targeting-criteria) ahora admite múltiples IDs de line item. El parámetro line\_item\_ids, que acepta hasta 200 IDs, es obligatorio. Anteriormente, solo se aceptaba un único line item, lo que dificultaba la sincronización. Con este cambio, ahora es posible recuperar más segmentación en menos tiempo.
Los siguientes endpoints ahora también admiten múltiples IDs de line item, aunque el parámetro line\_item\_ids es opcional para estos.
* [GET accounts/:account\_id/line\_item\_apps](https://developer.x.com/en/docs/x-ads-api/campaign-management/api-reference/line-item-apps#get-accounts-account-id-line-item-apps)
* [GET accounts/:account\_id/media\_creatives](/es/x-ads-api/campaign-management#get-accounts-account-id-media-creatives)
* [GET accounts/:account\_id/promoted\_accounts](/es/x-ads-api/campaign-management#get-accounts-account-id-promoted-accounts)
* [GET accounts/:account\_id/preroll\_call\_to\_actions](/es/x-ads-api/creatives#preroll-call-to-actions)
#### Changed
**Recuperación de campañas y elementos de línea en borrador**
Se ha actualizado la forma en que se recuperan las campañas y los elementos de línea en borrador. Ahora, el parámetro `with_draft(boolean)`, cuando se establece en `true`, devuelve *tanto* entidades en borrador como entidades que no están en borrador. Esto es coherente con la forma en que se recuperan las entidades eliminadas (es decir, usando `with_deleted`). Anteriormente, obtener tanto entidades en borrador como no en borrador requería al menos dos solicitudes. Ahora, esto se puede hacer en una sola llamada a la API.
\| **v4** | **v5** |
\| :--- | :--- | :--- |
\| `draft_only` | `with_draft` | |
**Segmentación por duración de activación de red**
La Ads API ha corregido un problema de visualización en el que, después de agregar la segmentación de Network Activation Duration, el tipo de segmentación en la respuesta incluía el sufijo `_IN_SEC`. Hacer referencia a segundos resultaba confuso, ya que Network Activation Duration siempre se representa en meses. Esta corrección hace que la representación sea coherente y reduce la confusión.
\| **v4** | **v5** |
\| :--- | :--- | :--- |
\| `NETWORK_ACTIVATION_DURATION_IN_SEC` | `NETWORK_ACTIVATION_DURATION` | |
**Recuentos totales y cursores**
En v5, `with_total_count` y `cursor` son exclusivos. Especificar ambos en una solicitud devolverá el código de error `EXCLUSIVE_PARAMETERS`. Antes de v5, `with_total_count` se ignoraba cuando se especificaba `cursor`. Este cambio hace que la relación sea explícita.
#### Eliminados
Se están eliminando tres campos de las respuestas de Ads API: preview\_url, account\_id y parent\_ids. El esfuerzo de ingeniería necesario para estos tres es mínimo.
* En v4, se anunció que el parámetro de respuesta preview\_url para las cards siempre era null. El paso final en esta migración es eliminar preview\_url de todas las respuestas de cards.
* El atributo de respuesta account\_id se está eliminando para los siguientes recursos, dado que el id de la cuenta de anuncios ya está presente en la URL, así como en request.params. (Es intencional excluir los instrumentos de financiación de esta lista, ya que los id padre deberían estar presentes en los objetos de respuesta, cuando sea posible, y los id de cuenta son entidades padre de los instrumentos de financiación).
* Medios de cuenta
* Proveedores de eventos de App
* Etiquetas de eventos de App
* Campañas
* Cards
* Line items
* Usuarios promocionables
* Criterios de segmentación
* Para las solicitudes [GET accounts/:account\_id/targeting\_criteria](/es/x-ads-api/campaign-management#get-accounts-account-id-targeting-criteria), ya no devolvemos el campo parent\_ids, ya que siempre era un array vacío.
**Cards de App sin contenido multimedia**
En v5, las cards de App sin contenido multimedia ya no son compatibles. [Anteriormente](https://devcommunity.x.com/t/deprecation-announcement-app-download-cards/87807), se eliminó la capacidad de crear o editar cards de App sin contenido multimedia. Ahora, los endpoints restantes para este recurso se están descontinuando.
* Nota: Esto **no** afecta a las cards de descarga de App de imagen y video.
**Creación de medios de cuenta**
El endpoint POST accounts/:account\_id/account\_media ya no está disponible en v5. Otros endpoints para este recurso *no* se ven afectados. La razón de este cambio es que, al agregar contenido multimedia a la [Media Library](/es/x-ads-api/creatives#media-library), hay casos en los que esos recursos se agregan *automáticamente* como entidades de Account Media y, al intentar agregar un recurso ya existente al recurso Account Media, se produce un error. Esto ocurre en los siguientes casos:
* Los recursos `AMPLIFY_VIDEO` agregados a la Media Library se agregan automáticamente como recursos de Account Media con el tipo creativo `PREROLL`.
* Las imágenes con dimensiones específicas agregadas a la Media Library se agregan automáticamente como recursos de Account Media. El tipo creativo (por ejemplo, `INTERSTITIAL`) depende de las dimensiones de la imagen. (Para las dimensiones, consulta nuestra página de [Enumerations](/es/x-ads-api/introduction).)
### v4
La versión 4 de la Ads API se publica hoy, 28 de agosto de 2018.
Esta versión incluye mejoras en nuestro producto de [Audiences](/es/x-ads-api/audiences), incluida una nueva interfaz de API basada en un backend de procesamiento de audiencias más sólido. La versión 4 también incluye un conjunto de endpoints para administrar la configuración de usuario, cuenta e impuestos. Además, los endpoints accounts/:account\_id/videos quedan obsoletos. Esta versión también incluye algunos cambios menores en nombres de parámetros y de respuestas.
Al igual que con la versión 3, proporcionamos un período de transición de 6 meses. A partir del **2019-02-28**, la versión 3 de la Ads API ya no estará disponible. Recomendamos a todos los socios que migren a la versión más reciente de la API tan pronto como sea posible para evitar cualquier interrupción del servicio. Consulta nuestra página de [Versions](/es/x-ads-api/introduction) para obtener detalles sobre nuestra estrategia de control de versiones.
#### Nuevo
***Audience API***
La nueva Audiences API está basada en nuestro nuevo backend de procesamiento de audiencias, que ofrece mayor solidez y confiabilidad. Este nuevo endpoint permitirá a los socios proporcionar varios tipos de identificadores de usuario para un solo usuario, lo que significa que podremos usar señales adicionales para la asociación. La documentación de referencia para el nuevo endpoint de Audience se puede encontrar [aquí](/es/x-ads-api/audiences). Planeamos seguir lanzando actualizaciones y mejoras de este producto durante el resto del año.
Los siguientes endpoints dejarán de estar disponibles en v4 debido a funcionalidad redundante (seguirán funcionando en v3 y se retirarán por completo (**sunset**) cuando v3 ya no esté disponible):
* TON Upload:
* GET accounts/:account\_id/tailored\_audience\_changes
* GET accounts/:account\_id/tailored\_audience\_changes/:tailored\_audience\_change\_id
* POST accounts/:account\_id/tailored\_audience\_changes
* PUT accounts/:accounti\_d/tailored\_audiences/global\_opt\_out
* Real Time Audiences:
* POST tailored\_audience\_memberships
Por último, el parámetro `list_type` se eliminará de la solicitud y la respuesta en *todos* los [endpoints de Tailored Audiences](/es/x-ads-api/audiences) en la versión 4.
***Settings Endpoints***
Ahora permitimos que los administradores de cuentas establezcan y actualicen la configuración de usuario, cuenta e impuestos. La [configuración de usuario](/es/x-ads-api/campaign-management#get-accounts-account-id-user-settings-user-id) corresponde a las preferencias de contacto específicas del usuario para una cuenta de anuncios determinada. Mediante el endpoint [PUT accounts/:account\_id](/es/x-ads-api/campaign-management#put-accounts-account-id), los anunciantes ahora pueden actualizar el nombre de su cuenta y el tipo de industria. Por último, los endpoints de [configuración de impuestos](/es/x-ads-api/campaign-management#get-accounts-account-id-tax-settings) permiten a los anunciantes en países donde se cobra un impuesto al valor agregado (IVA) actualizar información como el nombre de la empresa, la dirección, el ID de IVA y si la cuenta es propiedad del anunciante o de una agencia que anuncia en nombre de un anunciante.
#### Cambiado
***Cambios de nombre universales de Lookalike***
Estamos actualizando los valores del enum para el parámetro `lookalike_expansion` en los endpoints [POST accounts/:account\_id/line\_items](/es/x-ads-api/campaign-management#post-accounts-account-id-line-items) y [PUT accounts/:accountit/line\_items/:line\_item\_id](/es/x-ads-api/campaign-management#put-accounts-account-id-line-items-line-item-id).
| **v3** | **v4** |
| :--------- | :--------- |
| `NARROW` | `DEFINED` |
| `BALANCED` | `EXPANDED` |
**Uso de `country_code` en todas partes**
Como parte de un esfuerzo más amplio relacionado con la [consistencia](https://devcommunity.x.com/t/feedback-ads-api-consistency/109145) en la Ads API, estamos cambiando el nombre de los parámetros en los siguientes endpoints de `app_country_code` a `country_code`.
* [POST accounts/:account\_id/cards/image\_app\_download](https://devcommunity.x.com/t/ads-api-version-11/168814)
* [PUT accounts/:account\_id/cards/image\_app\_download/:card\_id](https://developer.x.com/content/developer-twitterhttps://developer.x.com/en/docs/ads/creatives/api-reference/image-app-download#put-accounts-account-id-cards-image-app-download-card-id)
* [POST accounts/:account\_id/cards/video\_app\_download](https://developer.x.com/content/developer-twitter/en/docs/ads/creatives/api-reference/video-app-download#post-accounts-account-id-cards-video-app-download)
* [PUT accounts/:account\_id/cards/video\_app\_download/:card\_id](https://developer.x.com/content/developer-twitter/en/docs/ads/creatives/api-reference/video-app-download#put-accounts-account-id-cards-video-app-download-card-id)
Esto no afecta el comportamiento ni los valores aceptados para estos parámetros y es únicamente un cambio de nombre.
**`preview_url` siempre null**
Tal como se prometió en el anuncio de v3, todas las tarjetas existentes ahora tienen un `card_uri`. Como resultado, el valor de `preview_url` siempre será `null`.
Como recordatorio, asocia una tarjeta con un Tweet usando su valor `card_uri`. Consulta el siguiente ejemplo de solicitud.
\$ twurl -X POST -H ads-api.x.com "/4/accounts/18ce54d4x5t/tweet?text=Version 4\&card\_uri=card://958225772740714496"
#### Eliminado
**Endpoints de video**
Los endpoints accounts/:account\_id/videos ya no estarán disponibles en v4. Este endpoint ha quedado obsoleto debido a la introducción de los endpoints de [Media Library](/es/x-ads-api/creatives#get-accounts-account-id-media-library). Consulta la siguiente comparación de uso.
* endpoint de videos v3: `twurl -H ads-api.x.com "/3/accounts/18ce54d4x5t/videos"`
* endpoint v4 de Media Library para videos: `twurl -H ads-api.x.com "/4/accounts/18ce54d4x5t/media_library?media_type=VIDEO"`
Los endpoints de Media Library tienen plena paridad con los endpoints de videos y también admiten funcionalidad adicional, como la posibilidad de gestionar imágenes y GIF. Se solicita a los socios que utilicen exclusivamente Media Library para cualquier gestión de medios.
**`as_user_id` en la vista de Tweet**
El parámetro `as_user_id` disponible en el endpoint [GET accounts/:account\_id/tweet/preview/:tweet\_id](/es/x-ads-api/creatives#get-accounts-account-id-tweets) ya no será aceptado. La vista previa siempre se mostrará como si fuera del autor del Tweet.
### v3
La versión 3 de Ads API [se lanzó](https://devcommunity.x.com/t/ads-api-version-3/100732) el 1 de febrero de 2018. La versión 2 de Ads API llegará al final de su vida útil el 1 de agosto de 2018.
Esta versión incluye nuestro nuevo producto Audience Intelligence, acceso a Media Library y flujos de trabajo de cards mejorados. También anunciamos la obsolescencia del endpoint [PUT accounts/:account\_id/targeting\_criteria](/es/x-ads-api/campaign-management#get-accounts-account-id-targeting-criteria). Por último, la versión 3 incluye algunos cambios menores en parámetros y respuestas y un límite inferior en el tamaño de los lotes.
Al igual que con [la versión 2](https://devcommunity.x.com/t/ads-api-version-2/90360), damos a los partners **6 meses** para la transición. El **2018-08-01**, la v2 de Ads API se desactivará. Recomendamos a todos los partners y desarrolladores que migren a v3 lo antes posible.
**Audience Intelligence**
Audience Intelligence ofrece información en tiempo real sobre los hashtags principales, @handles y eventos más relevantes para una audiencia determinada en X. Por ejemplo, introduce "Hombre 18-34" en EE. UU. y verás #nintendoswitch, #cardinal y @ricegum como tendencias entre esta audiencia.
Los [endpoints](/es/x-ads-api/audiences) de Audience Intelligence proporcionarán la siguiente funcionalidad:
* Dada una audiencia de entrada, recuperar los hashtags principales, @handles y eventos más relevantes.
* Dada una audiencia de entrada, recuperar información demográfica clave (como edad, género e ingresos del hogar).
* Dada una palabra clave, recuperar la serie temporal del volumen de Tweets.
**Media Library**
La [Media Library](/es/x-ads-api/creatives#get-accounts-account-id-media-library) permite gestionar imágenes, GIFs y vídeos para cuentas de anuncios. Estos objetos multimedia se pueden usar en Tweets y para crear cards. También se pueden reutilizar en múltiples creatividades, eliminando la necesidad de subir el mismo recurso varias veces.
Los objetos de la biblioteca se identifican mediante un media\_key. Las media keys son valores de tipo string con el siguiente formato: 13\_875943225764098048, por ejemplo. En Ads API, avanzamos hacia el uso de media keys para todos los medios.
**Flujo de trabajo de cards mejorado**
Todos nuestros endpoints de cards ahora admiten media keys. Esto permite usar objetos de Media Library para crear o actualizar cards.
Además, estamos introduciendo dos nuevos endpoints para [obtener detalles de cards](/es/x-ads-api/creatives#fetching-cards). Estos endpoints se pueden usar para buscar cards utilizadas en Tweets o Tweets programados, por ejemplo, especificando ya sea el card\_uri o el id. Anteriormente, esto no era posible.
#### Otros cambios
Además de estas nuevas funciones, incluimos los siguientes cambios en la versión 3.
**Nuevo**
* La respuesta del endpoint [GET insights/keywords/search](/es/x-ads-api/audiences) ahora incluye un atributo related\_keywords con 30 términos relacionados con las palabras clave de entrada.
**Modificado**
* El tamaño máximo del lote de criterios de segmentación ahora es 500.
* Los atributos de respuesta card\_uri y preview\_url ahora son mutuamente excluyentes. Cuando una card tiene un card\_uri, preview\_url será null. Cuando una card no tiene un card\_uri, solo se devolverá preview\_url.
* Todas las cards creadas a partir de 2018-01-29 tendrán un card\_uri.
* Para la versión 4, todas las cards existentes tendrán un card\_uri.
* Ya no es posible *crear* cards con imágenes 5:2. Aunque las cards existentes basadas en imágenes 5:2 seguirán funcionando, recomendamos a los socios cambiar a las relaciones de aspecto con mejor rendimiento 1.91:1 o 1:1 (cuando se admitan).
**Eliminado**
* El endpoint [PUT accounts/:account\_id/targeting\_criteria](/es/x-ads-api/campaign-management#get-accounts-account-id-targeting-criteria) ya no está disponible. Hemos decidido realizar este cambio porque el comportamiento de reemplazo de este endpoint generaba confusión entre los anunciantes y no era coherente con nuestros otros endpoints PUT, que actualizan un único recurso a la vez. En su lugar, los socios deben usar el endpoint [POST batch/accounts/:account\_id/targeting\_criteria](/es/x-ads-api/campaign-management#post-batch-accounts-account-id-targeting-criteria), que proporciona una mayor flexibilidad, incluida la capacidad de agregar y eliminar segmentación en una sola solicitud.
* El atributo de respuesta paused ya no se devuelve para los instrumentos de financiación. En su lugar, consulte el atributo de respuesta entity\_status para determinar si un instrumento de financiación está en pausa o no. Además, dado que paused y cancelled corresponden al mismo valor, cancelled tampoco se devuelve ya en la respuesta.
* Hemos eliminado el parámetro card\_id del endpoint [GET accounts/:account\_id/tweet/preview](/es/x-ads-api/creatives#get-accounts-account-id-tweets).
* Dado que no es posible recuperar Tweets programados eliminados, el parámetro with\_deleted ya no se admite.
* El parámetro draft\_only se ha eliminado de los siguientes endpoints, ya que estas entidades nunca pueden estar en estado de borrador:
* [GET accounts/:account\_id/targeting\_criteria](/es/x-ads-api/campaign-management#get-accounts-account-id-targeting-criteria)
* [GET accounts/:account\_id/promoted\_tweets](/es/x-ads-api/campaign-management#get-accounts-account-id-promoted-tweets)
* [GET accounts/:account\_id/promoted\_accounts](/es/x-ads-api/campaign-management#get-accounts-account-id-promoted-accounts)
* [GET accounts/:account\_id/media\_creatives](/es/x-ads-api/campaign-management#get-accounts-account-id-media-creatives)
* [GET accounts/:account\_id/preroll\_call\_to\_actions](/es/x-ads-api/creatives#get-accounts-account-id-preroll-call-to-actions)
**Nota**
Tanto las Video Website Cards como los Tweets programados han salido ahora de la versión beta. Consulte [este hilo](https://devcommunity.x.com/t/announcement-update-to-scheduled-tweets/94869) para ver los cambios que hemos realizado en los Tweets programados desde su lanzamiento. Esto incluye la capacidad de generar vistas previas HTML para Tweets programados ([previews](https://devcommunity.x.com/t/announcement-tweet-preview-improvements/96577)).
### v2
La versión 2 de la Ads API [se lanzó](https://devcommunity.x.com/t/ads-api-version-2/90360) el 10 de julio de 2017. La versión 1 de la Ads API llegará al fin de su vida útil el 10 de enero de 2018.
**Cambios importantes/funciones obsoletas[¶](#breaking-changes-deprecations "Enlace permanente a este encabezado")**
* `total_count` ahora es un atributo de respuesta opcional. Solo estará disponible si `with_total_count` se establece en `true`
* Los campos `paused` y `draft_only` en los objetos de solicitud y respuesta `line_items` y `campaigns` se sustituyen por un único parámetro `entity_status`
* El parámetro `status` ha pasado a llamarse `text` en los endpoints [POST accounts/:account\_id/tweet](/es/x-ads-api/creatives) y [GET accounts/:account\_id/tweet/preview](/es/x-ads-api/creatives#get-accounts-account-id-tweets)
* Los valores enumerados `location_type` del endpoint [GET targeting\_criteria/locations](/es/x-ads-api/campaign-management#get-targeting-criteria-locations) ahora son plurales. `COUNTRY` ahora es `COUNTRIES`, `REGION` ahora es `REGIONS`, y así sucesivamente. La única excepción es que, en v2, `CITY` ahora es `METROS`, para reflejar correctamente el hecho de que el tipo de ubicación se refiere a Designated Marker Areas (DMA) o “metros”.
* `display_properties` en los endpoints PUT accounts/:account\_id/promoted\_tweets. Este valor tampoco se devolverá ya como parte de la respuesta
* Como resultado del punto anterior, ya no es posible actualizar (PUT) entidades promoted\_tweets
* Se ha eliminado el parámetro `line_item_id` en el endpoint [GET accounts/:account\_id/promoted\_tweets](/es/x-ads-api/campaign-management#get-accounts-account-id-promoted-tweets)
* Ya no será posible crear Website Cards 5:2 en los endpoints v2
* El atributo de respuesta `data_type` ya no se devuelve
**Nuevas funciones[¶](#new-features "Enlace permanente a este encabezado")**
1. Cards v2
2. Creación y activación de campañas/line items en borrador
3. Tweets programados
4. Resúmenes de trabajos asíncronos
**Cards v2[¶](#cards-v2 "Enlace permanente a este encabezado")**
* Se debe usar el parámetro de solicitud `card_uri` en lugar de añadir `preview_url` al texto del Tweet cuando se asocia una tarjeta con un Tweet
* Si el parámetro `card_uri` no se devuelve en la respuesta (durante el paso de creación de la tarjeta), utilice entonces `preview_url`
* Todos los nuevos formatos de tarjeta estarán disponibles de forma nativa en la API, aprovechando el parámetro `card_uri`.
**Nuevos formatos de Card:[¶](#new-card-formats "Enlace permanente a este encabezado")**
* Video Website Cards:
* [GET accounts/:account\_id/cards/video\_website](https://developer.x.com/en/docs/ads/creatives/api-reference/video-website.html#get-accounts-account-id-cards-video-website)
* [GET accounts/:account\_id/cards/video\_website/:card\_id](https://developer.x.comhttps://developer.x.com/en/docs/ads/creatives/api-reference/video-website.html#get-accounts-account-id-cards-video-website-card-id)
* [POST accounts/:account\_id/cards/video\_website](https://developer.x.com/en/docs/ads/creatives/api-reference/video-website.html#post-accounts-account-id-cards-video-website)
* [PUT accounts/:account\_id/cards/video\_website/:card\_id](https://developer.x.com/en/docs/ads/creatives/api-reference/video-website.html#put-accounts-account-id-cards-video-website-card-id)
* [DELETE accounts/:account\_id/cards/video\_webiste/:card\_id](https://developer.x.com/en/docs/ads/creatives/api-reference/video-website.html#delete-accounts-account-id-cards-video-website-card-id)
**Draft Campaigns[¶](#draft-campaigns "Enlace permanente a este encabezado")**
Las campañas en borrador han estado disponibles para su visualización a través del endpoint [GET accounts/:account\_id/camapaigns](/es/x-ads-api/campaign-management#get-accounts-account-id-campaigns). Con v2, ahora es posible crear y activar campañas en borrador a través de la API.
* El valor del parámetro `entity_status` en los endpoints [POST accounts/:account\_id/line\_items](/es/x-ads-api/campaign-management#post-accounts-account-id-line-items) y [POST accounts/:account\_id/campaigns](/es/x-ads-api/campaign-management#post-accounts-account-id-campaigns) se puede establecer en `DRAFT` para crear cualquier nueva campaña o línea de pedido en borrador.
* Conjunto de parámetros obligatorios para un borrador recién creado:
| Campaña en borrador | Línea de pedido en borrador |
| :---------------------- | :-------------------------- |
| `funding_instrument_id` | `campaign_id` |
| `name` | `objective` |
| `start_time` | `product_type` |
| | `placements` |
**Notas[¶](#notes "Permalink to this headline")**
* Las líneas de pedido o campañas en borrador solo se pueden convertir de un `entity_status` de `DRAFT` a `PAUSED` o `ACTIVE`.
* Para activar una campaña completa (con múltiples líneas de pedido), cada línea de pedido dentro de la campaña, así como la propia campaña, deben establecerse con un `entity_status` de `ACTIVE`.
* Para cambiar el `entity_status` de cualquier campaña o línea de pedido, utiliza el endpoint PUT correspondiente.
**Tweets programados[¶](#scheduled-tweets "Permalink to this headline")**
* Los Tweets programados incluyen los siguientes endpoints nuevos:
* Tweets programados:
* [GET accounts/:account\_id/scheduled\_tweets](/es/x-ads-api/creatives#get-accounts-account-id-scheduled-tweets)
* [GET accounts/:account\_id/scheduled\_tweets/:scheduled\_tweet\_id](/es/x-ads-api/creatives#scheduled-tweets)
* [POST accounts/:account\_id/scheduled\_tweets](/es/x-ads-api/creatives#post-accounts-account-id-scheduled-tweets)
* [PUT accounts/:account\_id/scheduled\_tweets/:scheduled\_tweet\_id](/es/x-ads-api/creatives#scheduled-tweet-management)
* [DELETE accounts/:account\_id/scheduled\_tweets/:scheduled\_tweet\_id](/es/x-ads-api/creatives#scheduled-tweet-management)
* Administración de campañas:
* [GET accounts/:account\_id/scheduled\_promoted\_tweets](/es/x-ads-api/campaign-management#get-accounts-account-id-scheduled-promoted-tweets)
* [GET accounts/:account\_id/scheduled\_promoted\_tweets/:scheduled\_promoted\_tweet\_id](/es/x-ads-api/campaign-management#get-accounts-account-id-scheduled-promoted-tweets-scheduled-promoted-tweet-id)
* [POST accounts/:account\_id/scheduled\_promoted\_tweets](/es/x-ads-api/campaign-management#post-accounts-account-id-scheduled-promoted-tweets)
* [DELETE accounts/:account\_id/scheduled\_promoted\_tweets/:scheduled\_promoted\_tweet\_id](/es/x-ads-api/campaign-management#delete-accounts-account-id-scheduled-promoted-tweets-scheduled-promoted-tweet-id)
* Los nuevos Tweets programados se pueden configurar para cualquier fecha futura.
* Actualmente, no es posible previsualizar un Tweet programado.
* Solo los Tweets programados en el estado `SCHEDULED` pueden editarse o eliminarse.
* Los Tweets programados *no* se propagan al Firehose empresarial ni a ninguna otra API de datos hasta la fecha/hora `scheduled_at`.
### v1
La versión 1 de la Ads API se lanzó el 31 de marzo de 2016 y llegará al final de su vida útil el 10 de enero de 2018.
**Cambios en la versión 1:[¶](#changes-in-version-1 "Permalink to this headline")**
* [Compatibilidad con versiones](https://blog.x.com/2016/versioning-is-coming-to-twitter-s-ads-apis)
* `CUSTOM` [objective](/es/x-ads-api/campaign-management#objective-based-campaigns) ya no se admite
* Los [endpoints por lotes](/es/x-ads-api/campaign-management#post-batch-accounts-account-id-campaigns) ya están disponibles de forma general
* [Cambios en las estimaciones de alcance](https://developer.x.com/en/docs/ads/campaign-management/api-reference/reach-estimate.html#get-accounts-account-id-reach-estimate):
* Para ofrecer una mejor estimación del alcance, el endpoint ahora tiene en cuenta el presupuesto. Ahora se requieren los siguientes parámetros:
* \[nuevo] `campaign_daily_budget_amount_local_micro`
* `currency`
* `bid`
* `objective`
* El objeto de respuesta ha cambiado y ahora devuelve rangos de valores en la respuesta.
* `infinite_count` se ha renombrado como `infinite_bid_count` para evitar confusión sobre su finalidad
* Además de `count` e `infinite_bid_count`, ahora se devolverán los siguientes nuevos datos:
* `impressions`
* `engagements`
* `estimated_daily_spend_local_micro`
* Cambio de tipo de datos para audiencias personalizadas
* El `data_type` correspondiente a Tailored Audiences se ha cambiado de `tailored_audiences` a `tailored_audience` en todas nuestras respuestas.
* Las Shared Tailored Audiences ahora están disponibles en versión beta *solo mediante API*. Las Shared Tailored Audiences permiten que una única audiencia se utilice en varias cuentas publicitarias. Usa el endpoint [POST accounts/:account\_id/tailored\_audiences/:tailored\_audience\_id/permissions](/es/x-ads-api/audiences) (y los relacionados) para administrar los permisos de una audiencia personalizada que quieras compartir entre varias cuentas publicitarias.
* Mejoras significativas en cómo recopilas [métricas de rendimiento](/es/x-ads-api/analytics) para cuentas de anunciantes:
* Para alinearnos con nuestras [mejores prácticas](/es/x-ads-api/analytics#best-practices), ahora solo permitiremos recuperar hasta **7 días** de datos para los [endpoints síncronos de estadísticas](/es/x-ads-api/analytics#get-stats-accounts-account-id).
* Para simplificar la recuperación de métricas, hemos reemplazado el parámetro `metrics` por un nuevo parámetro `metric_groups`. Los desarrolladores solo tienen que indicar qué grupos de métricas quieren que se devuelvan para una solicitud determinada.
* Cualquier solicitud de métricas que no sean apropiadas para una entidad determinada se excluirán de la respuesta y se representarán como valores `null`. *Estas métricas no se contabilizarán para tu límite de costos de análisis.*
* La respuesta se ha **simplificado significativamente** y ahora se alineará mejor con la forma en que las métricas se exponen en nuestra interfaz de usuario.
* Anteriormente exponíamos una métrica separada para cada ubicación (Tweets promocionados en Búsqueda, Tweets promocionados en cronologías, Tweets promocionados en perfiles y detalles del Tweet, X Audience Platform). Ahora devolveremos un conjunto estandarizado de métricas para cada una (en lugar de `promoted_tweet_timeline_impressions`, `promoted_tweet_search_impressions`, `promoted_tweets_profile_impressions`, `promoted_tweets_tpn_impressions`), que se expondrán, cuando se soliciten en una de las siguientes categorías, como una única métrica, `impressions` (esto se aplica a todas las métricas):
* `ALL_ON_TWITTER`
* `PUBLISHER_NETWORK`
* Cuando realices una solicitud, obtendrás una única métrica `impressions` para que hacer corresponder los valores en nuestra interfaz de usuario sea más sencillo.
* Debes hacer dos consultas para obtener tanto los datos de `ALL_ON_TWITTER` como de `PUBLISHER_NETWORK`, ya que no se pueden combinar.
* Los [endpoints de estadísticas asíncronas](/es/x-ads-api/analytics#asynchronous-analytics) ya están disponibles gracias a los comentarios de nuestros desarrolladores.
* Un nuevo conjunto de endpoints para solicitar estadísticas de forma *asíncrona*, para datos que no necesitas de inmediato o para recuperar datos históricos.
* Coloca en cola una tarea de estadísticas mediante un único endpoint nuevo. Obtendremos los datos que has solicitado según lo permitan los recursos.
* Puedes consultar un endpoint de estado de la tarea para comprobar si los datos están disponibles.
* Una vez que los datos estén disponibles, proporcionaremos un ID de recogida para que descargues la respuesta JSON, que reflejará la respuesta del endpoint síncrono.
* Consulta hasta **90 días** de datos de hasta **20 entidades** en una sola tarea.
* Consulta nuestra guía de migración de analytics v1, que incluye la correspondencia entre las métricas de v0 y las de v1
* Mejoras del Sandbox \* Ahora puedes [crear varias cuentas de anuncios de prueba](/es/x-ads-api/campaign-management#post-accounts) en el entorno Sandbox. \* Ahora puedes crear varios instrumentos de financiación para una cuenta de anuncios de prueba, solo en el entorno Sandbox. Esto te permite hacer pruebas con todos nuestros tipos de instrumentos de financiación. Antes, solo estaba disponible una fuente de financiación `CREDIT_CARD` para realizar pruebas. \* ¿Quieres probar una función beta? Ahora puedes activar o desactivar funciones para una cuenta en el entorno Sandbox y ajustarlas a tus necesidades de prueba.
### v0
La versión 0 de la Ads API se lanzó oficialmente el 21 de febrero de 2013 y contó con soporte hasta el 31 de octubre de 2016.
Todos los endpoints de analítica de la versión 0 han quedado obsoletos y dejarán de estar disponibles después del 31 de octubre de 2016. Estos endpoints se han sustituido por 3 endpoints de analítica en la versión 1.
El endpoint de estimación de alcance presenta un nuevo comportamiento en la versión 1.