Componentes
URL del host
https://graph-video.facebook.com: se usa exclusivamente para publicar videos en páginas y grupos.https://graph.facebook.com: se usa para todo lo demás (creación de encuestas, obtención de estadísticas, etc.).
Protocolos de subida
La API admite protocolos de subida reanudable y no reanudable. El protocolo de subida reanudable se usa para subida secuencial de segmentos de video, mientras que el protocolo no reanudable se usa para subir videos completos. Recomendamos utilizar el protocolo de subida reanudable, ya que admite archivos de video más grandes y permite administrar las interrupciones de la conexión de manera más eficaz.
Recursos
La API usa los siguientes nodos.
Videos
El nodo de video es el recurso principal de la API. Cuando subes un video existente, la API genera una entidad del video y la publica en una página o un grupo, según el nodo objetivo indicado al iniciar el proceso de publicación. Los videos se deben publicar en un nodo objetivo.
Páginas
Los videos se pueden publicar en un grupo siempre que la app tenga los permisos y las funciones adecuados. Además, el usuario de la app debe poder realizar tareas de administrador en la página, o tener el rol de administrador en la página concedido mediante el administrador comercial.
Grupos
Los videos se pueden publicar en un grupo siempre y cuando la app tenga los permisos y las funciones adecuados, y que el usuario de la app sea administrador del grupo.
Videos con publicación cruzada
Los videos que ya se publicaron también se pueden publicar en otras páginas que el usuario de la app administra sin necesidad de volver a subirlos. Las estadísticas sobre los videos con publicaciones cruzadas se pueden devolver como valores totales (por ejemplo, la suma de todas las vistas en todas las páginas) o desglosarse por página.
Presentaciones
Puedes usar la API para generar un video de presentación a partir de una colección de imágenes alojadas en un servidor público.
Encuestas
Puedes usar la API para crear encuestas sobre los videos publicados y obtener los resultados.
Anuncios
Los videos publicados se pueden usar con el punto de conexión de contenido del anuncio de la API de marketing para crear anuncios con video.
Estadísticas
Puedes obtener estadísticas sobre cualquier video publicado. Las estadísticas de videos con publicación cruzada se pueden devolver como valores totales o desglosados por página.
Webhooks
Para los videos publicados en las páginas, puedes recibir notificaciones en tiempo real sobre los cambios en el estado de publicación de un video y las interacciones de los espectadores si las configuras desde los webhooks de las páginas. Configura una devolución de llamada y, luego, suscríbete a los campos feed y videos del tema de la página para recibir notificaciones. Ten en cuenta que la notificación no se enviará para los videos que se suban como secret o no_story.
Administración de derechos de propiedad intelectual
Para los videos publicados en una página, puedes usar la API de administración de derechos de propiedad intelectual para crear y aplicar reglas de derechos de autor con el fin de detectar otros videos publicados que pudieran infringir las normas e informar la infracción.
Requisitos
Permisos
Para publicar en una página, el usuario de la app debe conceder a la app los permisos pages_show_list, pages_read_engagement y pages_manage_posts.
Para publicar en un grupo, el usuario de la app debe conceder a tu app el permiso publish_to_groups.
Funciones
No se requieren funciones para publicar en una página. Para publicar en un grupo, se debe aprobar tu app para la función API de grupos.
Rol de administrador
El usuario de la app debe poder realizar tareas de ADMIN en la página objetivo o ser el administrador del grupo objetivo.
Revisión de apps
Todos los permisos y funciones requieren la revisión de la app.
Cómo funciona
El flujo general para publicar un video en una página o un grupo consiste en lo siguiente:
- Obtener un token de acceso y permisos adecuados del usuario de la app.
- Obtener una lista de las páginas o grupos en los que el usuario de la app puede realizar tareas de administrador.
- Proporcionar una manera en que el usuario de la app pueda seleccionar la página o el grupo donde quiere que se muestre el video.
- Proporcionar una manera en que el usuario de la app pueda seleccionar un video para publicar.
- Dividir el video en segmentos más pequeños.
- Iniciar una sesión de subida y subir los segmentos individuales.
- Finalizar la sesión de subida.