API de Vídeo

Obter vídeos

Este documento explica como obter vídeos de Páginas, grupos e usuários.

Obter vídeos de grupos

Antes de começar

Para obter vídeos do grupo de um usuário, você precisará do seguinte:

Para obter vídeos do grupo de uma Página, você precisará do seguinte:

Envie uma solicitação GET ao ponto de extremidade /{group-id}/videos:

curl -i -X GET "https://graph.facebook.com/{group-id}/videos?access_token={access-token}"

Se o processo for bem-sucedido, o aplicativo receberá a seguinte resposta:

{ "data": [ { "updated_time": "2020-05-18T18:51:15+0000", "id": "{video-id-1}" }, { "description": "Sunshine", "updated_time": "2020-05-18T18:35:09+0000", "id": "{video-id-2}" } ... ], "paging": { "cursors": { "before": "...", "after": "..." } } }

Obter vídeos de Páginas

Antes de começar

Para Páginas em que você pode executar a tarefa MANAGE, será necessário o seguinte:

Para Páginas públicas em que você não pode executar a tarefa MANAGE, será necessário o seguinte:

Envie uma solicitação GET ao ponto de extremidade /{page-id}/videos para obter uma lista de todos os vídeos de uma Página.

curl -i -X GET "https://graph.facebook.com/{page-id}/videos?access_token={access-token}"

Se o processo for bem-sucedido, o aplicativo receberá a seguinte resposta:

{ "data": [ { "description": "Clouds", "updated_time": "2019-09-25T17:18:30+0000", "id": "2153206464921154" }, { "updated_time": "2020-03-26T23:45:11+0000", "id": "2232477747039197" }, ... ], "paging": { "cursors": { "before": "MjE1MzIwNjQ2NDkyMTE1NAZDZD", "after": "MTQwOTU5MTg4NTc2MzM0MwZDZD" } } }

Obter vídeos de usuários

Antes de começar

Você precisará do seguinte:

Envie uma solicitação GET a /{user-id}/videos?type=uploaded para obter todos os vídeos carregados por uma pessoa ou /{user-id}/videos?type=tagged para obter todos os vídeos em que uma pessoa foi marcada.

curl -i -X GET "https://graph.facebook.com/{user-id}/videos ?type=uploaded &access_token={user-access-token}"

Se o processo for bem-sucedido, o aplicativo receberá a seguinte resposta:

{ "data": [ { "description": "Rain", "updated_time": "2020-05-18T20:07:47+0000", "id": "{video-id-1}" }, { "updated_time": "2020-05-20T12:26:19+0000", "id": "{video-id-2}" }, ... ] "paging": { "cursors": { "before": "...", "after": "..." } } }

Limitações

  • Por padrão, uma solicitação GET sem especificação de type retornará vídeos em que uma pessoa foi marcada.
  • Se não houver retorno de description, isso significará que a publicação de vídeo não tinha nenhum texto de descrição.

Veja também