Presentazioni

L'API Video consente di pubblicare video di presentazione su Pagine e gruppi. La pubblicazione su profili utente non è supportata. Gli esempi in questo documento utilizzano un nodo Pagina ma si applicano allo stesso modo ai nodi Gruppo.

Creazione di una presentazione

Invia una richiesta POST al segmento Page Videos e includi un oggetto contenente un array di URL di immagini da utilizzare per creare il video. Le immagini devono essere ospitate su un server accessibile pubblicamente. L'oggetto deve descrivere per quanto tempo visualizzare ciascuna immagine e la durata della transizione tra le immagini.

Formati immagine

JPG, JPEG, PNG, BMP, ICO

Dimensioni immagine

Se le immagini hanno dimensioni diverse, l'API le ritaglierà e le ridimensionerà a 600x600 pixel, creando un video quadrato. Se tutte le immagini hanno la stessa dimensione, il video corrisponderà a quella dimensione.

Requisiti

  • La richiesta deve includere un minimo di 3 e un massimo di 7 immagini.
  • Ogni immagine non deve superare i 10 MB.

Sintassi della richiesta

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

Parametri obbligatori

Parametro Descrizione

access_token

Un token d'accesso della Pagina se si pubblica su una Pagina oppure un token d'accesso utente se si pubblica su un gruppo.

slideshow_spec

Un oggetto contenente un array di URL di immagini e proprietà che descrivono il video. Vedi Proprietà degli oggetti della presentazione sotto.

Proprietà degli oggetti della presentazione

Proprietà Descrizione

images_urls
Obbligatorio

Un array contenente 3-7 URL di immagini da utilizzare nella creazione del video.

duration_ms

Un numero intero che indica la durata di visualizzazione in millisecondi di ciascuna immagine nel video. Il valore predefinito è 1750. Il valore deve essere maggiore di 0.

transition_ms

Un numero intero indicante la durata in millisecondi della transizione crossfade tra le immagini. Il valore predefinito è 250. Il valore deve essere maggiore di 0.

Esempio di richiesta

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 \ }"

In caso di azione eseguita correttamente, l'API risponderà con l'ID del video appena creato.

Esempio di risposta JSON

{ "id":"277487313407856" }