Durante la F8 se publicó la versión 3.0 de la API Graph. Los cambios se clasifican de la siguiente manera:

  • Nuevas funcionalidades: los nuevos productos o servicios, incluidos los nuevos nodos, perímetros y campos.
  • Cambios: los cambios a los productos o servicios existentes (no incluyen los elementos obsoletos).
  • Elementos obsoletos: los productos o servicios existentes que se van a eliminar.
  • Cambios radicales en 90 días: los cambios y los elementos obsoletos que entrarán en vigor 90 días después de la fecha de lanzamiento de la versión.

Las nuevas funciones, los cambios y los elementos eliminados solo afectan a esta versión. Los cambios radicales en 90 días afectan a todas las versiones.

Los cambios radicales no se incluyen aquí, ya que no están vinculados a lanzamientos específicos.


Nuevas funcionalidades

  • Transparencia de Certificados
  • Revisión de Aplicaciones
  • API de Páginas
Transparencia de Certificados

La Transparencia de Certificados es un framework que permite identificar certificados TLS emitidos incorrectamente y los posibles dominios de phishing para que pueda revocar sus certificados.

En resumen, La API te permitirá hacer seguimientos a los Certificados SSL/TLS de dominios que tengas en tu control, de esta manera recibirás notificaciones cuando ocurra algún incidente, como por ejemplo, que alguien utilice tu Certificado para realizar Phising a los usuarios de tus Apps en Facebook.

Más información sobre la Transparencia de Certificados y como utilizarlo.

Revisión de aplicaciones
API de Páginas
  • Page-Scoped ID API — El pasado 24 de Abril, se anunció que la API de Páginas retornará Page-scoped User IDs (PSID) en vez de App-scoped User IDs (ASID). Hemos publicado una nueva, no-versionada API para desarrolladores que necesiten pasar los IDs App-scoped a su equivalente Page-scoped ID.

Cambios

  • Revisión de Aplicación
  • Login de Facebook
  • Edge de Comentarios
  • Lectura de Edge y Fields
Revisión de Aplicación

Se han realizado cambios profundos en la Revisión de aplicaciones, entre ellos se han separado las aplicaciones en 3 grupos:

Aplicaciones que no requieren revisión

  • Plugins Sociales
  • Los productos de mediación de Facebook, como el diálogo de uso compartido de la web o los sheets de compartir en iOS o Android.
  • Login de Facebook, SÓLO para acceder al email, name, y profile photo del usuario.

Aplicaciones que requieren revisión

  • Login de Facebook, cuando se solicita información personal del usuario, tal como: birthday, location, hometown, gender, age range, o link to profile

Además, se debe aceptar los nuevos Términos de Incorporación al realizar la Revisión de Aplicación.

Aplicaciones que requieren revisión, verificación comercial y términos adicionales

  • Login de Facebook que deseen acceder a los siguientes datos del usuario friends, photos, tagged places, videos, events, managed groups, posts, o mobile phone
  • Pages API
  • Events API
  • Messenger Platform API
  • Instagram Graph API
  • Groups API
  • Business Manager API

Puedes revisar todos los cambios de la Revisión de Aplicación desde aquí.

Edge de Comentarios
  • Cuando se realizan lecturas con el access token del Usuario, el edge /comments retornará data vácia para los siguientes nodos:
Login de Facebook
  • Los siguientes default fields han reemplazado public_profile:
    • id
    • first_name
    • last_name
    • middle_name
    • name
    • name_format
    • picture
    • short_name

Como resultado, los siguientes campos que pertenecían a public_profile fueron eliminados:

    • age_range
    • context
    • cover
    • currency
    • devices
    • gender
    • link
    • locale
    • timezone
    • updated_time
    • verified
  • Cinco nuevos permisos han sido agregados:
Lectura de Edge y Campos
  • Los siguientes edges y campos cuando son leídos con el access token de Usuario retornará solo la información del propio usuario y sólo si es posible por su configuración de privacidad.
    Nodo Edges Campos
    Album from
    Photo /likes
    /reactions
    /tags
    /tags/tagging_user
    target
    Post /likes
    /reactions
    message_tags
    story
    to
    with_tags
    Video /likes
    /reactions
    /tags

Cambios radicales en 90 días

  • Todas las Apps
  • API Graph de Instagram
  • Insight de Páginas
  • Places Graph
Todas las Apps
  • Development Mode — Apps in development mode are now rate-limited to 200 calls per hour, per page-app pair, and can only access Users who have a role on the app (admin, developer, or tester).
  • Public Mode — Apps in public mode no longer allow their admins, developers, or testers to access permissions or features that normally require app review. This affects all apps built after May 1st, 2018, immediately. Apps built before then will not be affected until August 1st, 2018.
API Graph de Instagram
  • Business Verification — All apps must undergo Business Verification, which is part of the App Review process and now required for all Instagram Graph API endpoints. Apps previously reviewed before May 1st, 2018, have to be reviewed again, and have until August 1st, 2018 to do so, or lose access to the API.
Insight de Páginas
  • Sólo los valores diferentes a cero serán retornados por Page Insights breakdown metrics.
  • Métricas de participación en Page y Post Story, incluyendo metric usado con el campo de métrica, fue renombrado de stories a activity.
  • Métricas de participación en el consumo de post de Páginas, incluyendo metric usado con el campo de métrica, fue renombrado desde post_consumption* a post_clicks*.
  • GET /{page-id}/insights/{metric} – Las siguientes métricas serán eliminadas en 90 días:
    • page_story_adds
    • page_story_adds_by_age_gender_unique
    • page_story_adds_by_city_unique
    • page_story_adds_by_country_unique
    • page_views
    • page_views_unique
    • page_views_login
    • page_views_login_unique
  • GET /{post-id}/insights/{metric} – Las siguientes métricas serán eliminadas en 90 días:
    • post_story_adds_by_action_type
    • post_story_adds_by_action_type_unique
    • post_story_adds_unique
    • post_story_adds
    • post_fan_reach
    • post_interests_impressions
    • post_interests_impressions_unique
    • post_interests_consumptions
    • post_interests_consumptions_unique
    • post_interests_consumptions_by_type
    • post_interests_consumptions_by_type_unique
    • post_interests_action_by_type
    • post_interests_action_by_type_unique
Places Graph
  • Nuevo Place ID — endpoint de Places Graph ahora retornarán un tipo de Place ID. Por favor refierase a la documentación de Places Graph para saber más. Versiones antiguas de la API continuarán retornando el antiguo ID hasta el 1ero de Agosto de 2018.
  • /photos edge — El parámetro typepara el edge /photos (el cuál está disponible en varios nodos), ya no soportará uploaded como valor en operaciones GET (GET /object/photos?type=uploaded).

Para más información, puedes revisar la información oficial: