總覽

影片 API 為圖形 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. 結束上傳連線階段。