版本 2.5

图谱 API | 市场营销 API

图谱 API v2.5

发布日期 2015 年 10 月 7 日 | 停用日期 2018 年 4 月 12 日

新功能

• 公共主页
• 视频

公共主页

• 权限

  • GET {user_id}/accounts 现在需要 manage_pages 或 pages_show_list（这是 v2.5 推出的一项新权限）。
  • POST {page_id}/call_to_actions 和 POST/DELETE {call-to-action-id} 需要我们在 v2.5 中推出的新权限 pages_manage_cta。

• 管理行动号召 - 公共主页可以管理位于该公共主页上的行动号召：

  • 使用 GET page/call_to_actions 或 GET {call-to-action-id} 可以读取行动号召。
  • 使用 POST page/call_to_actions 可以将行动号召添加到公共主页。
  • 使用 POST {call-to-action-id} 可以更新行动号召。
  • 使用 DELETE {call-to-action-id} 可以删除公共主页上的行动号召。

• Place 节点 - 已将以下字段添加到 Place 节点：

  • overall_rating - 此字段根据特定地点的大众点评提供平均评分。

视频

• 视频上传 - 已添加以下参数：

  • slideshow_spec - 通过上传图片生成幻灯片放映视频。
  • secret - 所发布的视频不会出现在 Facebook 动态消息、时间线或公共主页视频选项卡上，也不会出现在搜索结果中。只能用固定链接查看和分享视频。仅适用于公共主页用户。
  • social_actions - 允许或禁止使用 Facebook 社交操作，例如对隐藏视频点赞、评论和分享。仅适用于公共主页用户。

• 视频编辑 - 已添加以下参数：

  • publish_to_videos_tab - 将视频项目公开发布到公共主页的视频选项卡，但不发布到动态消息或时间线。
  • publish_to_news_feed - 将视频项目公开发布到动态消息、公共主页时间线和公共主页的视频选项卡。

变更

• 公共主页
• 帖子
• 用户
• Webhooks

公共主页

• 标记帖端点 - GET /{page-id}/tagged 将包括所有标记了公共主页的公开帖。需要拥有 manage_pages 权限的公共主页访问口令。

帖子

• story_tags - 现在会返回数组，而不是对象。

用户

• GET /{user-id}?fields=address 返回错误 - address 字段是在之前的版本中推出，会返回空值。但是从 v2.5 开始，此字段会返回错误。

Webhooks（之前称为“实时更新”）

• 自动禁用订阅 - 现在，如果回调网址连续 7 天失败，系统会自动禁用 Webhooks 订阅。您可以向 /subscriptions 发送 POST 请求，重新启用相关订阅。此变更不适用于支付订阅。

• 更新现有订阅 - 可以通过 /subscriptions API 修改已有的 Webhooks 订阅。POST /subscriptions 会修改给定主题的订阅，但不会覆盖已有字段。您可以在调用 DELETE /subscriptions 时加入 fields 参数，以便从订阅中删除特定字段。

停用内容

• 无停用内容。

90 天重大变更

• 公共主页
• Webhooks

公共主页

• 公共主页选项卡应用 URI 格式 - 此次发布的 90 天后，公共主页选项卡应用 URI 格式 https://www.facebook.com/{vanity}?v={app_id} 将不再有效。请使用 https://www.facebook.com/{vanity}?sk={app_id} 或 https://www.facebook.com/{vanity}/{app_id}。

Webhooks

• 仅使用 HTTPS 的新实时更新 - 必须使用 HTTPS 回调网址才能新建订阅。此变更会影响 User、Page、App 以及 Payment 更新。