Cuadro de diálogo de noticias

Puedes agregar el cuadro de diálogo de noticias, de modo tal que los usuarios puedan publicar historias con comentarios en sus biografías.

Para compartir historias mediante el cuadro de diálogo de noticias, no es necesario solicitar permisos ampliados.

Integración

Este cuadro de diálogo puede utilizarse con los SDK de Facebook para JavaScript, iOS y Android, así como mediante un redireccionamiento completo a una URL. A continuación, se muestran algunos ejemplos de fragmentos de códigos que se pueden usar para desencadenar este cuadro de diálogo.

JavaScript

Para abrir el cuadro de diálogo de noticias, llama a la función FB.ui y utiliza el valor feed en el parámetro method.

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

Consulta nuestra guía sobre el cuadro de diálogo para compartir para iOS, que también te permite publicar historias de Open Graph.

Android

Obtén información sobre nuestro cuadro de diálogo de contenido compartido para Android, que también te permite publicar historias de Open Graph.

Redireccionamiento de URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

Nota

Si una persona tiene el ajuste "¿Quién puede publicar en tu biografía?" establecido en "Solo yo" y otra persona intenta realizar una publicación en la biografía de la primera con el cuadro de diálogo de noticias, se mostrará el error "No se puede publicar".

Parámetros

Nota: Cuando una app comparte enlaces a iTunes o Google Play, o a un perfil o página de Facebook, no publicamos las imágenes ni las descripciones que se especifican con el contenido compartido mediante los parámetros que figuran a continuación. Publicamos información sobre la app que extraemos directamente de la tienda de apps o de la página de Facebook mediante WebCrawler. Es posible que no incluya imágenes. Para obtener una vista previa del contenido compartido mediante enlace a iTunes o Google Play, especifica la URL en el depurador de contenido compartido.

Parámetro	Descripción
`app_id`	Identificador único de tu app. Obligatorio.
`redirect_uri`	La URL a la que se redirigirá cuando una persona hace clic en un botón del cuadro de diálogo. Obligatorio si se utiliza el redireccionamiento de URL.
`display`	Determina cómo se muestra el cuadro de diálogo. Si utilizas la implementación del cuadro de diálogo de redireccionamiento de URL, se mostrará la página completa dentro de Facebook.com. Este tipo de visualización se denomina `page`. Si utilizas el SDK de Facebook para iOS o Android para invocar el cuadro de diálogo, se detecta automáticamente y elige el tipo de visualización adecuado para el dispositivo. Si utilizas el SDK de Facebook para JavaScript, se adoptará de forma predeterminada el tipo `iframe` modal en el caso de las personas que inicien sesión en tu app, o el tipo `async` si utilizan un juego en Facebook.com, y una ventana `popup` en todos los demás casos. También puedes forzar los tipos `popup` o `page`cuando usas el SDK de Facebook para Javascript, en caso de ser necesario. Las apps web para celulares tomarán siempre como valor predeterminado el tipo de visualización `touch`.
`from`	Identificador de la persona que publica el mensaje. Si no se especifica, tomará como valor predeterminado a la persona actual. Si se especifica, debe ser el identificador de la persona o de una página que esta administre.
`to`	Identificador del perfil en el que se va a publicar esta historia. Si no se especifica, toma de forma predeterminada el valor de `from`. El identificador debe ser un amigo que también utilice tu app.
`link`	Enlace adjunto a la publicación.
`source`	URL de un archivo multimedia (SWF o MP3) adjunto a la publicación. Si se trata de un archivo SWF, también debes especificar `picture` con el fin de proporcionar la miniatura del video.
`ref`	Este argumento es una lista de valores separados por comas, que consta, como máximo, de cinco elementos distintos, cada uno con una longitud mínima de un carácter y una longitud máxima de 15 caracteres, extraídos del conjunto "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_". Cada categoría se utiliza en las estadísticas de Facebook para ayudarte a medir el rendimiento de diferentes tipos de publicación

Parámetros obsoletos

Parámetro	Descripción
`post_id`	El identificador de la historia publicada si la persona optó por publicarla en su biografía.
`properties`	Objeto JSON de pares clave-valor que aparecerá en el adjunto de la secuencia debajo de la descripción, con cada propiedad en su propia línea. Las claves deben ser cadenas, mientras que los valores pueden ser cadenas u objetos JSON con las claves `text` y `href`.
`actions`	Matriz JSON con un único objeto que describe el enlace de acción que aparecerá junto a los enlaces "Comentar" y "Me gusta" debajo de publicaciones. El objeto contenido debe tener las claves `name` y `link`.
`picture`	URL de una imagen adjunta a la publicación. La imagen debe tener una resolución mínima de 200 × 200 píxeles. Para obtener más información sobre los tamaños, consulta nuestras prácticas recomendadas sobre funciones para compartir.
`name`	Nombre del adjunto del enlace.
`caption`	Leyenda del enlace (aparece debajo del nombre del enlace). Si no se especifica, este campo se completa automáticamente con la URL del enlace.
`description`	Descripción del enlace (aparece debajo de la leyenda). Si no se especifica, este campo se completa automáticamente con información extraída del enlace, por lo general, el título de la página.
`thumbnail`	El archivo de imagen local que se subió, `.jpg.jpeg.gif` o `.png`.