Volver a las novedades para desarrolladores

Próximo cambio en la retirada de las versiones de la API de marketing para activar la actualización automática de la versión

16 de abril de 2024DeMengxuan Zhang

Suscribirte a Noticias para desarrolladores

Para mejorar la experiencia general de la API y hacer que sea más fluida y eficiente, nos complace anunciar el próximo lanzamiento de la función de actualización automática de la versión de la API de marketing. A partir de mayo de 2024, activaremos la función de actualización automática de la versión para los extremos de la API de marketing que no se vean afectados entre versiones. Esto significa que, si un extremo no se ve afectado entre una versión que se va a retirar y la siguiente versión disponible, la plataforma actualizará automáticamente la llamada a la siguiente versión disponible en lugar de generar un error de solicitud directamente.

El control de versiones de una API es un método habitual para gestionar los cambios que se realizan en ella y sobre todo se usa para publicar cambios disruptivos. A medida que se lanzan nuevas versiones, se retiran las más antiguas. Durante la retirada de la API, si una aplicación llama a una versión de la API retirada, recibirá el siguiente error: “(#2635) Estás llamando a una versión retirada de la API de anuncios. Actualiza a la versión más reciente: vXXX”.

La versión 17.0 se retirará el 14 de mayo de 2024. Según el registro de cambios de la versión 18.0, se verán afectados los siguientes extremos:

POST /act_{ad-account-id}/reachfrequencypredictions
GET /act_{ad-account-id}/reachestimate
GET /act_{ad-account-id}/delivery_estimate
POST /act_{ad-account-id}/adsets
POST /{adset-id}
POST /act_{ad-account-id}/saved_audiences
POST /{saved-audience-id}
POST /act_{ad-account-id}/credit_cards

Si la aplicación llama a POST /{adset-id} con la versión 17.0 después de su retirada el 14 de mayo de 2024, se producirá un error en esta solicitud a la API, ya que la actualización automática no se aplica a los extremos afectados por la siguiente versión disponible (versión 18.0).

Si la aplicación llama a GET /{ad-account-id}/insights con la versión 17.0 después de su retirada, la plataforma actualizará la llamada a la siguiente versión disponible (versión 18.0).

Si la aplicación ya hace llamadas con versiones superiores a la 17.0, no se producirá ningún cambio en la fecha de retirada de la versión.

Para desactivar la actualización automática de la versión, consulta Configuración > Configuración de la versión de la API de anuncios en la tarjeta del producto de la aplicación de la API de marketing para inhabilitar esta función.

Si quieres confirmar si una llamada se ha actualizado automáticamente, consulta el encabezado de la respuesta de la API para obtener más información.

Ejemplo de encabezado de notificación: “X-Ad-Api-Version-Warning: ‘La llamada se ha actualizado automáticamente a la versión 17.0, porque la versión 16.0 se ha retirado’”

Para obtener más información sobre este comportamiento, consulta Control de versiones de la API de marketing.

Para saber qué extremos se ven afectados en cada versión, consulta Registro de cambios.

Extremos afectados