グラフ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ガイドをご覧ください。

エラーコード

エラー	詳細
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

作成

thumbnailsのエッジにPOSTリクエストを以下のパスで送信できます:

/{video_id}/thumbnails

このエッジにPOSTする場合、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

必須

戻り値の型

This endpoint supports read-after-write and will read the node to which you POSTed.

Struct {

success: bool,

}

エラーコード

エラー	詳細
100	Invalid parameter
200	Permissions error

更新中…

このエンドポイントではこの操作を実行できません。

削除中です

このエンドポイントではこの操作を実行できません。