概覽

影片 API 由一系列 Graph API 端點組成,讓應用程式可以在應用程式用戶管理的專頁群組上發佈現有影片。

組件

託管網址

  • https://graph-video.facebook.com — 專用於在專頁和群組上發佈影片。
  • https://graph.facebook.com — 用於任何其他操作(建立投票活動、獲取洞察報告等)。

上載協定

API 支援可恢復不可恢復的上載協定。可恢復的上載協定用於按順序上載影片區塊,不可恢復的上載協定則用於上載完整影片。我們建議使用可恢復的上載協定,此協定支援更大的影片檔案,並讓您可以有效率地應對連線中斷問題。

資源

此 API 使用以下節點。

影片

影片節點是此 API 的主要資源。當您上載現有影片時,API 會建立一個影片實體並將其發佈到專頁群組上,具體取決於您在開始發佈程序時將哪個節點定為目標。影片必須發佈到目標節點上。

專頁

只要應用程式擁有相應的權限功能,影片就可以發佈到群組上。此外,應用程式用戶必須可以在專頁上執行管理員級別的任務,或已透過企業管理平台獲授予專頁的管理員角色

群組

只要應用程式擁有相應的權限功能,而且應用程式用戶為群組管理員,影片就可以發佈到群組上。

多重發佈影片

應用程式用戶可以將已發佈的影片發佈到其管理的其他專頁上,無需重新上載影片。多重發佈影片的洞察報告可以透過彙總數值的方式傳回(例如所有專頁的全部瀏覽次數總和),也可以按專頁細分。

微影片

您可以使用此 API,將託管在公開伺服器上的一系列圖像建立為微影片

投票活動

您可以使用此 API 為已發佈的影片建立投票活動,並獲取相關投票活動的結果。

廣告

您可以將已發佈的影片與推廣 API 的廣告創意端點結合使用,以建立影片廣告。

洞察報告

您可以獲取任何已發佈影片的洞察報告多重發佈影片的洞察報告可以透過彙總數值的方式傳回,也可以按專頁細分。

Webhooks

您可以為在專頁上發佈的影片設定專頁 Webhooks,以獲取關於影片發佈狀態變更和觀眾互動的即時通知。設定回調,然後訂閱專頁主題的 feedvideos 欄位,即可獲取通知。請注意,系統不會為以 secretno_story 方式上載的影片傳送通知。

權限管理

您可以為在專頁上發佈的影片使用權限管理 API,以建立和套用版權規則,從而發現並舉報可能違反規則的其他已發佈影片。

必要條件

權限

如要在專頁上發佈影片,應用程式用戶必須向您的應用程式授予 pages_show_listpages_read_engagementpages_manage_posts 權限。

如要在群組上發佈影片,應用程式用戶必須向您的應用程式授予 publish_to_groups 權限。

功能

在專頁上發佈影片無需任何功能。如要在群組上發佈影片,您的應用程式必須獲准使用群組 API 功能。

管理員角色

應用程式用戶必須可以在目標專頁上執行 ADMIN 等級的任務,或者為目標群組的管理員。

應用程式審查

所有權限和功能都需要通過應用程式審查

運作方式

在專頁或群組上發佈影片的一般流程如下:

  1. 從應用程式用戶獲取存取憑證和相應的權限。
  2. 根據應用程式用戶可以在當中執行管理員等級任務的專頁或群組,獲取相關的專頁或群組清單。
  3. 為應用程式用戶提供選擇方式,讓他們選擇希望將影片發佈至哪一個專頁或群組上。
  4. 為應用程式用戶提供選擇方式,讓他們選擇要發佈的影片。
  5. 將影片分割為較小的區塊。
  6. 發起上載作業階段以上載各區塊。
  7. 結束上載作業階段。