Historias de Open Graph

Publica historias con contenido enriquecido y estructurado desde tu aplicación mediante una API fuertemente tipada.

Historias de Open Graph en iOS Publica historias de Open Graph desde tu aplicación para iOS.

Historias de Open Graph en Android Publica historias de Open Graph desde tu aplicación para Android.

Historias de Open Graph en la web Publica historias de Open Graph desde tu sitio web o aplicación web.

Cómo funciona

Las personas utilizan las historias para compartir lo que hacen, con quién lo hacen y los lugares donde lo hacen. Permite que los usuarios compartan historias en Facebook sobre tu aplicación mediante una API estructurada y fuertemente tipada.

Para publicar historias de Open Graph mediante el cuadro de diálogo para compartir, no es necesario que implementes el inicio de sesión con Facebook ni que pidas otros permisos. Para obtener más información, consulta Cuadro de diálogo para compartir.

Si creas una interfaz de usuario para compartir personalizada con el fin de publicar historias de Open Graph, tendrás que implementar el inicio de sesión con Facebook y solicitar el permiso publish_actions a las personas que utilicen tu aplicación. También tendrás que enviar tu aplicación para su revisión (consulta Revisión del inicio de sesión). Mediante estos dos pasos, te asegurarás de que las personas que utilicen tu aplicación sean conscientes de la acción que van a realizar al compartir y proporcionarás una experiencia de gran calidad.

Las historias de Open Graph tienen cuatro elementos básicos:

  • Actor: persona que publica la historia

  • Aplicación: cada historia especifica la aplicación que la creó

  • Acción: actividad que lleva a cabo el actor

  • Objeto: elemento con el que interactúa el actor

Privacidad

Cuando configuras una acción, debes determinar el nivel predeterminado de privacidad. Las personas que utilicen la aplicación pueden optar por sustituir este nivel predeterminado por otros más restrictivos, pero no más abiertos.

Usar acciones

Las acciones son los verbos o las cosas que pueden hacer las personas en tu aplicación y publicar como historias. Las acciones se publican, recuperan y modifican mediante la API Graph.

Usar objetos

Los objetos son los sustantivos o los destinos de las acciones de tus historias. Los objetos pueden utilizarse de dos formas distintas: pueden ser autoalojados (representados mediante marcado HTML en una página web) o crearse utilizando la API de objetos.

Prácticas recomendadas

Consulta nuestras prácticas recomendadas sobre el uso compartido con el fin de proporcionar una experiencia lo más atractiva posible.

Referencias

Documentación de referencia de Open Graph.

Las historias personalizadas de Open Graph quedan obsoletas en la versión 2.8 de la API Graph. La versión 2.7 y las versiones anteriores de la API Graph admitirán historias de Open Graph personalizadas de acuerdo con el siguiente calendario:

  • La compatibilidad para la creación de nuevos objetos finalizará en enero de 2017.
  • La compatibilidad para la publicación de objetos existentes finalizará en octubre de 2017.

Crear historias personalizadas de Open Graph

Las historias se componen de acciones y objetos. Aunque Facebook definió un conjunto de acciones y objetos comunes, puedes crear los tuyos propios.