API de video

Obtener videos

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

Obtener videos de grupos

Antes de empezar

Para obtener videos de grupos de usuarios, necesitas lo siguiente:

  • Un token de acceso de usuario solicitado por una persona que administre el grupo.
  • El permiso publish_to_groups.

Para obtener videos de grupos de páginas, necesitarás lo siguiente:

Envía una solicitud GET al punto de conexión /{group-id}/videos:

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

Si la operación se completa correctamente, la app recibirá la siguiente respuesta:

{
  "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 videos de páginas

Antes de empezar

Para las páginas en las que podrás realizar la tarea MANAGE, necesitarás lo siguiente:

Para las páginas públicas, donde no puedes realizar la tarea MANAGE, necesitarás lo siguiente:

Envía una solicitud GET al punto de conexión /{page-id}/videos para obtener una lista de todos los videos de una página.

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

Si la operación se completa correctamente, la app recibirá la siguiente respuesta:

{
  "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 videos de usuarios

Antes de empezar

Necesitarás lo siguiente:

  • Un token de acceso de usuario solicitado por el usuario propietario del video.
  • El permiso user_videos.

Envía una solicitud GET a /{user-id}/videos?type=uploaded para obtener todos los videos que cargó una persona o a /{user-id}/videos?type=tagged para obtener todos los videos en los que se etiquetó a una persona.

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

Si la operación se completa correctamente, la app recibirá la siguiente respuesta:

{
  "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, las solicitudes GET sin un valor de type especificado devolverán los videos en los que se etiquetó a una persona.
  • Si no se devuelve ningún valor de description, entonces la publicación del video no contenía ningún texto.

Más información