https://graph-video.facebook.com
— 專用於在專頁和群組上發佈影片。https://graph.facebook.com
— 用於任何其他操作(建立投票活動、獲取洞察報告等)。API 支援可恢復和不可恢復的上載協定。可恢復的上載協定用於按順序上載影片區塊,不可恢復的上載協定則用於上載完整影片。我們建議使用可恢復的上載協定,此協定支援更大的影片檔案,並讓您可以有效率地應對連線中斷問題。
此 API 使用以下節點。
影片節點是此 API 的主要資源。當您上載現有影片時,API 會建立一個影片實體並將其發佈到專頁或群組上,具體取決於您在開始發佈程序時將哪個節點定為目標。影片必須發佈到目標節點上。
只要應用程式擁有相應的權限和功能,影片就可以發佈到群組上。此外,應用程式用戶必須可以在專頁上執行管理員級別的任務,或已透過企業管理平台獲授予專頁的管理員角色。
只要應用程式擁有相應的權限和功能,而且應用程式用戶為群組管理員,影片就可以發佈到群組上。
應用程式用戶可以將已發佈的影片發佈到其管理的其他專頁上,無需重新上載影片。多重發佈影片的洞察報告可以透過彙總數值的方式傳回(例如所有專頁的全部瀏覽次數總和),也可以按專頁細分。
您可以使用此 API,將託管在公開伺服器上的一系列圖像建立為微影片。
您可以使用此 API 為已發佈的影片建立投票活動,並獲取相關投票活動的結果。
您可以將已發佈的影片與推廣 API 的廣告創意端點結合使用,以建立影片廣告。
您可以獲取任何已發佈影片的洞察報告。多重發佈影片的洞察報告可以透過彙總數值的方式傳回,也可以按專頁細分。
您可以為在專頁上發佈的影片設定專頁 Webhooks,以獲取關於影片發佈狀態變更和觀眾互動的即時通知。設定回調,然後訂閱專頁主題的 feed
和 videos
欄位,即可獲取通知。請注意,系統不會為以 secret
或 no_story
方式上載的影片傳送通知。
您可以為在專頁上發佈的影片使用權限管理 API,以建立和套用版權規則,從而發現並舉報可能違反規則的其他已發佈影片。
如要在專頁上發佈影片,應用程式用戶必須向您的應用程式授予 pages_show_list
、pages_read_engagement
和 pages_manage_posts
權限。
如要在群組上發佈影片,應用程式用戶必須向您的應用程式授予 publish_to_groups
權限。
在專頁上發佈影片無需任何功能。如要在群組上發佈影片,您的應用程式必須獲准使用群組 API 功能。
應用程式用戶必須可以在目標專頁上執行 ADMIN
等級的任務,或者為目標群組的管理員。
所有權限和功能都需要通過應用程式審查。
在專頁或群組上發佈影片的一般流程如下: