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

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

Este lanzamiento incluye una gran cantidad de anuncios, actualizaciones, elementos obsoletos y "rehabilitados", que pueden afectar la forma en que se integran tus apps en nuestra plataforma. En esta publicación, se detallan estas actualizaciones y los pasos necesarios que deben seguir los desarrolladores para evitar interrupciones, si corresponde.

A continuación, encontrarás información detallada sobre todos los cambios. Visita nuestro registro de cambios de la versión 10.0 para obtener información sobre las especificaciones técnicas.

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

Anuncios y actualizaciones

Certificado de comprobación de uso de datos

Para evitar perder acceso a la API de la plataforma de Facebook, completa la comprobación de uso de datos (DUC) dentro de los 60 días posteriores a registrarte. Puedes completar la DUC si vas a la página “Mis apps” en tu panel de apps.

El invierno pasado, Facebook lanzó la comprobación de uso de datos (DUC), un nuevo requisito anual para desarrolladores para que certifiquen que el acceso a la API y el uso de datos cumple con las condiciones de la plataforma y las políticas para desarrolladores de Facebook.

Como parte de nuestra implementación gradual para todas las apps, recibirás el plazo para hacerlo y más instrucciones a través de las alertas para desarrolladores, y, además, un correo electrónico, que se enviará a la dirección de correo electrónico de contacto registrada, y una notificación en tu lista de acciones requeridas en el panel de apps.

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

Niveles de acceso a los datos de la API de grupos por 90 días y límites de datos:

A partir del 24 de mayo de 2021, cuando se utilice la API de grupos, se limitará a 90 días la ventana de acceso a los datos disponible para la app.

También presentamos el acceso a la API de grupos por niveles para las apps para consumidores que se basan en si se encuentran en modo de desarrollo o modo activo. Los permisos de la API de grupos funcionan ahora de manera similar al acceso estándar y acceso avanzado para las apps de negocios.

Hoy las apps que están en modo de desarrollo pueden acceder a todos los contenidos de los grupos públicos y grupos privados en los que el desarrollador sea administrador. Después de completar la revisión de apps, estas apps pueden acceder a todo el contenido de los grupos que instalaron la app.

El 24 de mayo de 2021, las apps que están en modo de desarrollo solo pueden acceder al contenido propio de los grupos públicos y privados en los que el desarrollador sea administrador. Esto significa que la app no tendrá acceso al contenido que publicaron los usuarios de otros grupos (sin roles en la app) como, por ejemplo, publicaciones y comentarios.

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

Niveles de acceso para "public_profile" y permisos de correo electrónico para las apps de negocios

Como parte de nuestras iniciativas constantes para proteger los datos de los usuarios, añadimos public_profile (por ejemplo, campos de perfil público predeterminado) y permisos de correo electrónico para el modelo de niveles de acceso que anunciamos con la versión 8.0 de Graph para las apps de empresas nuevas y existentes.

Las apps para empresas recientemente creadas se inician ahora con acceso estándar para "public_profile" y los permisos de correo electrónico. Cuando una app tiene acceso estándar al "public_profile", solo los usuarios que tienen un rol en la app o en una empresa que haya solicitado la app pueden buscar la app o iniciar sesión en ella. Si necesitas que usuarios externos inicien sesión en tu app, los administradores de apps pueden solicitar el acceso avanzado en el panel de apps. Este acceso se generará de manera 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

Como se anunció el 10 de noviembre de 2020, para las apps de videojuegos y para consumidores que se envíen a revisión o que pasen del modo de desarrollo al modo activo, se deberá proporcionar una devolución de llamada para las solicitudes de eliminación de datos o una URL con instrucciones explícitas para los usuarios sobre cómo solicitar que se eliminen sus datos. Planeamos aplicar este requisito a partir del 10 de noviembre de 2022, y se lo recordaremos a los desarrolladores de apps 60 días antes de que se haga efectivo.

Opciones de cambios de la API Graph de las estadísticas de anuncios para el proyecto de reducción de las retenciones

La UI del administrador de anuncios dejará de informar datos de las métricas de las estadísticas de anuncios anteriores a 37 meses. La API devolverá un error cuando la solicitud contenga intervalos de fechas que excedan los 37 meses. Deshabilitaremos "date_preset = lifetime" y la reemplazaremos por "date_preset = maximum".

Se aplicarán los cambios de la versión 10.0 de la API Graph a las estadísticas de anuncios a todas las demás versiones de la API Graph después de 90 días, con excepción de "date_preset = lifetime". No es necesario cambiar el campo específico que se llamó. La funcionalidad estará preestablecida y todas las llamadas "a largo plazo" tendrán una retención predeterminada de 37 meses como máximo.

Este cambio no afectará los datos relacionados con los contenidos de los anuncios, las audiencias, la configuración de la entrega ni los nombres del objeto del anuncio; tampoco se modificará el cálculo de las métricas existentes. Solo se aplicará este cambio a todos los espacios de creación de informes publicitarios, incluso al administrador de anuncios, a los informes publicitarios y a las experiencias publicitarias ligeras.

• Fecha de lanzamiento 23/02/2021:
  • Versión 10.0
    • Habilitar "date_preset = maximum"
    • Deshabilitar "date_preset = lifetime"
    • Se devuelve un error cuando la solicitud contiene intervalos de fechas explícitos que superan la retención de 37 meses
  • Versión 9.0 y anteriores
    • No se modifica la funcionalidad actual
• 90 días después del lanzamiento: 24/05/2021:
  • Versión 9.0 y anteriores
    • Habilitar "date_preset = maximum" (al igual que en la versión actual)
    • Se devuelve un error cuando la solicitud contiene intervalos de fechas explícitos que superan la retención de 37 meses (al igual que la versión nueva)
    • "date_preset = lifetime" puede seguir funcionando, pero solo devuelve datos dentro de un período de 37 meses, es decir, funciona como el 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 para datos propios externos en ThreatExchange

A partir del 24 de mayo de 2021, cuando los socios establezcan una "expire_time" en los datos que carguen a ThreatExchange, "eliminaremos permanentemente" los datos en la fecha indicada. Si deseas indicar que los datos no son más válidos, configura el campo "expired_on" para que se eliminen de manera automática.

Antes, al "eliminar temporalmente" los datos, nos referíamos a que etiquetábamos el contenido caducado como tal. Ya no admitimos las eliminaciones temporales; una vez que un contenido caduca, se eliminará de manera permanente y se dejará de ver en ThreatExchange.

A su vez, todos los ThreatDescriptors de ThreatExchange que no sean de Facebook se eliminarán de forma permanente una vez que caduquen. El creador del ThreatDescriptors seguirá siendo quien configure el tiempo de caducidad. La eliminación comenzará en todos los ThreatDescriptors caducados que no creó Facebook. Si en tu aplicación hay actualmente ThreatDescriptors que no deseas eliminar una vez que entre en vigencia esta política, debes extender la fecha de caducidad o fijarla 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 en una API nueva

El 24 de mayo de 2021, no solicitaremos más parámetros de ubicación de país ni "location_spec" cuando se cree un público similar personalizado en ninguna versión de la API.

Al crear un público similar, el usuario selecciona la fuente similar y la proporción deseada. La ubicación del país definirá la ubicación para los públicos similares al especificar la segmentación de la campaña. Este cambio no afecta a las campañas existentes; solo tendrá efecto en las campañas nuevas y editadas.

Lanzar una nueva página con Platform Live Status

La nueva página de estado comercial de Facebook aumentará la transparencia y la comunicación proactiva con los desarrolladores externos que utilizan los productos de la plataforma de Facebook. Esta página brindará un lugar centralizado en el que se podrá verificar el estado de la plataforma de los productos comerciales de Facebook (anuncios, API de WhatsApp Business, plataforma para desarrolladores de Facebook, etc.). Esta página se encuentra disponible para el administrador de anuncios y la API de WhatsApp Business; se agregarán productos comerciales adicionales hasta mayo de 2021.

Obsolescencia

Elementos obsoletos del cuadro de diálogo de transmisión en vivo

El 24 de mayo de 2021 quedará obsoleto el SDK del cuadro de diálogo de transmisión en vivo (GLD). Este elemento de la versión anterior de la herramienta de producción en vivo quedará obsoleto en todas las versiones de la API. El cambio solo tendrá efecto en la transmisión en vivo en Facebook. Les recomendamos a los desarrolladores que usen el Live Producer y la Live API para obtener todas las soluciones de producciones en vivo mencionadas.

Soluciones para transmitir en vivo una vez que el SDK del GLD quede obsoleto:

• Accede directamente al Live Producer a través de facebook.com/live/producer (u otros puntos de entrada en Facebook como el botón "Video en vivo" de una página o perfil)
• Integra alguna solución personalizada con la Live API

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

Obsolescencia de la segmentación por conexiones

El 24 de mayo de 2021, no se admitirá más la segmentación por conexiones cuando se cree o edite un conjunto de anuncios. Este requisito solo tendrá efecto en las campañas nuevas y editadas; no afecta a las campañas existentes.

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

Rehabilitaciones

Punto de conexión rehabilitado gr:delete:Page/tabs

Cuando lanzamos la versión 8.0 de la API Graph, dejamos obsoleto el punto de conexión gr:delete:Page/tabs para las pestañas de las páginas. Decidimos rehabilitar este punto de conexión con efecto inmediato para la versión 10.0 de la API Graph. El 24 de mayo de 2021 volveremos a permitir acceder a esta interfaz en todas las demás versiones de Graph.

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

Puntos de conexión rehabilitados 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 puntos de conexión comerciales:

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

Al momento de lanzar la versión 10.0 de Graph, volveremos a abrir estos puntos de conexión a las llamadas de la API cuando las apps cumplan alguna de estas dos condiciones:

• El negocio de destino es el propietario de la app que realiza la llamada
• El negocio de destino es secundario (en un modelo comercial de dos niveles) del negocio propietario que realiza la llamada

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

Calendario de ítems pendientes

Elementos obsoletos de la versión de la API de marketing:

Como parte de nuestro cronograma de lanzamiento de versiones de la API de marketing, ten en cuenta los elementos que quedarán obsoletos en la próxima versión de la API de marketing:

• 3 de marzo de 2021: Quedará obsoleta la versión 7.0 de la API de marketing y se la eliminará de la plataforma
• 4 de mayo de 2021: Quedará obsoleta la versión 8.0 de la API de marketing y se la eliminará de la plataforma
• 25 de agosto de 2021: Quedará obsoleta la versión 9.0 de la API de marketing y se la eliminará de la plataforma

Para evitar interrupciones en tu negocio, te recomendamos que migres todas las llamadas a la última versión de la API de marketing que lanzamos hoy. (Visita el registro de cambios para obtener más información).

Elementos obsoletos de la versión de la API Graph:

Como parte de nuestro cronograma de lanzamiento de versiones, ten en cuenta los elementos que se mencionan a continuación y que quedarán obsoletos en la próxima versión de la API Graph:

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

Elementos obsoletos generales

• 24 de mayo de 2021:
  • Quedará obsoleto el cuadro de diálogo de transmisión en vivo y se lo eliminará de la plataforma
  • La segmentación por conexiones quedará obsoleta y se la eliminará de la plataforma

Se requiere una acción de los desarrolladores

• Realizar la inscripción: Certificado de comprobación de uso de datos
  • Después de registrarte, es necesario finalizar el proceso dentro de los 60 días
  • Sección de preguntas frecuentes dedicada a la DUC.
• 23 de febrero de 2021: Lanzamiento solo de los cambios de la API Graph de las estadísticas de anuncios solo para la versión 10.0
• 24 de mayo de 2021:
  • Lanzamiento de los cambios de la versión 9.0 y anteriores de la API Graph de las estadísticas de anuncios
  • Se comienzan a aplicar los cambios en los niveles de acceso basados en la revisión de apps
    • Límite de 90 días al acceso a los datos de la API de grupos
    • Se implementaron niveles de datos por niveles de la API de grupos
    • Se comienzan a aplicar los cambios a "public_profile" y a los permisos de correo electrónico para las apps de negocios
  • Se implementó una nueva política de "eliminación permanente" de datos en ThreatExchange
• 10 de noviembre de 2022: La eliminación de datos requiere fecha limite