Películas

La API de vídeo permite publicar vídeos con película en páginas y grupos. La publicación en usuarios no se admite. Los ejemplos de este documento utilizan un nodo de página, pero también se aplican a los nodos de grupo.

Creación de una película

Envía una solicitud POST al perímetro de vídeos de página e incluye un objeto que contenga una matriz de direcciones URL de imagen que puedan usarse para crear el vídeo. Las imágenes deben hospedarse en un servidor accesible públicamente. El objeto debe describir cuánto tiempo se mostrará cada imagen y la duración de la transición entre las imágenes.

Formatos de imagen

JPG, JPEG, PNG, BMP, ICO

Dimensiones de las imágenes

Si las imágenes tienen dimensiones diferentes, la API las recortará y redimensionará a 600 x 600 píxeles para crear un vídeo cuadrado. Si todas las imágenes tienen las mismas dimensiones, el vídeo se ajustará a ellas.

Requisitos

  • La solicitud debe incluir un mínimo de 3 imágenes y un máximo de 7.
  • Cada imagen debe tener un tamaño máximo de 10 MB.

Sintaxis de la solicitud

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

Parámetros obligatorios

Parámetro Descripción

access_token

Identificador de acceso a la página si se realiza una publicación en una página o identificador de acceso de usuario si esta se realiza en un grupo.

slideshow_spec

Objeto que contiene una matriz de direcciones URL de imagen y propiedades que describen el vídeo. Consulta Propiedades de objeto de película a continuación.

Propiedades de objeto de película

Propiedad Descripción

images_urls
Obligatorio

Matriz que contiene de 3 a 7 direcciones URL que se utilizarán para crear el vídeo.

duration_ms

Entero que indica el tiempo en milisegundos que cada imagen debe mostrarse en el vídeo. El valor predeterminado es 1750. El valor debe ser mayor que 0.

transition_ms

Entero que indica la duración en milisegundos de la transición de encadenado entre imágenes. El valor predeterminado es 250. El valor debe ser mayor que 0.

Solicitud de ejemplo

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

Si la operación se realiza correctamente, la API responderá con el identificador del vídeo recién creado.

Respuesta JSON de ejemplo

{ "id":"277487313407856" }