Versione API Graph

Video Thumbnails

Represents a collection of VideoThumbnails on a Video

Lettura

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

Parametri

Questo endpoint non dispone di parametri.

Campi

La lettura da questo segmento fornirà un risultato formattato JSON:

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

`data`

Una lista di nodi VideoThumbnail.

`paging`

Per ulteriori dettagli sulla paginazione, consulta la Guida su API Graph.

Error Codes

Errore	Descrizione
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

Creazione

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

/{video_id}/thumbnails

When posting to this edge, a VideoThumbnail will be created.

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
}

Parametri

Parametro Descrizione

Parametro	Descrizione
`is_preferred` boolean	Valore predefinito: `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 Obbligatorio

is_preferred

boolean

Valore predefinito: 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

Obbligatorio

Tipo di ricavo

Questo endopoint supporta read-after-write e leggerà il nodo in cui hai effettuato una richiesta POST.

Struct {

success: bool,

}

Error Codes

Errore	Descrizione
100	Invalid parameter
200	Permissions error

Aggiornamento

Non puoi eseguire questa operazione in questo endpoint.

Eliminazione

Non puoi eseguire questa operazione in questo endpoint.