Componentes
URLs de hospedagem
https://graph-video.facebook.com: usada exclusivamente para publicar vídeos em Páginas e grupos.https://graph.facebook.com: usada para todas as outras situações (criar enquetes, obter informações etc.).
Protocolos de carregamento
A API é compatível com os protocolos de carregamento retomável e não retomável. O protocolo de carregamento retomável é usado para carregar partes do vídeo em sequência. Já o protocolo de carregamento não retomável é usado para carregar vídeos completos. Recomendamos o uso do protocolo de carregamento retomável, já que ele é compatível com arquivos maiores e responde melhor a interrupções na conexão.
Recursos
A API usa os seguintes nós:
Vídeos
O nó de vídeo é o recurso principal da API. Quando você carrega um vídeo, a API gera uma entidade de vídeo e a publica em uma Página ou um grupo, dependendo do nó de destino selecionado no início do processo de publicação. Os vídeos devem ser publicados em um nó de destino.
Páginas
Os vídeos poderão ser publicados em um grupo, desde que o aplicativo tenha as permissões e os recursos apropriados. Além disso, o usuário do aplicativo deve poder executar tarefas na Página de maneira equivalente a um administrador ou precisa ter recebido uma função de administrador da Página por meio do Gerenciador de Negócios.
Grupos
Os vídeos poderão ser publicados em um grupo, desde que o aplicativo tenha as permissões e os recursos apropriados. Além disso, o usuário do aplicativo deve ser um administrador do grupo.
Vídeo com Publicação Cruzada
Vídeos já publicados podem ser exibidos em outras Páginas administradas pelo usuário do aplicativo sem necessidade de recarregamento. As informações de Vídeos com Publicação Cruzada podem ser retornadas como valores agregados (por exemplo, a soma das visualizações de todas as Páginas) ou podem ser classificadas por Página.
Apresentações multimídia
Você pode usar a API para gerar um vídeo de apresentação multimídia a partir de uma coleção de imagens hospedadas em um servidor público.
Enquetes
Você pode usar a API para criar enquetes em vídeos publicados e obter resultados.
Anúncios
Os vídeos publicados podem ser usados com o ponto de extremidade do criativo do anúncio da API de Marketing para criar anúncios de vídeo.
Informações
Você pode obter informações sobre qualquer vídeo publicado. As informações sobre Vídeos com Publicação Cruzada podem ser retornadas como valores agregados ou classificadas por Página.
Webhooks
Para vídeos publicados em Páginas, você pode receber notificações em tempo real das alterações no status de publicação de um vídeo e nas interações de espectadores, configurando os webhooks de Páginas. Para receber notificações, configure um retorno de chamada e assine os tópicos feed e videos da Página. Tenha em mente que as notificações não serão enviadas para vídeos carregados como secret ou no_story.
Rights Manager
Para vídeos publicados em uma Página, você pode usar a API do Rights Manager para criar e aplicar regras de direitos autorais, de modo a descobrir e denunciar violações em outros vídeos publicados.
Requisitos
Permissões
Para publicar em uma Página, o usuário deve conceder as permissões pages_show_list, pages_read_engagement e pages_manage_posts ao seu aplicativo.
Para publicar em um grupo, o usuário deve conceder a permissão publish_to_groups ao seu aplicativo.
Recursos
Nenhum recurso é necessário para publicar em uma Página. Para publicar em um grupo, seu aplicativo deve ser aprovado para o recurso da API de Grupos.
Função de administrador
O usuário do aplicativo deve poder executar tarefas ADMINna Página de destino ou ser um administrador do grupo de destino.
Análise do aplicativo
As permissões e os recursos exigem a análise do aplicativo.
Como funciona
Veja o processo típico de publicação de um vídeo em uma Página ou um grupo:
- Obter um token de acesso e as permissões apropriadas do usuário do aplicativo.
- Obter uma lista das Páginas ou grupos nos quais o usuário do aplicativo pode executar tarefas de maneira equivalente a um administrador.
- Permitir que o usuário do aplicativo selecione a Página ou o grupo no qual ele quer que o vídeo apareça.
- Permitir que o usuário do aplicativo selecione o vídeo a ser publicado.
- Dividir o vídeo em partes menores.
- Iniciar uma sessão de carregamento e carregar as partes individuais.
- Concluir a sessão de carregamento.