微影片

影片 API 讓您可以在專頁和群組發佈微影片，但不支援向用戶發佈。本文件的例子使用專頁節點，但同樣適用於群組節點。

建立微影片

向專頁影片關係連線傳送 POST 要求，當中需包括含有圖片網址陣列的物件，用於建立影片。圖像必須託管在可公開存取的伺服器上。此物件應說明每張圖片的顯示時間，以及圖像間的切換時間。

圖像格式

JPG、JPEG、PNG、BMP 和 ICO

圖像尺寸

如果圖像尺寸不同，API 會剪裁圖像並將其尺寸調整至 600x600 像素，同時建立一個正方形影片。如果所有圖像的尺寸均相同，則系統會按其尺寸顯示影片。

必要條件

要求必須最少包含 3 張圖像，最多包含 7 張。
每張圖像的大小不得超過 10 MB。

要求語法

POST /v19.0/{page-id}/videos ?access_token={access-token} &slideshow_spec={slideshow-spec}

所需參數

參數	描述
`access_token`	如要在專頁發佈影片，則需要專頁存取憑證；如果在群組發佈影片，則需要用戶存取憑證。
`slideshow_spec`	包含圖片網址陣列和描述影片的屬性之物件。參閱下方的微影片物件屬性。

微影片物件屬性

屬性	描述
`images_urls` 必填	陣列，包含 3 至 7 個圖像網址，用於建立影片。
`duration_ms`	以毫秒為單位的整數，表示每張圖像在影片中應顯示的時間。預設數值為 `1750`。數值必須大於 `0`。
`transition_ms`	以毫秒為單位的整數，表示圖片之間淡入淡出的切換時間。預設數值為 `250`。數值必須大於 `0`。

要求範例

curl -X POST \ "https://graph-video.facebook.com/v19.0/1755847768034402/videos" \ -F "access_token=EAADd..." \ -F "slideshow_spec={ \ "images_urls":[ \ 'https://socialsizz...1.png', \ 'https://socialsizz...2.png', \ 'https://socialsizz...3.png' \ ], \ "duration_ms": 5000, \ "transition_ms": 200 \ }"

成功時，API 將在回應中提供新建立的影片之編號。

JSON 回應範例

{ "id":"277487313407856" }