API de vídeo

Obtener vídeos

En este documento se explica cómo obtener vídeos en páginas, grupos y usuarios.

Obtener vídeos de grupo

Antes de empezar

Para obtener vídeos del grupo de un usuario, necesitarás lo siguiente:

Para obtener vídeos del grupo de un página, necesitarás lo siguiente:

  • Un identificador de acceso a la página solicitado por la página que administra el grupo.
  • La función API de grupos.

Envía una solicitud GET al extremo /{group-id}/videos:

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

Cuando esta operación se completa correctamente, la aplicación recibe lo siguiente:

{ "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": "..." } } }

Obtener vídeos de página

Antes de empezar

En el caso de las páginas en las que puedes realizar la tarea MANAGE, necesitarás lo siguiente:

  • Un identificador de acceso a la página solicitado por una persona que pueda realizar la tarea MANAGE en la página.
  • El permiso pages_read_engagement.

En el caso de las páginas públicas en las que no puedes realizar la tarea MANAGE, necesitarás lo siguiente:

Envía una solicitud GET al extremo /{page-id}/videos para obtener una lista de todos los vídeos de una página.

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

Cuando esta operación se completa correctamente, la aplicación recibe la respuesta siguiente:

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

Obtener vídeos de usuario

Antes de empezar

Necesitarás lo siguiente:

  • Un identificador de acceso de usuario solicitado por el usuario propietario del vídeo.
  • El permiso user_videos.

Envía una solicitud GET a /{user-id}/videos?type=uploaded para obtener todos los vídeos que una persona ha subido o /{user-id}/videos?type=tagged para obtener todos los vídeos en los que se ha etiquetado a una persona.

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

Cuando esta operación se completa correctamente, la aplicación recibe la respuesta siguiente:

{ "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": "..." } } }

Limitaciones

  • De forma predeterminada, una solicitud GET sin un valor de type especificado devolverá los vídeos en los que se ha etiquetado a una persona.
  • Si no se devuelve ningún elemento description, la publicación de vídeo no presentará texto complementario.

Más información