Cómo ONLYOFFICE maneja datos de usuario de Google
Aplicación
Los portales de ONLYOFFICE interactúan con Google realizando solicitudes a la Google API oficial con el protocolo de autorización OAuth 2.0. Para trabajar de acuerdo con este protocolo, la aplicación ONLYOFFICE (api-project-948651087073) fue creada en la Consola de Google API. Los siguientes servicios están conectados a ella: Google Drive API, People API, Contacts API.
Para la aplicación ONLYOFFICE se generaron claves de autorización con la URL de redireccionamiento https://service.onlyoffice.com/oauth2.aspx. Cuando un usuario ingresa en ONLYOFFICE con Google, se solicita el código de autorización y la dirección de la página actual del usuario se transfiere al parámetro state.
Después del redireccionamiento a la Google API, la URL https://service.onlyoffice.com/oauth2.aspx redirige automáticamente a la página especificada en el parámetro state. Esto es necesario porque las direcciones y los dominios que usará la aplicación ONLYOFFICE no se conocen de antemano.
Manejo de datos de usuarios de Google dentro de los portales de ONLYOFFICE
Acceso
Conexión de Google a un perfil de usuario
Para ingresar en el portal de ONLYOFFICE con Google desde un perfil de usuario existente, el usuario vincula su cuenta de Google con su cuenta de ONLYOFFICE.
En la página de perfil de usuario de ONLYOFFICE, la sección Iniciar sesión a través de redes sociales tiene un botón de Google:
Al hacer clic en este botón se abre una página de Google que da a la aplicación ONLYOFFICE acceso a los datos con el ámbito siguiente:
Con este ámbito, la aplicación ONLYOFFICE puede:
- ver su información personal, incluida cualquier información personal que Usted ha hecho disponible públicamente;
- visualizar su dirección de correo electrónico.
Esta acción usa la solicitud people.get. La base de datos de ONLYOFFICE almacena la correspondencia entre el identificador y la dirección de correo electrónico del usuario en Google y el identificador del perfil de usuario en ONLYOFFICE.
Ingreso en un portal
La página de autorización de los portales de ONLYOFFICE tiene un botón para ingresar con Google:
Al hacer clic en este botón se abre una página de Google que da a la aplicación ONLYOFFICE acceso a los datos con el ámbito siguiente:
Con este ámbito, la aplicación ONLYOFFICE puede:
- ver su información personal, incluida cualquier información personal que Usted ha hecho disponible públicamente;
- visualizar su dirección de correo electrónico.
Esta acción usa la solicitud people.get. ONLYOFFICE busca en su base de datos la correspondencia entre el identificador y la dirección de correo electrónico del usuario en Google y un identificador de perfil de usuario en ONLYOFFICE. Si la encuentra, el usuario ingresa con ese perfil de ONLYOFFICE.
Ingreso en el sitio web de ONLYOFFICE
La página de ingreso del sitio web de ONLYOFFICE tiene un botón para ingresar con Google:
Al hacer clic en este botón se abre una página de Google que da a la aplicación ONLYOFFICE acceso a los datos con el ámbito siguiente:
Con este ámbito, la aplicación ONLYOFFICE puede:
- ver su información personal, incluida cualquier información personal que Usted ha hecho disponible públicamente;
- visualizar su dirección de correo electrónico.
Esta acción usa la solicitud people.get. ONLYOFFICE busca en todos los portales la correspondencia entre el identificador y la dirección de correo electrónico del usuario en Google y un identificador de perfil de usuario en ONLYOFFICE. Si la encuentra, el usuario ingresa en ese portal con ese perfil de ONLYOFFICE.
Ingreso en ONLYOFFICE Personal
La sección de Acceso de ONLYOFFICE Personal tiene un botón para ingresar con Google:
Al hacer clic en este botón se abre una página de Google que da a la aplicación ONLYOFFICE acceso a los datos con el ámbito siguiente:
Con este ámbito, la aplicación ONLYOFFICE puede:
- ver su información personal, incluida cualquier información personal que Usted ha hecho disponible públicamente;
- visualizar su dirección de correo electrónico.
Esta acción usa la solicitud people.get. ONLYOFFICE busca en su base de datos la correspondencia entre el identificador y la dirección de correo electrónico del usuario en Google y un identificador de perfil de usuario en ONLYOFFICE. Si la encuentra, el usuario ingresa con ese perfil de ONLYOFFICE.
Si no la encuentra, se crea un perfil nuevo con el nombre de usuario y la dirección de correo electrónico de Google, y la base de datos de ONLYOFFICE almacena la correspondencia entre el identificador y la dirección de correo electrónico del usuario en Google y el identificador del nuevo perfil en ONLYOFFICE.
Importación de usuarios
Puede añadir varios perfiles de usuario a su portal de ONLYOFFICE de una vez importando contactos de Google. Para saber cómo hacerlo, consulte este artículo.
En el módulo Personas, la opción Importar Personas tiene un botón para seleccionar Google como fuente de la información de contactos:
Al hacer clic en este botón se abre una página de Google que da a la aplicación ONLYOFFICE acceso a los datos con el ámbito https://www.googleapis.com/auth/contacts.readonly. Con este ámbito, la aplicación ONLYOFFICE puede:
- ver y descargar sus contactos.
Esta acción usa la solicitud Recuperación de todos los contactos. ONLYOFFICE crea nuevos perfiles de usuario en el portal con los nombres y las direcciones de correo electrónico de sus contactos de Google.
Google Drive
Puede conectar su cuenta de Google Drive al módulo Documentos para gestionar y editar los documentos almacenados en Google Drive con los editores de ONLYOFFICE. Para saber cómo hacerlo, consulte Conexión de servicios de terceros.
En el módulo Documentos, el texto Añadir cuenta tiene un botón para seleccionar Google Drive:
Al hacer clic en este botón se abre una página de Google que da a la aplicación ONLYOFFICE acceso a los datos con el ámbito https://www.googleapis.com/auth/drive. Con este ámbito, la aplicación ONLYOFFICE puede:
- ver, editar, crear y eliminar todos sus archivos de Google Drive.
La base de datos de ONLYOFFICE almacena solo la clave de autorización recibida que es necesaria para solicitudes posteriores. Las acciones se realizan con la Biblioteca de cliente de Google API.
Se usan los siguientes métodos:
- obtener la lista de archivos;
- crear un archivo;
- eliminar un archivo;
- actualizar, renombrar y mover un archivo;
- copiar un archivo;
- obtener el tamaño máximo del archivo para subir.
Otros casos del uso de datos de usuarios de Google en ONLYOFFICE
Los usuarios pueden abrir y editar documentos con los editores en línea de ONLYOFFICE directamente en Google Drive con la aplicación ONLYOFFICE Personal. Para este fin se creó la aplicación ONLYOFFICE Personal (api-project-438840568076).
En Google Drive, conecte la aplicación ONLYOFFICE Personal con el botón Nuevo (Nuevo > Más > Conectar más aplicaciones) o desde el menú contextual del archivo (Abrir con > Conectar más aplicaciones):
Después de conectar la aplicación ONLYOFFICE Personal a Google Drive, se añade a la lista una opción para crear archivos (Nuevo > Más > ONLYOFFICE Personal):
La opción también se añade al menú contextual del archivo (Abrir con > ONLYOFFICE Personal):
La opción está disponible para los formatos siguientes:
- los archivos docx, pptx, xlsx, ppsx se abren con ONLYOFFICE Personal por defecto al hacer clic en el nombre del archivo;
- los archivos ppt, pps, odp, doc, odt, rtf, mht, html, htm, fb2, epub, txt, pdf, djvu, xps, xls, csv, ods, fods, fodt, pptm, potx, potm, pot, xlsm, xlt, xltx, xltm, docm, dotx, dotm, ots, otp, ott se abren con ONLYOFFICE Personal desde el menú contextual.
Tanto al crear un archivo nuevo como al abrir un archivo existente con la aplicación ONLYOFFICE Personal, se abre una página de Google que da a la aplicación ONLYOFFICE acceso a los datos con el ámbito siguiente:
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/userinfo.profile
- https://www.googleapis.com/auth/userinfo.email
Con este ámbito, la aplicación ONLYOFFICE puede:
- visualizar, crear, editar y eliminar todos los archivos en Google Drive;
- ver su información personal, incluida cualquier información personal que Usted ha hecho disponible públicamente;
- visualizar su dirección de correo electrónico.
La aplicación ONLYOFFICE Personal solicita los datos de usuario con la solicitud people.get. ONLYOFFICE Personal busca en su base de datos la correspondencia entre el identificador y la dirección de correo electrónico del usuario en Google y un identificador de perfil de usuario en ONLYOFFICE. Si la encuentra, el usuario ingresa con ese perfil de ONLYOFFICE Personal.
Si no la encuentra, se crea un perfil nuevo con el nombre de usuario y la dirección de correo electrónico de Google, y la base de datos de ONLYOFFICE Personal almacena la correspondencia entre el identificador y la dirección de correo electrónico del usuario en Google y el identificador del nuevo perfil en ONLYOFFICE. La base de datos de ONLYOFFICE también almacena la clave de autorización recibida que es necesaria para solicitudes posteriores a la Drive API. Se usan los siguientes métodos:
- crear un archivo;
- descargar un archivo;
- actualizar un archivo.
Política de privacidad
El siguiente documento revela cómo la aplicación ONLYOFFICE solicita, usa y almacena sus datos de usuario de Google.