图谱 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/v19.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 指南。

错误代码

错误	描述
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
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
104	Incorrect signature
200	Permissions error

创建

你可以通过下列路径向 thumbnails 连线发出 POST 请求：

/{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/v19.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,

}

错误代码

错误	描述
100	Invalid parameter
200	Permissions error
104	Incorrect signature

更新

你无法在此端点执行该操作。

删除

你无法在此端点执行该操作。