圖形 API 版本

Video Thumbnails

Represents a collection of VideoThumbnails on a Video

閱讀中

Get a list of VideoThumbnails on a Video.

Requirements

Type	Requirement
Access Tokens	App or Page
Permissions	`pages_read_engagement`, `pages_show_list`

Examples

curl -X GET "https://graph.facebook.com/v21.0/video-id/thumbnails?access_token=page_access_token"

On success your app receives a list of VideoThumbnail objects for the video.

{
"id": "video-id-1",
"height": 1280,
"scale": 1,
"uri": "url-for-video-1",
"width": 720,
"is_preferred": false
},
{
"id": "video-id-2",
"height": 1280,
"scale": 1,
"uri": "url-for-video-2",
"width": 720,
"is_preferred": false
},
...

參數

這個端點沒有任何參數。

欄位

由此關係連線進行的閱讀將回傳 JSON 格式結果：

{
    "data": [],
    "paging": {}
}

`data`

VideoThumbnail 節點的清單。

`paging`

如需更多有關分頁的詳細資料，請參閱圖形 API 指南。

Error Codes

錯誤	說明
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
104	Incorrect signature
283	That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata
200	Permissions error

建立中

You can make a POST request to thumbnails edge from the following paths:

/{video_id}/thumbnails

發佈到此關係連線時，會建立 a VideoThumbnail 。

Limitations

Maximum thumbnail file size 10MB.
Thumbnails can only be created on Videos that have been associated with a Page.
We recommend that you use thumbnails with the same aspect ratio as the video.

Requirements

Type	Requirement
Access Tokens	App or Page
Permissions	`pages_read_user_content`, `pages_manage_engagement`, `pages_show_list`

Examples

curl -X POST "https://graph.facebook.com/v21.0/video-id/thumbnails
   ?access_token=page_access_token
   &is_preferred=true
   &source=@ThumbnailSample1.jpg"

On success your app receives a list of VideoThumbnail objects for the video.

{
  "success": true
}

參數

參數說明

參數	說明
`is_preferred` boolean	預設值：`false` Set to `true` if this thumbnail is the preferred thumbnail to be shown for this video
`source` image	The source for the thumbnail, an image file 必填

is_preferred

boolean

預設值：false

Set to true if this thumbnail is the preferred thumbnail to be shown for this video

source

image

The source for the thumbnail, an image file

必填

傳回類型

此端點支援寫入後讀取功能，並將讀取你傳送 POST 的節點。

Struct {

success: bool,

}

Error Codes

錯誤	說明
100	Invalid parameter
200	Permissions error

更新中

你無法在此端點執行此操作。

刪除中

你無法在此端點執行此操作。