API Graph

Versión 2.5

API Graph | API de marketing

API Graph v2.5

Fecha de lanzamiento: 7 de octubre de 2015 | Disponible hasta: 12 de abril de 2018

Esta versión caducó el 12 de abril de 2018. Utiliza la herramienta de actualización de la API para actualizar tus aplicaciones antes de esta fecha. Encontrarás más información sobre la actualización de aplicaciones en la guía de actualización.

Nuevas funciones

Páginas

  • Permisos

    • La solicitud GET {user_id}/accounts ahora requiere el permiso manage_pages o pages_show_list, este último es un permiso nuevo incorporado en la versión 2.5.
    • Las solicitudes POST {page_id}/call_to_actions y POST/DELETE {call-to-action-id} requieren el nuevo permiso pages_manage_cta que incorporamos en la versión 2.5.

  • Administración de llamadas a la acción: las páginas ahora pueden administrar llamadas a la acción en las páginas con las siguientes solicitudes:

    • GET page/call_to_actions o GET {call-to-action-id} para leer una llamada a la acción.
    • POST page/call_to_actions para añadir una llamada a la acción a una página.
    • POST {call-to-action-id} para actualizar.
    • DELETE {call-to-action-id} para eliminar la llamada a la acción de una página.

  • Nodo Place: se ha añadido el siguiente campo al nodo Place:

    • overall_rating: este campo proporciona la calificación media a partir de las opiniones públicas de un lugar.

Vídeos

  • Carga de vídeo: se han añadido los siguientes parámetros:

    • slideshow_spec: sube imágenes para generar vídeos de presentación.
    • secret: el vídeo publicado no aparecerá ni en el feed, ni en la biografía, ni en la pestaña Vídeos de la página de Facebook, ni tampoco se podrá buscar. Los vídeos solamente se podrán ver y compartir utilizando un enlace permanente. Solo disponible para usuarios de páginas.
    • social_actions: activa o prohíbe el uso de acciones sociales de Facebook, como comentar o compartir contenido en un vídeo oculto, o la posibilidad de que los usuarios indiquen que les gusta. Solo disponible para usuarios de páginas.

  • Edición de vídeo: se han añadido los siguientes parámetros:

    • publish_to_videos_tab: distribuye elementos de vídeo públicamente en la pestaña Vídeos de la página, pero no en el feed ni en la biografía.
    • publish_to_news_feed: distribuye elementos de vídeo públicamente en el feed y en la biografía y la pestaña Vídeos de la página.

Cambios

Páginas

  • Extremo de publicaciones etiquetadas: GET /{page-id}/tagged incluirá todas las publicaciones públicas en las que se haya etiquetado la página. Es obligatorio tener un identificador de acceso a la página con el permiso manage_pages.

Publicaciones

  • story_tags: ahora devuelve una matriz en lugar de un objeto.

Usuarios

  • La solicitud GET /{user-id}?fields=address devuelve un error: el campo address, que estaba disponible en las versiones anteriores y devolvía un valor vacío, devolverá un error a partir de la versión 2.5.

Webhooks (denominados anteriormente “actualizaciones en tiempo real”)

  • Inhabilitación automática de suscripciones: ahora inhabilitamos automáticamente las suscripciones a webhooks si la URL de devolución de llamada genera errores durante siete días consecutivos. Puedes volver a activarlas mediante una solicitud POST a /subscriptions. Este cambio no se aplica a las suscripciones de pago.

  • Actualización de suscripciones existentes: las suscripciones existentes a webhooks se pueden modificar mediante la API de /subscriptions. La solicitud POST /subscriptions modificará la suscripción del tema en concreto sin sobrescribir los campos existentes. Puedes eliminar campos concretos de tu suscripción; para ello, incluye un parámetro “fields” al llamar a DELETE /subscriptions.

Retiradas

  • No hay retiradas.

Cambios de los últimos 90 días

Páginas

  • Formato de URI de aplicaciones de pestaña de la página: el formato https://www.facebook.com/{vanity}?v={app_id} de los URI de aplicaciones de pestaña de la página dejará de funcionar 90 días después de este lanzamiento. En su lugar, utiliza https://www.facebook.com/{vanity}?sk={app_id} o https://www.facebook.com/{vanity}/{app_id}.

Webhooks

  • Nuevas actualizaciones en tiempo real solo mediante HTTPS: no se pueden crear nuevas suscripciones con una URL de devolución de llamada que no sea HTTPS. Esta restricción afecta a las actualizaciones de User, Page, App y Payment.