Diaporamas

L’API Video vous permet de publier des diaporamas vidéo sur des Pages et des Groupes. La publication sur des Utilisateurs n’est pas prise en charge. Les exemples de ce document utilisent un nœud Page, mais s’appliquent de la même manière aux nœuds Groupe.

Création d’un diaporama

Envoyez une requête POST à l’arête Vidéos de Page et incluez un objet contenant un ensemble d’URL d’images à utiliser pour produire la vidéo. Les images doivent être hébergées sur un serveur accessible au public. L’objet doit indiquer la durée d’affichage de chaque image ainsi que la durée de la transition entre les images.

Formats d’image

JPG, JPEG, PNG, BMP, ICO

Dimensions d’image

Si les images possèdent des dimensions différentes, l’API les recadre et les redimensionne pour obtenir une taille de 600 x 600 pixels et créer une vidéo carrée. Si toutes les images ont la même dimension, la vidéo aura cette dimension.

Conditions requises

La requête doit comporter entre trois et sept images.
Chaque image ne doit pas dépasser 10 Mo.

Syntaxe de la requête

POST /v19.0/{page-id}/videos ?access_token={access-token} &slideshow_spec={slideshow-spec}

Paramètres obligatoires

Paramètre	Description
`access_token`	Token d’accès de Page en cas de publication sur une Page, ou token d’accès d’utilisateur en cas de publication sur un Groupe.
`slideshow_spec`	Objet qui contient un ensemble d’URL d’images et des propriétés décrivant la vidéo. Voir Propriétés de l’objet Diaporama ci-dessous.

Propriétés de l’objet Diaporama

Propriété	Description
`images_urls` Obligatoire	Ensemble contenant entre trois et sept URL d’images à utiliser lors de la réalisation de la vidéo.
`duration_ms`	Entier indiquant la durée en millisecondes de l’affichage de chaque image dans la vidéo. La valeur par défaut est `1750`. La valeur doit être supérieure à `0`.
`transition_ms`	Entier indiquant la durée en millisecondes du fondu enchaîné servant de transition entre les images. La valeur par défaut est `250`. La valeur doit être supérieure à `0`.

Exemple de requête

curl -X POST \ "https://graph-video.facebook.com/v19.0/1755847768034402/videos" \ -F "access_token=EAADd..." \ -F "slideshow_spec={ \ "images_urls":[ \ 'https://socialsizz...1.png', \ 'https://socialsizz...2.png', \ 'https://socialsizz...3.png' \ ], \ "duration_ms": 5000, \ "transition_ms": 200 \ }"

En cas de réussite, l’API répond avec l’ID de la nouvelle vidéo.

Exemple de réponse JSON

{ "id":"277487313407856" }