Guía del explorador de la API Graph

Usos habituales

• Generar identificadores de acceso rápidamente.
• Obtener códigos de ejemplo para las consultas.
• Generar información de depuración para incluirla en las solicitudes de asistencia.
• Probar las consultas a la API con la configuración de la aplicación de producción, incluidos los permisos, las funciones y las configuraciones para los casos de uso.
• Probar las consultas a la API con la aplicación de prueba o en desarrollo mediante permisos y funciones en usuarios de prueba o datos de prueba.

Requisitos

• Una cuenta de desarrollador de Facebook.
• Una aplicación en la que tengas un rol, como administrador, desarrollador o evaluador.

Componentes

Identificador de acceso

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

Haz clic en el icono de información para obtener más detalles sobre el identificador actual, incluida la aplicación a la que está vinculado, así como los permisos que ha concedido el usuario que usa la aplicación (tú, en este caso).

Puedes generar un nuevo identificador de acceso si este ha caducado o si añades nuevos permisos.

Aplicación de Meta

El menú desplegable de la aplicación de Meta que se encuentra en la parte superior derecha muestra todas las aplicaciones en las que tienes un rol de administrador, desarrollador o evaluador. Usa el menú desplegable para seleccionar la configuración de la aplicación que quieres probar.

Usuario o página

El menú desplegable “Usuario o página” te permite obtener e intercambiar identificadores de acceso a la página, a la aplicación y de usuario para la aplicación que esté seleccionada en ese momento. También puedes usarlo para desinstalar la aplicación del nodo de usuario, lo que destruye el identificador de acceso actual.

Permisos

Al solicitar un identificador de acceso de usuario, solo se concede un permiso de forma predeterminada (public_profile). El menú desplegable “Permiso” te permite seleccionar permisos de datos de usuario, como email y user_photos; permisos de páginas, grupos y eventos, como manage_pages y ads_management; y otros permisos, como instagram_basic y publish_video. De este modo, el usuario de la aplicación actual (en este caso, tú) puede conceder permisos específicos a la aplicación. Concede solo los permisos que realmente necesita tu aplicación.

Si la aplicación está en desarrollo, puedes concederle cualquier permiso y las consultas lo respetarán para los datos que sean propiedad de los usuarios con un rol en la aplicación. Sin embargo, si la aplicación está publicada y le concedes un permiso que no se ha aprobado en el proceso de revisión de la aplicación, se producirá un error en la consulta siempre que la envíes.

Campo de cadena de consulta

Cuando entras en la herramienta por primera vez, aparece una consulta predeterminada. Para editar la consulta, escribe una nueva o busca campos y selecciónalos en el visor de campos después de ejecutar la consulta. También puedes usar los menús desplegables para cambiar entre métodos de operación y dirigirte a distintas versiones de la API Graph.

Si haces clic en el icono con forma de estrella que hay al final del campo de la consulta, esta se guarda como favorita. Para ver tus consultas favoritas, haz clic en el icono del libro.

Visor del campo de nodo

Cuando envías una consulta GET en un nodo, el visor del campo situado en la parte izquierda de la ventana muestra el nombre del nodo y los campos devueltos por la API Graph. Para modificar la consulta, puedes buscar y seleccionar nuevos campos, hacer clic en el icono con el signo más y elegir entre los campos disponibles o bien desmarcar los campos que no sean necesarios. Estas acciones actualizan de forma dinámica tu consulta en el campo de la cadena de consulta.

Ventana Respuesta

La respuesta, situada debajo de la cadena de consulta, muestra los resultados devueltos en la última consulta que se envió.

Obtener código

Si te satisface la consulta que has realizado, haz clic en el botón Obtener código situado en el centro de la parte inferior, debajo de la respuesta, para generar código de ejemplo basado en la consulta. Por lo general, no podrás copiar ni pegar el código de ejemplo directamente en tu base de código, aunque esto te proporciona un punto de partida útil.

Copiar la información de depuración

Si la consulta sigue produciendo un error, no consigues averiguar por qué y decides ponerte en contacto con el equipo de ayuda para desarrolladores, haz clic en este botón, que se encuentra en el centro de la parte inferior, para copiar la consulta y los detalles de la respuesta en el portapapeles. Puedes enviar esta información junto con la solicitud de asistencia a fin de ayudarnos a identificar tu problema.

Guardar la sesión

Haz clic en el botón Guardar la sesión que se encuentra en el centro de la parte inferior para guardar el estado de la consulta con el identificador de acceso eliminado. Si decides ponerte en contacto con el equipo de ayuda para desarrolladores, incluye el enlace a esta sesión.

Ejemplo de consulta

Intenta ejecutar la consulta predeterminada que se muestra cuando cargas por primera vez el explorador de la API Graph. Si aún no lo has hecho, abre el explorador de la API Graph en una ventana nueva, selecciona la aplicación que quieres probar en el menú desplegable de aplicaciones y obtén un identificador de acceso de usuario.

La consulta predeterminada se muestra en el campo de la cadena de consulta:

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

La consulta predeterminada solicita los campos id y name en el nodo /me, que es un nodo especial que se asigna al nodo /User o /Page que identifica el identificador. Dado que usas el identificador de acceso de usuario, se asigna al nodo User.

Los campos id y name están disponibles de forma pública y se pueden devolver si el usuario ha concedido los permisos default o public_profile a tu aplicación. Estos permisos están aprobados previamente para todas las aplicaciones (para confirmarlo, haz clic en el icono de información del campo “Identificador de acceso”), de modo que no necesitas conceder ningún permiso adicional a tu aplicación para que funcione la consulta. Haz clic en la opción Obtener identificador de acceso y confirma que quieres conceder acceso a tu aplicación a la información de usuario disponible públicamente.

Envía la consulta y, a continuación, deberías ver el identificador de usuario específico de la aplicación y el nombre en la ventana de respuesta.