Phiên bản API Đồ thị

Video Thumbnails

Represents a collection of VideoThumbnails on a Video

Đọc

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
},
...

Thông số

Điểm cuối này không có bất kỳ thông số nào.

Trường

Đọc từ cạnh này sẽ trả về một kết quả JSON đã định dạng:

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

`data`

Danh sách nút VideoThumbnail.

`paging`

Để biết thêm chi tiết về chia trang, hãy xem hướng dẫn về API Đồ thị.

Mã lỗi

Lỗi	Mô tả
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

Tạo

Bạn có thể tạo yêu cầu POST đến cạnh thumbnails từ các đường dẫn sau:

/{video_id}/thumbnails

Khi đăng lên cạnh này, hệ thống sẽ tạo 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
}

Thông số

Thông số Mô tả

Thông số	Mô tả
`is_preferred` boolean	Giá trị mặc định: `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 Bắt buộc

is_preferred

boolean

Giá trị mặc định: 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

Bắt buộc

Kiểu trả về

Điểm cuối này hỗ trợ đọc sau khi ghi và sẽ đọc nút mà bạn đã đăng vào đó.

Struct {

success: bool,

}

Mã lỗi

Lỗi	Mô tả
100	Invalid parameter
200	Permissions error

Cập nhật

Bạn không thể thực hiện thao tác này trên điểm cuối này.

Xóa

Bạn không thể thực hiện thao tác này trên điểm cuối này.