Guía del explorador de la API Graph

Usos comunes

• Generar tokens de acceso de manera rápida
• Obtener ejemplos de códigos para tus consultas
• Generar información de depuración para incluirlas en solicitudes de ayuda
• Probar solicitudes a la API con la configuración de la app de producción, incluso permisos, funciones y valores de configuración para los casos de uso
• Probar solicitudes a la API con la app de desarrollo o de prueba con los permisos y las funciones de los usuarios de prueba o de los datos de prueba

Requisitos

• Una cuenta de desarrollador de Facebook
• Una app en la que tengas un rol, por ejemplo, administrador, desarrollador o evaluador

Componentes

Token de acceso

Cuando obtienes un token de acceso, se muestra en la parte superior derecha de la herramienta. Este es el token que se incluye en la consulta a la API Graph. Puedes copiar este token y usarlo en la app para probar el código.

Haz clic en el ícono de información para ver los detalles del token actual, incluida la app a la que está vinculado, y los permisos de inicio de sesión que concedió el usuario que está usando la app (es decir, tú).

Puedes generar un nuevo token de acceso si ya caducó o si agregas nuevos permisos.

App de Meta

En el menú desplegable de la app de Meta, en la parte superior derecha, se muestran todas las apps en las que tienes un rol de administrador, desarrollador o evaluador. Desde este menú desplegable, puedes seleccionar la configuración de la app que deseas probar.

Usuario o página

En el menú desplegable "Usuario" o "Página", puedes obtener e intercambiar tokens de acceso de usuario, página o app correspondientes a la app que se encuentra seleccionada en este momento. También sirve para desinstalar la app del nodo de usuario, lo cual destruye el token de acceso actual.

Permisos

Cuando se solicita un token de acceso de usuario, solo se otorga un permiso de forma predeterminada: public_profile. El menú desplegable "Agregar un permiso" te permite seleccionar permisos de datos del usuario, como email y user_photos; permisos de eventos, grupos y páginas, como manage_pages y ads_management; y otros permisos, como instagram_basic y publish_video. De esta manera, el usuario actual de la app (es decir, tú) puede conceder permisos específicos de la app. Solo concede los permisos que tu app realmente necesita.

Si tu app está en desarrollo, puedes otorgarle cualquier permiso, y tus consultas respetarán esos permisos en el caso de los datos que son propiedad de las personas que tienen un rol en tu app. Por otro lado, si la app está en activa y le otorgas un permiso que no fue aprobado en el proceso de revisión de apps, se producirá un error cada vez que envíes una consulta.

Campo de la cadena de la consulta

Cuando ingresas a la herramienta por primera vez, aparece una solicitud predeterminada. Puedes editar la consulta actual escribiendo una nueva o buscando y seleccionando campos en el visor de campos después de ejecutar la consulta. También puedes usar los menús desplegables para alternar entre los métodos de operación y llegar a diferentes versiones de la API Graph.

Al hacer clic en el ícono de estrella ubicado al final del campo, la consulta se guarda como favorita. Puedes ver tus consultas favoritas haciendo clic en el ícono de libro.

Visor de campos de nodo

Cuando envías una consulta GET en un nodo, el visor de campos, que está ubicado en la parte izquierda de la ventana, muestra el nombre del nodo y los campos que devuelve la API Graph. Para modificar la consulta, busca y selecciona campos nuevos, haz clic en el ícono de signo más y elige entre los campos disponibles, o bien desmarca los campos que no necesitas. Estas acciones actualizan dinámicamente la consulta en el campo de la cadena de la consulta.

Ventana de respuesta

La respuesta, que está situada debajo de la cadena de consulta, muestra los resultados que se devolvieron a partir de la última consulta enviada.

Obtener código

Si estás conforme con tu consulta, haz clic en el botón "Obtener código", que se ubica en la parte central inferior debajo de la respuesta, para generar un código de muestra basado en la consulta. Lo más probable es que no puedas copiar y pegar el código de muestra directamente en la base del código, pero es un buen punto de partida.

Copiar información de depuración

Si se generan errores constantes en la consulta y, como no conoces el motivo, decides comunicarte con el servicio de ayuda para desarrolladores, haz clic en este botón, que se ubica en la parte central inferior, para copiar la consulta y los detalles de la respuesta en el portapapeles. Puedes enviar esta información junto con la solicitud de soporte para ayudarnos a descubrir qué es lo que sucede.

Guardar sesión

Haz clic en el botón "Guardar sesión", que está ubicado en la parte central inferior, para guardar el estado de la consulta con el token de acceso eliminado. Si decides comunicarte con el servicio de ayuda para desarrolladores, incluye el enlace a la sesión.

Ejemplo de consulta

Intenta ejecutar la consulta predeterminada que aparece al cargar por primera vez el explorador de la API Graph. Si aún no lo hiciste, abre el explorador de la API Graph en una ventana nueva, selecciona la app que deseas probar en el menú desplegable de apps y obtén un token de acceso de usuario.

La consulta predeterminada aparece en el campo de la cadena de la consulta:

GET https://developers.facebook.com/v21.0/me?fields=id,name

La consulta predeterminada está solicitando los campos id y name en el nodo /me, que es un nodo especial que se asigna al nodo /User o al nodo /Page identificados por el token. Dado que estás usando un token de acceso de usuario, el nodo se asigna a tu nodo "User".

Los campos id y name están disponibles públicamente y pueden devolverse como resultado si el usuario le concedió permisos default o public_profile a la app. Estos permisos se aprobaron previamente para todas las apps (puedes confirmarlo haciendo clic en el ícono de información en el campo Token de acceso). Por lo tanto, no tienes que conceder otros permisos a la app para que la consulta funcione. Haz clic en Obtener token de acceso y confirma que quieres conceder a la app el acceso a tu información de usuario que está disponible públicamente.

Al enviar tu consulta, deberías ver en la ventana de respuesta tu identificador de usuario específico de la app y tu nombre.