第 2.5 版

圖形 API | 行銷 API

圖形 API 第 2.5 版

發佈日期：2015 年 10 月 7 日 | 有效期限：2018 年 4 月 12 日

新功能

• 粉絲專頁
• 影片

粉絲專頁

• 權限

  • GET {user_id}/accounts 現在需要 manage_pages 或 pages_show_list 權限才可使用；後者是第 2.5 版推出的新權限。
  • POST {page_id}/call_to_actions 和 POST/DELETE {call-to-action-id} 需要第 2.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 節點已新增以下欄位：

  • 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 欄位在舊版中會傳回空值，自第 2.5 版起會傳回錯誤。

Webhooks（前身為即時更新）

• 自動停用訂閱 - 如果回呼網址連續 7 天無法使用，我們現在會自動停用 Webhooks 訂閱。您可向 /subscriptions 發出 POST 要求以重新啟用。此變更不適用於付費訂閱。

• 更新現有訂閱 - 現有 Webhooks 訂閱可經由 /subscriptions API 修改。POST /subscriptions 將修訂指定主題的訂閱，而不需覆寫現有欄位。您可以在呼叫 DELETE /subscriptions 時加入欄位參數，便可從訂閱中刪除特定欄位。

停用項目

• 沒有停用項目。

90 天期限重大變更

• 粉絲專頁
• Webhooks

粉絲專頁

• 粉絲專頁頁籤應用程式 URI 格式 - 粉絲專頁頁籤應用程式 URI 格式 https://www.facebook.com/{vanity}?v={app_id} 在此版本推出 90 天之後即不再使用。請使用 https://www.facebook.com/{vanity}?sk={app_id} 或 https://www.facebook.com/{vanity}/{app_id}。

Webhooks

• 僅透過 HTTPS 進行新的即時更新 - 新的訂閱不能透過非 HTTPS 回呼網址建立。這會影響 User、Page、App 和 Payment 更新。