动态发布对话框

您可以向应用添加“动态发布对话框”,以便用户在其时间线上发布带有评论的个人动态。

通过“动态发布对话框”分享动态时,不需要申请任何扩展权限。

集成

此对话框可通过执行网址的全页重定向,与 JavaScript 版、iOS 版和 Android 版 Facebook SDK 配合使用。以下是一些可用于触发此对话框的代码片段示例。

JavaScript

如要触发“动态发布对话框”,请调用函数 FB.ui 并将值 feed 用于 method 参数。

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

iOS

请阅读 iOS 分享对话框指南,该指南同样支持您发布开放图谱动态。

Android

请阅读 Android 分享对话框指南,该指南同样支持您发布开放图谱动态。

网址重定向

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

请注意

如果用户将“谁能在你的时间线上发帖?”设置设为“仅我自己”,但另一用户尝试使用“动态发布对话框”在第一位用户的时间线上发布帖子,则将显示“无法发帖”错误。

参数

注意:如果您的应用分享的是 iTunes 或 Google Play 商店,或是 Facebook 个人主页或公共主页的链接,我们不会发布您在分享中指定的任何图片或说明,而会发布通过网络爬虫直接从应用商店或 Facebook 公共主页抓取的一些应用信息,其中可能不包括图像。要预览 iTunes 或 Google Play 的链接分享,请将网址输入到分享调试器

参数 说明

app_id

应用的唯一标识符。这是必备参数。

redirect_uri

用户点击对话框中的按钮后重新定向到此网址。使用网址重定向时是必备参数。

display

决定着对话框呈现方式。

  • 如果要使用网址重定向对话框实施方案,则对话框会在 Facebook.com 内全页显示。这种显示类型称为 page
  • 如果要用 iOS 或 Android 版 Facebook SDK 调用对话框,则会自动指定此参数,从而为设备选择相应显示类型。
  • 如果要使用 Facebook SDK for Javascript,则对于已登录到应用中的用户,此参数的默认类型为模式 iframe 类型;在 Facebook.com 中的游戏内使用时,此参数的默认类型为 async;对于其他用户,此参数的默认类型为 popup 窗口。使用 Facebook SDK for Javascript 时,如有必要,也可强制使用 popuppage 类型。
  • 移动 Web 应用的默认显示类型始终都是 touch

from

发布消息的用户编号。如果未指定用户编号,则默认为当前用户。如果已指定,编号必须为用户编号或用户管理的公共主页编号。

to

将向其发布此动态的个人主页编号。如果未指定用户编号,则默认为 from 的值。该编号必须是也在使用您应用的好友的编号。

link

此帖子所附的链接。

source

此帖子所附多媒体素材文件(SWF 或 MP3)的网址。如果是 SWF,您还必须指定 picture,以提供视频的缩略图。

ref

此参数是一个逗号分隔列表,最多由 5 种不同内容组成,每个内容长度最少为 1 个字符,最多为 15 个字符(字符从“0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_”集合中抽取)。Facebook 成效分析中使用的各个类别有助于您衡量不同类型的帖子的成效

已停用的参数

参数 说明

post_id

如果用户选择向其时间线发布内容,则此编号为发布的动态编号。

properties

键/值对的 JSON 对象,该对象显示在描述下方的投射视频附件中,且每个属性都有自己的行。键必须是字符串,而值可以是字符串,也可以是含有 texthref 键的 JSON 对象。

actions

一个 JSON 数组,其中包含一个用于描述操作链接的对象,该数组显示在帖子下方的“评论”和“赞”链接旁。包含的对象必须具有键 namelink

picture

此帖子所附图片的网址。图片至少应为 200 x 200 像素。有关尺寸的更多信息,请参阅分享最佳实践上的文档。

name

链接附件的名称。

caption

链接的文字(在链接名称下方显示)。如果未指定,会使用此链接网址自动填充此字段。

description

链接的说明(在链接文字下方显示)。如果未指定,此字段会自动填充从链接获取的信息,通常为页面的标题。

thumbnail

已上载的本地图片文件,格式可为 .jpg.jpeg.gif.png