¿Cómo vincular un registro en Athento con un documento en Google Drive?

Athento permite vincular un registro en Athento con un documento en Google Drive, para ello, es necesario realizado una serie de pre-requisitos: configurar Google Provider y tener activa la API de Google Drive.

Pre-requisitos

1. Crear una aplicación de Google para obtener una clave y un secreto a través de la consola de desarrollador en https://console.developers.google.com/

Después de crear un proyecto, tendrás que crear un ID de cliente OAuth y rellenar algunos detalles del proyecto de la siguiente manera:

En «APIs & Services», ve a «Credentials», haz clic en «Create credentials» y crea un nuevo «OAuth client ID». Elige «Web Application» como tipo de aplicación. Proporcione su nombre de dominio o el nombre de dominio de prueba en «Authorized JavaScript origins». Por último, rellena el campo «Authorized redirect URIs» con URLs como http://example.com/accounts/google/login/callback/ , sustituyendo el nombre de dominio por tu nombre de dominio, o con 127.0.0.1:8000 para pruebas. Después de crear el ID de cliente OAuth, anota el ID de cliente y el secreto de cliente, ya que los necesitarás más adelante.

A los usuarios que se conecten utilizando la aplicación se les presentará un formulario de consentimiento. Para que funcione, se necesita información adicional. En «APIs & Services», vaya a «OAuth consent screen» y proporcione al menos una dirección de correo electrónico y un nombre de producto (lo demás es opcional).

2. Configurar Google Provider. Debes crear un objeto SocialApp desde <tu_dominio>/aseadm/socialaccount/socialapp/ y rellenar los siguientes campos:                 

• Provider, “Google”.
• Name, a tu elección, por ejemplo “Google”.
• Client id, copiar el “Client ID” de tu proyecto de Google.
• Secret key, copiar el “Client secret” de tu proyecto de Google.
• Key, no es necesaria, dejar en blanco.
• Sites, elegir la site correspondiente con tu dominio (si tienes problemas con este paso, consulta a un administrador).

3. Activar la API de Google Drive en el proyecto de Google Cloud creado en el paso anterior, desde «APIs & Services»:

Fuente: https://docs.allauth.org/en/latest/socialaccount/providers/google.html#google 

Una vez realizados los pre-requisitos, se deberá permitir la vinculación del registro con el documento de Google Drive a nivel de espacio, activando el check "Allows using Google Drive's features in this serie" desde la administración:

Usar la integración de Athento y Google Drive

Una vez activado, aparecerá un botón de Google Drive desde la vista de los documentos que pertenezcan a ese espacio, arriba a la derecha.

Si se hace clic sin haber iniciado sesión con Google al ingresar a Athento, será necesario iniciar sesión con la cuenta que tenga los documentos que se desean importar desde Drive.

Una vez iniciada la sesión, se dispondrá de un buscador de documentos que permite buscar por palabras clave en el título o contenido, o mediante un enlace específico de un documento de Drive. Al seleccionar el documento, será necesario hacer clic en "Update" para traer el documento binario y enlazarlo al registro de Athento.

Una vez enlazado, al hacer clic nuevamente en el icono de Google Drive, se podrá visualizar a qué documento de Drive está vinculado. Haciendo clic en el título, se accederá al enlace de Drive. También estará disponible un botón de sincronización para traer a Athento los nuevos cambios realizados en el documento, así como un botón para eliminar la vinculación con dicho documento. Además, se mantendrá el selector de documentos para vincular otro, sobrescribiendo el actual.