Historias de Open Graph

Publica historias atractivas y estructuradas desde tu aplicación utilizando 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 o aplicación web.

Cómo funciona

Las personas utilizan las historias para compartir lo que hacen, con quién y dónde. Permite que las personas 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 de contenido compartido, no es necesario implementar el inicio de sesión con Facebook ni solicitar otros permisos. Para obtener más información, consulta Cuadro de diálogo de contenido compartido.

Si creas una interfaz de usuario para compartir personalizada con el objetivo 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 la aplicación. También tendrás que enviar tu aplicación a revisión (consulta Revisión del inicio de sesión). Con estos dos pasos te asegurarás de que las personas que utilicen tu aplicación sean conscientes de que van a compartir contenido, lo que mejora la calidad de la experiencia.

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

  • Actor: persona que publica la historia.

  • Aplicación: las historias especifican la aplicación con la que se han creado.

  • 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 sustituir este nivel predeterminado por otros más restrictivos, pero no más abiertos.

Uso de 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 el destino de las acciones de tus historias. Los objetos pueden utilizarse de dos formas distintas: pueden ser autohospedados (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 la acción de compartir para proporcionar una experiencia lo más atractiva posible.

Referencia

Documentación de referencia de Open Graph.

Las historias personalizadas de Open Graph se han retirado en la versión 2.8 de la API Graph. La versión 2.7 y anteriores de la API Graph admitirán historias personalizadas de Open Graph hasta las siguientes fechas:

  • A partir de enero del 2017, dejarán de ser compatibles con la creación de nuevos objetos.
  • A partir de octubre del 2017, dejarán de ser compatibles con la publicación de objetos existentes.

Crear historias personalizadas de Open Graph

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