Introducing Facebook Graph API v12.0 and Marketing API v12.0

Hoy lanzamos la versión 12.0 de la API Graph y la API de marketing de Facebook. A continuación, hemos destacado los cambios que afectarán a nuestra comunidad de desarrolladores. Estos cambios incluyen anuncios y actualizaciones de productos, recordatorios de lanzamientos anteriores y notificaciones de retiradas a gran escala que podrían afectar a la integración de tus aplicaciones con nuestra plataforma.

Para ver una lista completa de todos los cambios y sus detalles, consulta nuestro registro de cambios.

Anuncios y actualizaciones generales

API de conversiones: ampliamos la versión mínima a la que se puede llamar

Compatibilidad con versiones anteriores de la API Graph para aplicaciones creadas con identificadores de acceso de un solo clic A partir de la versión 12.0, los identificadores de acceso generados recientemente en la pestaña de configuración de la API de conversiones en el Administrador de eventos serán compatibles con todas las versiones de la API Graph disponibles (puedes consultar las versiones compatibles aquí).

Ten en cuenta que las llamadas realizadas con estos identificadores a una versión de la API Graph retirada pasarán automáticamente a la versión más antigua disponible. Este comportamiento solo se aplica a los extremos de la API Graph. Los extremos de la API de marketing, como la API de conversiones, no admiten el comportamiento de actualización automática y devolverán una excepción.

API de perfil de usuario para los mensajes en Instagram: campos nuevos

Estamos realizando mejoras en nuestra API de perfil de usuario para los mensajes en Instagram. Anteriormente, la API de perfiles de usuario para Instagram admitía dos campos: 1) nombre y 2) URL de la foto del perfil. Para que las empresas puedan personalizar mejor y priorizar los mensajes en función de la información de usuario disponible públicamente, hemos actualizado la API para que también incluya la siguiente información:

1. Recuento de seguidores
2. Insignia de verificación
3. La empresa sigue la cuenta de usuario [Sí/No]
4. La cuenta de usuario sigue la cuenta de empresa [Sí/No]

Consulta la documentación para desarrolladores a fin de obtener detalles.

Segmentación detallada de nuevas oportunidades

Para ayudar a los anunciantes a encontrar oportunidades adicionales que originalmente no tenían disponibles, cuando aprovechen la segmentación detallada y la optimización para las conversiones, el valor o los eventos de la aplicación mediante el objetivo de conversiones, se incluirán automáticamente en la Expansión de la segmentación. Para obtener más información, consulta el artículo del servicio de ayuda sobre la expansión de la segmentación detallada.

API de vídeo: campos nuevos

Hemos añadido dos campos nuevos, views y post_views, al nodo [Video]. Consulta la documentación para desarrolladores sobre la API de vídeo para obtener más información.

Retiradas y cambios de última hora

Transparencia de errores

El comportamiento predeterminado de la API Graph y la API de marketing consiste en devolver un error cuando una aplicación solicita un campo o un perímetro en un nodo que devuelve un nodo o nodos asociados, pero no cuenta con los permisos apropiados que los nodos asociados necesitan. Sin embargo, algunos de estos campos y perímetros no seguían este protocolo y no se incluían en las respuestas de la API si la aplicación que llamaba carecía de los permisos apropiados.

A partir de la versión 12.0, estos campos y perímetros seguirán el comportamiento predeterminado. Este cambio se aplicará a todas las versiones el 13 de diciembre de 2021.

• Extremos de la API Graph afectados
• Extremos de la API de marketing afectados

Usuarios del sistema y roles de la aplicación

Vamos a retirar la capacidad de conceder roles a los usuarios del sistema en las aplicaciones a menos que tanto los usuarios como las aplicaciones pertenezcan a la misma empresa. Para evitar alteraciones en tu aplicación y empresa, recomendamos que elimines de la aplicación a estos usuarios del sistema y que utilices la API de empresa en representación en su lugar. Este cambio de última hora entrará en vigor el 13 de diciembre de 2021.

Vídeos en directo programados

Vamos a retirar el parámetro planned_start_time dentro de la función de programación de la Live API y este cambio de última hora entrará en vigor el 13 de diciembre de 2021. Próximamente anunciaremos un nuevo parámetro.

Plataforma de Messenger: API de conversación

Vamos a retirar el campo user_id de los metadatos del hilo en la API de conversación. Todos los desarrolladores tendrán que migrar las referencias a user_id (IGID) y basarse por completo en IGSID como identificador principal de un hilo entre el usuario y la empresa.

Este cambio de última hora entrará en vigor en las versiones anteriores de la API Graph el 13 de diciembre de 2021. Consulta la documentación para desarrolladores sobre la API de conversación para obtener más información.

Plataforma de Messenger: webhooks de Instagram

Vamos a realizar una actualización a nuestra API de Messenger para el webhook de reacción de Instagram para ofrecer mejor compatibilidad con las reacciones con emoticonos. La versión actual devuelve el campo del emoticono como una cadena. Con esta actualización, los webhooks de reacción devolverán un nuevo formato unicode. Ten en cuenta que este campo de "reacción" solo admitirá los emoticonos predeterminados. Para el resto de emoticonos, el campo de reacción devolverá "other", al igual que en Messenger.

Este cambio de última hora entrará en vigor en las versiones anteriores de la API Graph a partir del 13 de diciembre de 2021. Para mantener la compatibilidad con las reacciones de emoticonos, todos los desarrolladores deben migrar al nuevo formato unicode que devolveremos a partir del 13 de diciembre de 2021. Consulta la documentación para desarrolladores sobre webhooks a fin de obtener detalles.

Retiradas de versiones de la API:

Como parte de la programación para las versiones de Facebook para la API Graph y la API de marketing, ten en cuenta las próximas retiradas:

API Graph

• 2 de noviembre de 2021: la versión 4.0 de la API Graph se retirará y eliminará de la plataforma
• 3 de febrero de 2022: la versión 5.0 de la API Graph se retirará y eliminará de la plataforma
• 22 de mayo de 2022: la versión 6.0 de la API Graph se retirará y eliminará de la plataforma

A fin de evitar cualquier interrupción en tu empresa, te recomendamos que migres todas las llamadas a la versión de la API más reciente que lanzamos hoy.

API de marketing

• La versión 10.0 de la API de marketing se retirará el 04/10/2021
• La versión 11.0 de la API de marketing se retirará el 23/02/2022

A fin de evitar cualquier interrupción en tu empresa, te recomendamos que migres todas las llamadas a la versión de la API de marketing más reciente que lanzamos hoy. (Visita el registro de cambios para obtener más información).

SDK de la plataforma de Facebook

• El 19 de enero de 2021, anunciamos la programación de retiradas de 2 años para la versión 8.x del SDK de la plataforma de Facebook y las versiones anteriores. Estas versiones desaparecerán en enero de 2023.
• El 8 de junio de 2021 lanzamos la versión 11.0 del SDK de la plataforma de Facebook, que dio inicio a la retirada de 2 años de la versión 9.0 del SDK de la plataforma de Facebook. La versión 9.0 del SDK desaparecerá en junio de 2023.

Retiradas generales

Retirada del extremo de ofertas nativas

El 8 de junio de 2021, anunciamos la retirada de la API de anuncios con ofertas. Entrará en vigor inmediatamente tras el lanzamiento de la versión 12.0 de la API Graph.

Plataforma de Messenger: plantillas de aerolíneas

El 8 de junio de 2021, anunciamos la retirada de las plantillas de aerolíneas. Entrará en vigor el 6 de diciembre de 2021.