Cuadro de diálogo para publicar en la sección de noticias

Puedes añadir el cuadro de diálogo para publicar en la sección de noticias a tu aplicación de modo que las personas puedan publicar historias individuales con comentarios en su biografía.

Para compartir historias a través de un cuadro de diálogo para publicar en la sección de noticias no es necesario pedir permisos ampliados.

Integración

Este cuadro de diálogo se puede utilizar con los SDK de Facebook para Javascript, iOS y Android, y mediante la ejecución de un redireccionamiento completo a una URL. Aquí se muestran algunos fragmentos de código de ejemplo que se pueden utilizar para activar este cuadro de diálogo.

JavaScript

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

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

iOS

Lee nuestra guía del cuadro de diálogo de contenido compartido de iOS, que también permite publicar historias de Open Graph.

Android

Obtén información sobre nuestro cuadro de diálogo de contenido compartido de Android, que también 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 la opción "¿Quién puede publicar en tu biografía?" establecida en "Solo yo" y otra persona intenta realizar una publicación en la biografía de la primera mediante el cuadro de diálogo para publicar en la sección de noticias, se mostrará el error "No se puede publicar".

Parámetros

Nota: Si tu aplicación comparte enlaces con las tiendas de iTunes o Google Play, o con un perfil o una página de Facebook, no se publica ninguna imagen o descripción que especifiques en el contenido compartido con los parámetros siguientes. En su lugar, se publican algunos datos de la aplicación que se extraen de la tienda de aplicaciones o de la página de Facebook directamente con el rastreador web. Es posible que no se incluyan imágenes. Para obtener una vista previa del contenido compartido con un enlace a iTunes o Google Play, introduce la URL en el depurador de contenido compartido.

Parámetro	Descripción
`app_id`	El identificador único de la aplicación. Obligatorio.
`redirect_uri`	URL a la que redirigir cuando una persona hace clic en un botón del cuadro de diálogo. Obligatorio si se usa el redireccionamiento de URL.
`display`	Determina cómo se representa el cuadro de diálogo. Si estás usando la implementación del cuadro de diálogo de redireccionamiento de URL, la visualización será a página completa y se mostrará en Facebook.com. Este tipo de visualización recibe el nombre de `page`. Si estás usando el SDK de Facebook para iOS o Android para invocar el cuadro de diálogo, esto se especifica automáticamente y se elige un tipo de visualización adecuado para el dispositivo. Si estás usando Facebook SDK for Javascript, se usa de forma predeterminada un tipo `iframe` modal para los usuarios que han iniciado sesión en la aplicación o `async` cuando se usa en un juego en Facebook.com, y una ventana `popup` para todos los demás. También puedes forzar el tipo `popup` o `page` cuando usas Facebook SDK for Javascript, si es necesario. Las aplicaciones para web móvil siempre usan de forma predeterminada el tipo de visualización `touch`.
`from`	Identificador de la persona que publica el mensaje. Si no se especifica, se establece de forma predeterminada en la personal actual. Si se especifica, debe ser el identificador de la persona o de una página que esta administra.
`to`	Identificador del perfil en el que se publicará esta historia. Si no se especifica, se establece de forma predeterminada en el valor de `from`. El identificador debe ser un amigo que también utilice tu aplicación.
`link`	Enlace adjunto a la publicación.
`source`	URL de un archivo multimedia (SWF o MP3) adjunto a esta publicación. Si es SWF, también debes especificar `picture` para proporcionar una miniatura del vídeo.
`ref`	Este argumento es una lista separada por comas formada por un mínimo de 5 elementos diferentes, cada uno con una longitud mínima de 1 y máxima de 15 caracteres del conjunto "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_". Cada categoría se utiliza en Insights de Facebook para ayudarte a medir el rendimiento de distintos tipos de publicaciones.

Parámetros obsoletos

Parámetro	Descripción
`post_id`	Identificador de la historia publicada, si la persona ha elegido publicarla en su biografía.
`properties`	Objeto JSON de pares clave-valor que aparecerá en el archivo adjunto de la transmisión debajo de la descripción, con cada propiedad en su propia línea. Las claves deben ser cadenas, y los valores pueden ser cadenas u objetos JSON con las claves `text` y `href`.
`actions`	Matriz JSON que contiene un solo objeto que describe el enlace de la acción que aparecerá junto al enlace de "Comentario" y "Me gusta" bajo las publicaciones. El objeto incluido debe tener las claves `name` y `link`.
`picture`	URL de una imagen que se ha adjuntado a esta publicación. La imagen debe tener una resolución mínima de 200 × 200 píxeles. Consulta nuestra documentación sobre las prácticas recomendadas para el uso compartido a fin de obtener más información sobre los tamaños.
`name`	Nombre del archivo adjunto del enlace.
`caption`	Subtítulo del enlace (aparece bajo el nombre del enlace). Si no se especifica, este campo se rellena automáticamente con la URL del enlace.
`description`	Descripción del enlace (aparece debajo del texto del enlace). Si no se especifica, este campo se rellena automáticamente con información extraída del enlace (normalmente, el título de la página).
`thumbnail`	El archivo de imagen local cargado, `.jpg`, `.jpeg`, `.gif` o `.png`.