Configurando Facebook¶
Vinyl no es compatible de forma nativa con Graph API de Facebook, ni como autenticación ni como proveedor de datos. Sin embargo, dado que la API Graph de Facebook se puede consumir como una API REST, protegida mediante el flujo de credenciales de cliente OAuth, es posible utilizar el proveedor de seguridad HTTP genérico de Vinyl para recuperar datos de Facebook.
La documentación de Facebook para usar el flujo de credenciales de cliente OAuth se puede encontrar aquí:
https://developers.facebook.com/docs/facebook-login/access-tokens#apptokens
Las principales tareas involucradas incluyen:
- Registre Vinyl como aplicación de Facebook.
- Cree un proveedor de seguridad HTTP de Facebook
- Cree una fuente de datos de Facebook.
Se supone que su organización ya tiene una cuenta de Facebook. Además, se supone que la organización se ha registrado como desarrollador de aplicaciones de Facebook.
Registrar Vinyl Como Aplicación de Facebook¶
Comience iniciando sesión en el Panel de aplicaciones de Facebook.
https://developers.facebook.com/apps/
- Haga clic en el botón Agregar una nueva aplicación.
-
Proporcione la siguiente información:
-
Nombre para mostrar: un nombre lógico para la aplicación o el ambiente de Vinyl.
Ejemplo: Vinyl
-
Correo de contacto: Su dirección de correo.
- Categoría: Negocios
-
-
Haga clic en el botón Crear ID de aplicación.
- Seleccione Panel en el menú.
- Haga clic en el botón Mostrar debajo de Secreto de aplicación.
-
Tome nota de las siguientes propiedades:
- ID de aplicación: este será el valor de ClientId al configurar el proveedor de seguridad HTTP dentro de Vinyl.
- App Secret: Este será el valor de ClientSecret al configurar el proveedor de seguridad HTTP dentro de Vinyl.
Crear un Proveedor de Seguridad HTTP de Facebook¶
Para crear un proveedor de seguridad HTTP, comience iniciando sesión en Vinyl como administrador.
- Navegue hasta IDE
- Seleccione el botón Proveedores de seguridad
- En el panel Autenticación de fuente de datos, haga clic en el botón + Autenticación de fuente de datos
-
Proporcione lo siguiente:
- Nombre: Facebook
- Tipo: HTTP
- Habilitado: Verificar
- Tipo de autenticación: Credenciales de cliente
- Haga clic en el botón Guardar
-
Establezca las siguientes propiedades. En el panel Propiedades, haga clic en el botón + Propiedad → Seleccione el Parámetro → Proporcione el Valor → Haga clic en el icono Guardar.
- Tipo de autenticación: Credenciales de cliente
- TokenEndpoint: https://graph.facebook.com/v2.8/oauth/access_token
- El extremo del token debe contener el número de versión. La versión debe ser 2.0 o superior. Al momento de escribir este artículo, 2.8 es la versión actual de Facebook Graph API.
- ClientId: el {App ID} proporcionado por Facebook
- ClientSecret: El {App Secret} proporcionado por Facebook
Crear una Fuente de Datos de Facebook¶
Para crear una fuente de datos de Facebook, comience iniciando sesión en Vinyl como administrador.
- Navegue hasta IDE
- Haga clic en el botón Servidores de datos
- Haga clic en + Servidor
-
Proporcione lo siguiente:
- Nombre del servidor: Facebook
- Tipo: API REST
- Subtipo: DESCANSO
- URL: https://graph.facebook.com/
- Tipo de contenido de solicitud: JSON
- Tipo de contenido de respuesta: JSON
-
Expanda Configuración de seguridad, establezca Proveedor de seguridad en el valor de Facebook configurado en el paso anterior.
- Haga clic en Guardar
- Haga clic en el icono Tablas de Configuración del servidor para configurar la información de los Extremos.
- En el panel Extremos, haga clic en el botón + Extremo
-
Proporcione lo siguiente:
- Nombre: Página
- Extremo:
{{Página}}?fields=fan_count
-
Haga clic en el ícono marca de verificación
- En el panel Parámetros de Extremo, haga clic en el botón + Parámetro
-
Proporcione lo siguiente:
- Nombre: Página
- Tipo de datos: Cadena
- Valor de prueba: zudysoftware
-
Haga clic en el botón Guardar
-
En el panel Extremos, haga clic en el botón Descubrir y haga clic en Descubrir nuevamente.
Este proceso de importación completará el panel de Resultados de SQL.
-
En el panel Resultados SQL, ubique la tabla de páginas y haga clic en el icono Resultados.
Suponiendo que todo se haya configurado correctamente, debería ver el recuento de seguidores de la cuenta de Facebook de zudysoftware.
Solución de Problemas¶
Error: "Se encontró un carácter inesperado al analizar el valor: a. Ruta '', línea 0, posición 0."
Esto indica que el cuerpo de la respuesta no se serializó como JSON. Asegúrese de que el extremo del token contenga un número de versión que sea superior a 2.0.