Primeros pasos

En esta guía se explica la forma de comenzar a recibir datos de la gráfica social de Facebook.

Antes de empezar

Necesitarás lo siguiente:

• Registrarte como desarrollador de Meta
• Una app de Meta: esta app se usará con fines de prueba, por lo que no será necesario que incluyas el código de la app de Meta cuando la crees.
• La herramienta del explorador de la API Graph, abierta en una ventana aparte del navegador
• Información básica sobre la estructura de la gráfica social de Meta incluida en la guía de información general de la API Graph

Tu primera solicitud

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

Abre la herramienta del explorador de la API Graph en una ventana aparte del navegador. Esto te permite ejecutar los ejemplos a medida que lees el tutorial.

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

Paso 2: Generar un token de acceso

Haz clic en el botón Generar token de acceso. Aparecerá una ventana emergente de inicio de sesión con Facebook. Esta ventana emergente de tu app te solicita permiso para obtener tu nombre y foto de perfil de Facebook.

Este flujo es nuestro producto de inicio de sesión con Facebook que permite a una persona iniciar sesión en una app usando sus credenciales de Facebook. El inicio de sesión con Facebook permite que una app solicite acceso a los datos de Facebook de una persona, y que esta acepte o rechace el acceso Tu nombre y tu foto de perfil son públicos para que otras personas puedan encontrarte en Facebook, de modo que no hay requisitos adicionales para esta solicitud. Haz clic en Continuar como... Se crea el token de acceso de usuario. Este token contiene información como, por ejemplo, la app que realiza la solicitud, la persona que usa la app para realizar una solicitud, si el token de acceso aún es válido (caduca aproximadamente en una hora), la hora de caducidad y el alcance de los datos que la app puede solicitar. En esta solicitud, el alcance es public_profile, lo que incluye tu nombre y foto de perfil.

Haz clic en el círculo de información junto al token acceso para ver la información del token.

Paso 3: Enviar la solicitud

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

Lo que debes ver

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

Si eliminas ?fields=id,name del campo de cadena de consulta y haces clic en Enviar, verás el mismo resultado porque name y id son los campos de nodos de usuario que se devuelven de manera predeterminada.

Tu segunda solicitud

Paso 1: Agregar un campo

Hagamos un poco más compleja la primera solicitud agregando otro campo: email. Hay dos formas de agregar campos:

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

Agrega el campo email y haz clic en Enviar.

Lo que debes ver

Si bien la llamada no falló, solo se devolvieron 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 acceder a casi todos los nodos y campos. El mensaje de depuración te indica que debes dar permiso a tu app para acceder a la dirección de correo electrónico que asociaste con tu cuenta de Facebook.

Paso 2: Agregar un permiso

En el panel del lado derecho, dentro de Permisos, haz clic en el menú desplegable Agregar un permiso. Haz clic en Permisos de datos de usuario y selecciona correo electrónico. Generar un nuevo token de acceso de usuario Al cambiar el alcance del token de acceso, deberás crear uno nuevo. Haz clic en Generar token de acceso. Como en tu primera solicitud, en el cuadro de diálogo de inicio de sesión con Facebook, debes dar permiso a la app para que acceda a tu correo electrónico. Una vez que se haya creado el nuevo token, haz clic en Enviar. Ahora, se devolverán todos los campos de tu solicitud.

Enlaces de la respuesta

Ten en cuenta que los valores id devueltos en la ventana de respuesta son enlaces. Estos enlaces pueden representar nodos, como los de usuario, página o publicación. Si haces clic en un enlace, el identificador reemplazará el contenido del campo de la cadena de la consulta. Ahora puedes ejecutar solicitudes en ese nodo. Debido a que este nodo se conecta con el nodo principal, una publicación de usuario, es posible que no necesites agregar permisos. Puedes hacer clic en un identificador de publicación, ya que lo usaremos en el siguiente ejemplo.

Aviso: Algunos identificadores son una combinación del identificador principal y una nueva cadena de identificador. Por ejemplo, la publicación de un usuario tendrá un identificador de publicación con el siguiente aspecto: 1028223264288_102224043055529 donde 1028223264288 es el identificador de usuario.

Echemos un vistazo a un perímetro

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

Por ejemplo, si compartes una publicación podrás ver información sobre ella, como la fecha de creación, los textos, las fotos y los enlaces compartidos, además de la cantidad de reacciones que recibió. Si haces un comentario sobre tu publicación, podrás ver el comentario. Sin embargo, si otra persona publica un comentario sobre tu publicación, no podrás verlo ni saber quién lo publicó.

Obtener el código para tu solicitud

La herramienta de exploración te permite probar solicitudes y, una vez que obtienes una respuesta correcta, puedes obtener el código para insertarlo en el código de tu app. En la parte inferior de la ventana de respuesta, haz clic en Obtener código. El explorador ofrece código de Android, iOS, JavaScript, PHP y cURL. El código viene preseleccionado, así que puedes copiarlo y pegarlo.

Te recomendamos implementar el SDK de Facebook para tu app. Este SDK incluirá el inicio de sesión con Facebook, que permite a tu app solicitar permisos y obtener tokens de acceso.

Más información

Puedes usar la herramienta del explorador de la API Graph para probar cualquier solicitud de usuarios, páginas y grupos, entre otros elementos. Consulta la referencia de cada nodo o perímetro para determinar el permiso y el tipo de token de acceso requeridos.