Componentes
Direcciones URL del host
https://graph-video.facebook.com: se usa exclusivamente para la publicación de vídeos en páginas y grupos.https://graph.facebook.com: se usa para todo lo demás (crear encuestas, obtener estadísticas, etc.).
Protocolos de subida
La API admite los protocolos de subida reanudable y no reanudable. El protocolo de subida reanudable se utiliza para subir fragmentos de vídeo de manera secuencial, mientras que el protocolo no reanudable se emplea para subir vídeos completos. Se recomienda utilizar el protocolo de subida reanudable porque admite archivos de vídeo más grandes y permite controlar las interrupciones de la conexión de manera más eficiente.
Recursos
La API utiliza los nodos siguientes:
Vídeos
El nodo Vídeo es el recurso principal de la API. Al subir un vídeo existente, la API genera una entidad de vídeo y la publica en una página o un grupo, en función del nodo que segmentes al iniciar el proceso de publicación. Los vídeos deben publicarse en un nodo objetivo.
Páginas
Los vídeos se pueden publicar en un grupo siempre y cuando la aplicación tenga los permisos y las funciones adecuados. Además, el usuario de la aplicación debe poder realizar tareas equivalentes a las de administración en la página o haber obtenido un rol de administrador en la página a través del Business Manager.
Grupos
Los vídeos se pueden publicar en un grupo siempre y cuando la aplicación tenga los permisos y las funciones adecuados, y el usuario de la aplicación sea un administrador del grupo.
Vídeos utilizados en varias publicaciones
Los vídeos que ya se han publicado también se pueden publicar en otras páginas que administra el usuario de la aplicación sin necesidad de volver a subirlos. Las estadísticas sobre los vídeos para varias publicaciones se pueden devolver como valores agregados (p. ej., la suma de todas las visualizaciones en todas las páginas) o desglosados por página.
Películas
Puedes utilizar la API para generar un vídeo con película a partir de una colección de imágenes hospedadas en un servidor público.
Encuestas
Puedes utilizar la API para crear encuestas en vídeos publicados y obtener sus resultados.
Anuncios
Los vídeos publicados se pueden utilizar con el extremo Contenido del anuncio de la API de marketing para crear anuncios con vídeo.
Estadísticas
Puedes obtener estadísticas sobre cualquier vídeo publicado. Las estadísticas de los vídeos para varias publicaciones se pueden devolver como valores agregados o desglosados por página.
Webhooks
En el caso de los vídeos publicados en páginas, para recibir notificaciones en tiempo real de los cambios en el estado de la publicación y las interacciones de los espectadores de un vídeo, configura webhooks de página. Configura una devolución de llamada y, a continuación, suscríbete a los campos feed y videos del tema de la página para recibir notificaciones. Ten en cuenta que no se enviarán notificaciones de vídeos que se suban como secret ni como no_story.
Administración de derechos
En el caso de los vídeos publicados en una página, puedes utilizar la API de administración de derechos para crear y aplicar reglas de derechos de autor con la finalidad de descubrir otros vídeos publicados que puedan infringir estas reglas y denunciarlos.
Requisitos
Permisos
Para realizar una publicación en una página, el usuario de la aplicación debe conceder a tu aplicación los permisos pages_show_list, pages_read_engagement y pages_manage_posts.
Para realizar una publicación en un grupo, el usuario de la aplicación debe conceder a tu aplicación el permiso publish_to_groups.
Funciones
No se requiere ninguna función para poder realizar publicaciones en una página. Para realizar una publicación en un grupo, tu aplicación debe recibir la aprobación para usar la función API de grupos.
Rol de administrador
El usuario de la aplicación debe poder realizar tareas equivalentes a las de ADMIN en la página segmentada, o ser un administrador del grupo segmentado.
Revisión de la aplicación
Todos los permisos y todas las funciones requieren la revisión de la aplicación.
Cómo funciona
El proceso general para publicar un vídeo en una página o un grupo es el siguiente:
- Obtener el identificador de acceso y los permisos adecuados del usuario de la aplicación.
- Obtener una lista de páginas o grupos en los que el usuario de la aplicación puede realizar tareas equivalentes a las de administración.
- Proporcionar un método para que el usuario de la aplicación pueda seleccionar la página o el grupo donde quiere que aparezca el vídeo.
- Proporcionar un método para que el usuario de la aplicación pueda seleccionar un vídeo para su publicación.
- Dividir el vídeo en fragmentos más pequeños.
- Iniciar una sesión de subida y subir los fragmentos individuales.
- Finalizar la sesión de subida.