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

Para mejorar la experiencia general con la API al hacerla más sencilla y eficiente, nos entusiasma 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 en los puntos de conexión de la API de marketing que no se ven afectados entre versiones. Esto significa que, entre una versión que va a quedar obsoleta y la siguiente versión disponible, si un punto de conexión no se ve afectado, la plataforma actualizará la llamada a la siguiente versión disponible de manera automática, en lugar de rechazar directamente la solicitud.

El control de versiones de una API es una manera común de manejar los cambios que se implementan en esta. Lo más frecuente es utilizarlo para implementar cambios importantes. A medida que se lanzan nuevas versiones, las anteriores quedan obsoletas. En esta etapa, si una app llama a una versión obsoleta de esta, recibirá el siguiente error: "(#2635) Estás llamando a una versión obsoleta de la API de anuncios. Actualiza a la versión más reciente: XXX".

El 14 de mayo de 2024, quedará obsoleta la versión 17.0. Según el registro de cambios de la versión 18.0, se verán afectados los siguientes puntos de conexión:

• 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 app llama al punto de conexión POST /{adset-id} con la versión 17.0 luego de que quedara obsoleta el 14 de mayo de 2024, también se rechazará esta solicitud de la API, ya que la actualización automática no se aplica a los puntos de conexión afectados por la siguiente versión disponible, la 18.0.

Si la app llama al punto de conexión GET /{ad-account-id}/insights con la versión 17.0 después de que quedara obsoleta, la plataforma actualizará la llamada a la siguiente versión disponible, la 18.0.

Si la app ya realiza llamadas con versiones posteriores a la 17.0, no habrá ningún cambio luego de la fecha en que queda obsoleta la versión.

Si deseas rechazar la actualización automática de versiones, consulta Configuración > Configuración de versión de la API de anuncios en la tarjeta del producto de la app de la API de marketing para desactivar esta función.

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

• Ejemplo de encabezado de notificación: ‘X-Ad-Api-Version-Warning:‘ The call has been auto-upgraded to v17.0 as v16.0 has been deprecated’’

Para obtener más información sobre el comportamiento, consulta Versiones de la API de marketing.

Para comprobar los puntos de conexión afectados en cada versión, consulta el registro de cambios.

Puntos de conexión afectados

• Todos los puntos de conexión de la API de marketing

Enlace a la documentación del desarrollador

• https://developers.facebook.com/docs/marketing-api/versions#version_auto_upgrade

Enlace al artículo de ayuda sobre la función

• https://developers.facebook.com/docs/marketing-apis