Volver a las novedades para desarrolladores

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

23 de febrero de 2021DeKirk Thaker

Hoy lanzamos la versión 10.0 de la API Graph y la API de marketing de Facebook.

Este lanzamiento contiene muchos avisos, actualizaciones, retiradas y reincorporaciones que pueden afectar a la forma de integrar la aplicación en nuestra plataforma. En esta publicación se describen estas actualizaciones y los pasos que deben seguir los desarrolladores para evitar interrupciones donde corresponda.

A continuación, se proporciona información detallada sobre todos los cambios. Para ver las especificaciones técnicas, visita el registro de cambios de la versión 10.0.

Visita el centro de iniciativas de la plataforma para obtener más información sobre nuestra plataforma para desarrolladores.

Avisos y actualizaciones

Certificación de la Comprobación del uso de datos

A fin de no perder el acceso a la API de la plataforma de Facebook, completa la Comprobación del uso de datos (DUC) en los 60 días siguientes a tu inscripción. Para completarla, ve a la página "Mis aplicaciones" del panel de aplicaciones.

El otoño pasado, Facebook lanzó la función Comprobación del uso de datos (DUC), un nuevo requisito anual para que los desarrolladores certifiquen que su acceso a la API y el uso que hacen de los datos cumplen con las políticas para desarrolladores y los términos de la plataforma de Facebook.

Como parte de la implementación gradual en todas las aplicaciones, recibirás la fecha de vencimiento y otras instrucciones mediante una alerta para desarrolladores, junto con un correo electrónico en la dirección de contacto registrada y una notificación en la lista de acciones necesarias del panel de aplicaciones.

Para obtener instrucciones detalladas sobre cómo completar la DUC, puedes consultar la documentación para desarrolladores. También puedes obtener más información en la sección de las preguntas frecuentes dedicada a la DUC.

Límite de 90 días y niveles para el acceso a datos de la API de grupos:

A partir del 24 de mayo de 2021, al utilizar la API de grupos, el periodo de acceso a los datos disponible para las aplicaciones se limitará a 90 días.

También incorporaremos el acceso por niveles a la API de grupos para las aplicaciones de consumidor en función de si se encuentran en el modo de desarrollo o publicado. Ahora, los permisos de la API de grupos tendrán un comportamiento similar al acceso estándar o avanzado para las aplicaciones empresariales.

Actualmente, las aplicaciones en modo de desarrollo pueden acceder a todo el contenido de los grupos públicos y privados en que el desarrollador sea administrador. Tras completar la revisión de la aplicación, estas aplicaciones podrán acceder a todo el contenido de los grupos que tengan instalada la aplicación.

El 24 de mayo de 2021, las aplicaciones en modo de desarrollo solo podrán acceder a su propio contenido en grupos públicos y privados en que el desarrollador sea administrador. Esto significa que la aplicación no tendrá acceso al contenido que hayan publicado otros usuarios de los grupos (sin roles en la aplicación), como publicaciones y comentarios.

Obtén más información en el registro de cambios de la versión 10.0.

Niveles de acceso de los permisos email y public_profile para las aplicaciones empresariales

Como parte de nuestras continuas iniciativas para proteger los datos de los usuarios, hemos añadido los permisos public_profile (es decir, los campos de perfil público predeterminados) e email al modelo de niveles de acceso que presentamos con la versión 8.0 de la API Graph para las aplicaciones empresariales nuevas y existentes.

Las aplicaciones empresariales que se creen ahora tendrán, inicialmente, acceso estándar para los permisos email y public_profile. Cuando una aplicación tenga acceso estándar a public_profile, solo los usuarios con un rol en la aplicación o la empresa que la haya reclamado podrán buscarla o iniciar sesión en ella. Si necesitas que los usuarios externos puedan iniciar sesión en la aplicación, los administradores de esta podrán solicitar acceso avanzado en el panel de aplicaciones y este se concederá de forma automática.

Obtén más información en el registro de cambios de la versión 10.0.

Recordatorios de solicitudes de eliminación de datos

Tal y como anunciamos el 10 de noviembre de 2020, los tipos de aplicaciones de videojuegos y consumidor que se envíen para la revisión de la aplicación o pasen del modo de desarrollo al publicado deberán proporcionar una devolución de llamada de solicitud de eliminación de datos o bien una URL con instrucciones explícitas para los usuarios sobre cómo solicitar la eliminación de sus datos. Tenemos previsto implementar este requisito a partir del 10 de noviembre de 2022 y mandaremos un recordatorio a los desarrolladores de aplicaciones 60 días antes de su entrada en vigor.

Opciones de cambio de la API Graph de AdsInsight para el proyecto de reducción de la retención

La IU del administrador de anuncios dejará de admitir los informes de datos de resultados de estadísticas de los anuncios anteriores a 37 meses. La API devolverá un error cuando la solicitud contenga intervalos de fechas anteriores a la retención de 37 meses. Inhabilitaremos el valor "date_preset = lifetime" y lo reemplazaremos por "date_preset = maximum".

Los cambios en la versión 10.0 de la API Graph en AdsInsight, excepto el del valor "date_preset = lifetime", se aplicarán a todas las versiones de la API Graph transcurridos 90 días. No será necesario realizar ningún cambio en el campo específico al que se llama. Habrá una funcionalidad predefinida y todas las llamadas "Lifetime" se establecerán de forma predeterminada en una retención de 37 meses como máximo.

Este cambio no afecta a los datos relacionados con el contenido del anuncio, las audiencias, la configuración de entrega ni los nombres de los objetos de anuncios. Así mismo, tampoco se producirá ningún cambio en el cálculo de los resultados existentes. Este cambio se aplicará en las superficies de informes de anuncios, como el administrador de anuncios, los informes de anuncios y las experiencias de anuncios de bajo consumo.

  • Día de lanzamiento: 23/2/2021:
    • versión 10.0
      • Habilitación de "date_preset = maximum"
      • Inhabilitación de "date_preset = lifetime"
      • Devolución de un error cuando la solicitud contenga intervalos de fechas explícitos anteriores a la retención de 37 meses
    • Versiones 9.0 y anteriores
      • Sin cambios en la funcionalidad actual
  • 90 días después de la publicación (24/5/2021):
    • Versiones 9.0 y anteriores
      • Habilitación de "date_preset = maximum" (igual que en la nueva versión)
      • Devolución de un error cuando la solicitud contenga intervalos de fechas explícitos anteriores a la retención de 37 meses (igual que en la nueva versión)
      • "date_preset = lifetime" puede seguir funcionando, pero solo devolverá datos de los últimos 37 meses como máximo.

Obtén más información en el registro de cambios de la versión 10.0.

Nueva política de eliminación de los datos de propiedad externa en ThreatExchange

A partir del 24 de mayo de 2021, cuando los socios establezcan un valor para expire_time en los datos que suban en ThreatExchange, eliminaremos de forma permanente dichos datos en el momento de caducidad especificado. Si quieres indicar que los datos ya no son válidos, establece el campo "expired_on" de modo que se eliminen de manera automática.

Anteriormente, la eliminación temporal significaba que etiquetábamos el contenido que caducaba como caducado. Hemos dejado de admitir las eliminaciones temporales y, una vez que el contenido caduque, lo eliminaremos permanentemente y ya no será visible en ThreatExchange.

Además, todos los elementos ThreatDescriptors que no sean de Facebook de ThreatExchange se eliminarán de manera permanente cuando caduquen. El creador de ThreatDescriptor seguirá estableciendo el momento de la caducidad. De este modo, se procederá con la eliminación de todos los elementos ThreatDescriptors caducados que no haya creado Facebook. Si, actualmente, tu aplicación contiene elementos ThreatDescriptors caducados que no quieres eliminar cuando entre en vigor esta política, debes retrasar la fecha de caducidad o bien establecerla en "0" para asegurarte de que los datos nunca caduquen.

Haz clic aquí para obtener más información sobre los cambios.

Cambios en la segmentación de la nueva API

A partir del 24 de mayo de 2021, ya no solicitaremos los parámetros country ni location_spec al crear una audiencia personalizada similar en todas las versiones de la API.

Al crear una audiencia similar, el usuario seleccionará el origen similar y la proporción deseada. La ubicación de las audiencias similares se definirá según la ubicación del país en la especificación de segmentación de la campaña. Este cambio no afectará a las campañas existentes, sino a las nuevas y editadas.

Lanzamiento de una nueva página de estado en directo de la plataforma

La nueva página de estado empresarial de Facebook mejorará la transparencia y la comunicación proactiva, ya que permitirá que los desarrolladores externos utilicen los productos de la plataforma de Facebook. Esta página proporcionará un sitio centralizado en el que comprobar el estado de la plataforma de los productos empresariales de Facebook (anuncios, API de WhatsApp Business, plataforma para desarrolladores de Facebook, etc.). Actualmente, esta página está activa para el administrador de anuncios y la API de WhatsApp Business, y hasta mayo de 2021 se le añadirán más productos empresariales.

Retiradas

Retirada del cuadro de diálogo "Transmitir en directo"

El 24 de mayo de 2021, retiraremos el SDK del cuadro de diálogo "Transmitir en directo" (GLD). Esta retirada de una herramienta de producción en directo heredada se aplicará a todas las versiones de la API. Este cambio solo afectará a la transmisión en directo de Facebook. Aconsejamos a los desarrolladores que usen Live Producer y Live API para todas las soluciones de producción en directo personalizadas.

Soluciones que se publicarán cuando se retire el SDK de GLD:

  • Acceso a Live Producer directamente desde facebook.com/live/producer (u otros puntos de entrada en Facebook, como el botón “Vídeo en directo” de una página o un perfil).
  • Integración de cualquier solución personalizada con Live API.

Obtén más información en el registro de cambios de la versión 10.0.

Retirada de la segmentación de conexiones

A partir del 24 de mayo de 2021, la segmentación de conexiones ya no se admitirá al crear o editar un conjunto de anuncios. Este requisito solo afectará a las campañas nuevas y editadas y no tendrá ningún efecto sobre las campañas existentes.

Obtén más información en el registro de cambios de la versión 10.0.

Reincorporaciones

Reincorporación del extremo gr:delete:Page/tabs

Cuando lanzamos la versión 8.0 de la API Graph, dejamos de utilizar el extremo gr:delete:Page/tabs para las pestañas de páginas. Hemos decidido reincorporar este extremo de manera inmediata en la versión 10.0 de la API Graph y restaurar su acceso el 24 de mayo de 2021 en las demás versiones de dicha API.

Obtén más información en el registro de cambios de la versión 10.0.

Reincorporación de los extremos gr:post:Business/business_users, gr:post:Business/system_users y gr:post:User/access_tokens

Cuando lanzamos la versión 9.0 de la API Graph, restringimos el acceso a tres extremos empresariales:

  • gr:post:Business/business_users
  • gr:post:Business/system_users
  • gr:post:User/access_tokens

Como parte del lanzamiento de la versión 10.0 de la API Graph, volveremos a abrir estos extremos a las llamadas a la API cuando las aplicaciones cumplan una de estas dos condiciones:

  • Cuando la empresa de destino sea la propietaria de la aplicación que realiza la llamada.
  • Cuando la empresa de destino sea una secundaria (de un modelo empresarial de dos niveles) de la empresa propietaria de la aplicación que realiza la llamada.

Obtén más información en el registro de cambios de la versión 10.0.

Calendario de elementos de acción

Retiradas de versiones de la API de marketing:

Como parte de nuestra programación para las versiones de la API de marketing, retiraremos las siguientes versiones de esta API:

  • 3 de marzo de 2021: la versión 7.0 de la API de marketing se retirará y eliminará de la plataforma.
  • 4 de mayo de 2021: la versión 8.0 de la API de marketing se retirará y eliminará de la plataforma.
  • 25 de agosto de 2021: la versión 9.0 de la API de marketing 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 de marketing más reciente que lanzamos hoy. (Visita el registro de cambios para obtener más información).

Retiradas de versiones de la API Graph:

Como parte de nuestra programación para las versiones de la API Graph, retiraremos las siguientes versiones de esta API:

  • 4 de mayo de 2021: la versión 3.2 de la API Graph se retirará y eliminará de la plataforma.
  • 3 de agosto de 2021: la versión 3.3 de la API Graph se retirará y eliminará de la plataforma.

Retiradas generales

  • 24 de mayo de 2021:
    • El cuadro de diálogo "Transmitir en directo" se retirará y eliminará de la plataforma.
    • La segmentación de conexiones se retirará y eliminará de la plataforma.

Se requiere una acción por parte del desarrollador.

  • Inscripción continua: certificación de la Comprobación del uso de datos
    • Una vez que se realice la inscripción, esta debe completarse en un plazo de 60 días.
    • Sección de las preguntas frecuentes dedicada a la DUC.
  • 23 de febrero de 2021: lanzamiento de los cambios en la API Graph de AdsInsight solo para la versión 10.0 de la API Graph
  • 24 de mayo de 2021:
    • Lanzamiento de los cambios en la API Graph de AdsInsight para la versión 9.0 de la API Graph e inferiores
    • Entrada en vigor de los cambios en los niveles de acceso basados en la revisión de la aplicación
      • Limitación de 90 días para el acceso a los datos de la API de grupos
      • Implementación de los niveles de datos por niveles de la API de grupos
      • Entrada en vigor del cambio de los permisos email y public_profile para las aplicaciones empresariales
    • Implementación de la nueva política de datos de eliminación permanente en ThreatExchange
  • 10 de noviembre de 2022: fecha límite de las solicitudes de eliminación de datos.