API de Facebook | Serie 1

En esta serie de artículos, cubriremos los detalles sobre la API de Facebook en profundidad. Aprenderemos qué configuración necesitamos para usar la API y cómo hacer que todo funcione para que la API funcione. Entonces, saltemos la Introducción y saltemos a los detalles de la API.

Hay 2 conjuntos de API disponibles en la plataforma de Facebook:

1. API de gráficos
2. API de marketing

Comencemos primero con Graph API .

Graph API es la forma principal de acceder a los medios para leer y escribir datos en el gráfico social de Facebook de las redes sociales. Primero discutiremos la descripción general de Graph API, luego de la configuración, finalmente veremos cómo usar Graph API Explorer para leer y escribir datos en Facebook Social Graph.

Graph API se compone básicamente de 3 componentes:

1. Node: Estos son objetos individuales como Usuario, Página, Foto o un Comentario. Usamos Nodes para recopilar datos sobre Objetos individuales.
2. bordes: estos representan las conexiones entre colecciones de objetos y un solo objeto. Los bordes se utilizan para publicar objetos individuales en la colección de objetos o para obtener colecciones de objetos que están conectados a un solo objeto. Supongamos que consideramos una foto publicada en el perfil de Facebook de un individuo. Ahora los comentarios asociados con esta Foto se refieren a la colección de Objetos que están asociados con el Objeto único que es Foto en nuestro caso.
3. campos: Estos representan los datos o información sobre un objeto. La edad del usuario, la fecha de nacimiento son ejemplos de campos que están asociados con un usuario de Node. Los campos se utilizan para especificar los datos que queremos incluir en una respuesta.

Dado que Graph API está basado en HTTP, funciona con cualquier idioma que tenga una biblioteca basada en HTTP como curl, urllib, etc. Todas las requests se pasan a la graph.facebook.comURL del host . La excepción a esto es la carga de video que usa la URL: graph-video.facebook.com.

Dado que los Nodes son objetos individuales en Facebook. Entonces, cada Node tiene una identificación única asociada. Cada usuario, página o foto tiene una identificación única asociada. Antes de continuar, analicemos primero los tokens de acceso y cómo generar uno para consultar datos de Facebook Social Graph.

El token de acceso aquí sirve principalmente para 2 propósitos:

1. Permite que la aplicación acceda a los datos de un usuario sin requerir las credenciales del usuario.
2. Permite que el servidor identifique quién está usando la aplicación y determine en consecuencia qué funciones puede realizar ese usuario.

Los tokens de acceso se ajustan a OAuth 2.0 Protocol. Esto significa que los tokens de acceso implementan tanto la autenticación como la autorización, como discutimos en el último artículo .

Aquí, tenemos 4 tipos de tokens de acceso:

1. Token de acceso de usuario: este es el token de acceso más utilizado, necesario cuando una aplicación llama a una API para leer, modificar o escribir datos en la página de Facebook de una persona específica. Esto se logra a través de un cuadro de diálogo de inicio de sesión en el que se requiere que una persona permita que la aplicación obtenga el token de acceso.
2. Token de acceso a la aplicación: este token se obtiene mediante una llamada de servidor a servidor. Este token se utiliza para leer, modificar la configuración de la aplicación.
3. Token de acceso a la página: una vez que tenga el token de acceso de usuario, obtendrá el token de acceso a la página a través de Graph API. El procedimiento es muy sencillo, primero obtener el User Access Token y luego solicitar el permiso de manage_posts . Obtendrá su token de acceso a la página. Este token es muy similar al token de acceso de usuario, excepto en el caso en que otorga permiso a la API para leer, modificar o escribir datos en una página de Facebook.
4. Token de cliente: el token de cliente es un identificador que se puede incrustar en binarios móviles nativos o aplicaciones de escritorio. Se utiliza para acceder a las API de nivel de aplicación.

Siga los pasos a continuación para generar el token de acceso:

1. Vaya al enlace Desarrolladores de Facebook y en la esquina más a la derecha encontrará una opción para «Iniciar sesión». Si no es un cliente existente, cree una nueva cuenta haciendo clic en la opción «Iniciar sesión» y luego haga clic en el botón «Crear nueva cuenta» que aparece debajo del botón Iniciar sesión.
2. Después de un inicio de sesión exitoso o una creación de cuenta exitosa, obtendrá una pantalla anterior con la opción «Mis aplicaciones» en el lugar de inicio de sesión.
   
3. Vaya al menú desplegable «Mis aplicaciones» en la esquina más a la derecha y seleccione «Agregar nueva aplicación». Ingrese el nombre para mostrar y el correo electrónico de contacto y haga clic en «Crear ID de aplicación».
4. Después de ingresar la información requerida, verá la pantalla de inicio de su cuenta de desarrollador de Facebook, con la ID de la aplicación mencionada en la parte superior.
5. Haga clic en el menú desplegable «Herramientas» y, en la lista, haga clic en la primera opción, es decir, la opción «Graph API Explorer».
   
6. En la ventana Graph API Explorer, haga clic en el botón «Obtener token». En la lista desplegable, haga clic en «Obtener token de acceso de usuario».
   
7. Al hacer clic en «Obtener token de acceso de usuario», obtendrá una gran lista de permisos de usuario agrupados en 3 categorías: Permisos de datos de usuario, Eventos, Grupos y páginas y Otros permisos. Puede omitir los permisos que no desee. Después de hacer la selección, haga clic en «Obtener token de acceso». Aparecerá una pantalla para la revisión de inicio de sesión.
   
8. Después de completar con éxito los pasos anteriores, obtendrá su token de acceso de usuario.
9. Ahora, una vez más, haga clic en el menú desplegable «Herramientas» en la misma página y ahora esta vez haga clic en la segunda opción «Acceder al depurador de tokens».
   Nota: Antes de hacer clic en la opción Depurador de token de acceso, copie el token de acceso de usuario generado en el paso anterior.
10. Ahora pegue el token de acceso del usuario en el cuadro de diálogo que indica Ingrese un token de acceso para depurar y haga clic en el botón «Depurar».
11. Después de hacer clic en la opción Depurar, verá información sobre su token de acceso de usuario. Debajo de esos detalles, hay una opción para «Extender el token de acceso». Haga clic en este botón. Se le pedirá que ingrese su contraseña de inicio de sesión de Facebook y ¡Listo!. El token que estaba a punto de caducar en 2 horas tendrá una vida útil aumentada a 2 meses. Este paso adicional garantiza que su token de acceso no caduque cada 2 horas.

En el próximo artículo, discutiremos cómo se puede usar el token de acceso de usuario para acceder a diferentes tipos de información del gráfico social de Facebook.

Referencias:

1. https://developers.facebook.com/docs/facebook-login/access-tokens
2. https://developers.facebook.com/docs/graph-api/overview/