Introducción

En esta guía se explica cómo empezar a recibir datos de la gráfica social de Facebook.

Antes de empezar

Necesitarás lo siguiente:

• Regístrate como desarrollador de Meta.
• Una aplicación de Meta que se usará para realizar pruebas, por lo que no es necesario ocuparse del código de la aplicación durante su creación.
• La herramienta del explorador de la API Graph abierta en una ventana diferente del navegador.
• Conocimientos básicos sobre la estructura de la gráfica social de Meta, que se pueden obtener en la guía Información general de la API Graph.

Primera solicitud

Paso 1. Abrir la herramienta del explorador de la API Graph

Abre el explorador de la API Graph en una nueva ventana del navegador. De esta forma, puedes ejecutar los ejemplos mientras lees este tutorial.

El explorador se carga con una consulta predeterminada con el método GET, la versión más reciente de la API Graph, el nodo /me y los campos id y name en el campo de la cadena de consulta, y la aplicación de Facebook.

Paso 2. Generar un identificador de acceso

Haz clic en el botón Generar identificador de acceso. Aparecerá una ventana para iniciar sesión con Facebook. En ella, la aplicación te solicita permiso para obtener tu nombre y foto del perfil de Facebook.

Este proceso es el producto conocido como inicio de sesión con Facebook, que permite iniciar sesión en una aplicación con las credenciales de Facebook. El inicio de sesión con Facebook permite que una aplicación solicite a un usuario acceso a sus datos de Facebook. El usuario podrá aceptar o rechazar dicha solicitud. Tu nombre y foto de perfil son públicos y permiten que las personas te encuentren en Facebook, de modo que no se necesitan requisitos adicionales para ejecutar esta solicitud. Haz clic en Continuar como.... Se crea un identificador de acceso de usuario. Este identificador contiene información, como la aplicación que realiza la solicitud y la persona que usa la aplicación con ese fin. Además, indica si el identificador de acceso todavía es válido (caduca en una hora, aproximadamente), la caducidad y el ámbito de datos que puede solicitar la aplicación. En esta solicitud, el ámbito es public_profile, lo que incluye tu nombre y foto del perfil.

Haz clic en el icono del círculo de información situado al lado del identificador de acceso para consultar la información del identificador.

Paso 3. Enviar la solicitud

Haz clic en el botón Enviar en la esquina superior derecha.

Qué deberías ver

En la ventana de respuesta, verás una respuesta JSON con tu nombre y tu identificador de usuario de Facebook.

Si eliminas el parámetro ?fields=id,name del campo de la cadena de consulta y haces clic en Enviar, verás el mismo resultado, ya que los campos name y id son los campos del nodo de usuario que se devuelven de forma predeterminada.

Segunda solicitud

Paso 1. Añadir un campo

Vamos a añadir otro campo (email) a la primera solicitud para que sea un poco más compleja. Hay dos formas de añadir campos:

• Haz clic en el menú desplegable de búsqueda en el visor del campo de nodo situado a la izquierda de la ventana de respuesta.
• Empieza a escribir en el campo de la cadena de consulta.

Añade el campo email y haz clic en Enviar.

Qué deberías ver

Aunque no se ha producido ningún error en la llamada, solo se han devuelto los campos name y id, junto con un mensaje de depuración. Haz clic en el enlace “(Mostrar)” para depurar la solicitud.

Se necesita un permiso específico para poder acceder a casi todos los nodos y campos. El mensaje de depuración indica que debes conceder permiso a la aplicación para acceder a la dirección de correo electrónico asociada con tu cuenta de Facebook.

Paso 2. Añadir un permiso

En el panel del lado derecho, en Permisos, haz clic en el menú desplegable Añadir un permiso. Haz clic en Permisos de datos del usuario y selecciona email. Generar un nuevo identificador de acceso de usuario Como vas a cambiar el ámbito del identificador de acceso, debes crear uno nuevo. Haz clic en Generar identificador de acceso. Del mismo modo que en la primera solicitud, debes conceder permiso a la aplicación para acceder a tu correo electrónico en el cuadro de diálogo de inicio de sesión con Facebook. Una vez creado el nuevo identificador, haz clic en Enviar. Ahora se devolverán todos los campos de la solicitud.

Enlaces de la respuesta

Ten en cuenta que los valores de id devueltos en la ventana de respuesta son enlaces. Estos enlaces pueden representar nodos, como un usuario, una página o una publicación. Si haces clic en un enlace, el identificador reemplazará el contenido del campo de la cadena de consulta. Ahora puedes ejecutar solicitudes en ese nodo. Como dicho nodo está conectado al nodo principal (una publicación o un usuario), es posible que no tengas que añadir permisos. Puedes hacer clic en el identificador de una publicación, ya que se utilizará en el siguiente ejemplo.

Aviso: Algunos identificadores son una combinación del identificador principal y una nueva cadena de identificación. Por ejemplo, una publicación de un usuario tendrá un identificador de publicación parecido al siguiente: 1028223264288_102224043055529, en el que 1028223264288 es el identificador de usuario.

Observar un perímetro

El nodo de usuario no tiene muchos perímetros que puedan devolver datos. El usuario propietario del objeto es el único que puede conceder acceso a los objetos de usuario. En la mayoría de los casos, un usuario es el propietario de un objeto si lo ha creado.

Por ejemplo, si realizas una publicación, puedes consultar información sobre ella, como la fecha de creación, el texto, las fotos y los enlaces compartidos en ella, así como el número de reacciones que ha recibido. Si comentas tu publicación, podrás obtener ese comentario; en cambio, si es otra persona la que comenta tu publicación, no podrás ver el comentario ni quién lo publicó.

Obtener el código de la solicitud

El explorador permite probar las solicitudes y, al recibir una respuesta correcta, puedes obtener el código para insertarlo en el de tu aplicación. En la parte inferior de la pantalla de respuesta, haz clic en Obtener código. El explorador ofrece código para Android, iOS, JavaScript, PHP y cURL. El código se selecciona previamente para que puedas copiarlo y pegarlo.

Recomendamos implementar el SDK de Facebook para tu aplicación. Este SDK incluye el inicio de sesión con Facebook, que permite a la aplicación solicitar permisos y obtener identificadores de acceso.

Más información

Puedes utilizar el explorador de la API Graph para probar cualquier solicitud de usuarios, páginas, grupos y mucho más. Consulta la referencia de cada nodo o perímetro para determinar el tipo de identificador de acceso y permiso necesarios.