Integración con Google Docs

Con el conector de acciones de Google Docs, puedes acceder a Google Docs directamente en Amazon Quick a través de un lenguaje natural. Puedes crear y editar documentos, leer contenido, insertar texto e imágenes y gestionar la estructura de los documentos sin salir de Amazon Quick.

Amazon Quick admite varios métodos de autenticación para Google Docs. Elija el método que mejor se adapte a los requisitos de seguridad de su organización.

• OAuth Aplicación predeterminada: utiliza una OAuth aplicación AWS gestionada. No se necesitan credenciales adicionales. Te autenticas directamente con tu cuenta de Google.

• OAuth Aplicación personalizada: usa un cliente administrado por el OAuth cliente creado en Google Cloud Console. Esta opción le da a tu organización un control total sobre la OAuth configuración.

Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Asegúrese de disponer de lo siguiente antes de configurar la integración.

• Una cuenta de Google con acceso a Google Docs.

• Para una OAuth aplicación personalizada: accede a Google Cloud Console en el sitio web de Google con permisos para crear OAuth clientes.

• Para conocer los requisitos de suscripción a Amazon Quick, consulteConfigurar las integraciones en la consola.

Configuración de Google Cloud

Si utilizas la autenticación de OAuth aplicaciones predeterminada, omite esta sección y consultaConfiguración del conector en Amazon Quick.

Para OAuth la autenticación de aplicaciones personalizadas, completa los siguientes pasos en Google Cloud Console antes de configurar Amazon Quick. Cuando habilites la API en el paso 3, busca y habilita la API de Google Docs.

Crea un OAuth cliente en Google Cloud Console

Crea un OAuth cliente en Google Cloud Console para obtener las credenciales de cliente que necesitas para Amazon Quick. Para obtener más información, consulta Cómo usar la OAuth versión 2.0 para acceder a Google APIs en el sitio web de Google.

1. Inicia sesión en Google Cloud Console en el sitio web de Google.

2. Crea un proyecto nuevo o selecciona uno existente.

3. En el panel de navegación izquierdo, selecciona APIs & Servicios y, a continuación, Biblioteca. Busca la API que requiere tu integración y selecciona Activar.

4. Selecciona la pantalla de OAuth consentimiento y selecciona Comenzar.

5. Configura la pantalla de consentimiento:

   • Introduzca un nombre de aplicación y seleccione un correo electrónico de asistencia al usuario.

   • En Audience, selecciona Interno (solo para tu organización) o Externo (para cualquier usuario de Google).

   • Añade los datos de contacto del desarrollador y selecciona Crear.

6. Selecciona Crear OAuth cliente.

7. Configure el cliente:

   • En Tipo de aplicación, elija Aplicación web.

   • Introduzca un nombre para su cliente.

   • En Redirección autorizada URIs, añade la URL de devolución de llamada rápida de Amazon: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Seleccione Crear.

9. Registre los siguientes valores. Los necesitas cuando configuras Amazon Quick.

   • ID de cliente

   • Secreto del cliente

Ámbitos recomendados

Cuando te conectas a Google Docs, se solicitan los siguientes ámbitos.

Ámbitos recomendados por Google Docs

Alcance	Description (Descripción)
https://www.googleapis.com/auth/documents	Lee y escribe documentos de Google Docs.
https://www.googleapis.com/auth/drive	Lee y escribe archivos en Google Drive.
https://www.googleapis.com/auth/drive.readonly	Lee archivos en Google Drive.
openid	Autentica la identidad del usuario.
email	Lee la dirección de correo electrónico del usuario.

nota

Los email ámbitos openid y se incluyen automáticamente en el flujo de OAuth consentimiento para la autenticación del usuario. No son necesarios para Service-to-Service OAuth.

Configuración del conector en Amazon Quick

Conectarse desde la pestaña Disponible

Si desea utilizar la autenticación de OAuth aplicaciones predeterminada, puede conectarse directamente desde la pestaña Disponible sin necesidad de realizar ninguna configuración adicional.

1. En la consola Amazon Quick, selecciona Connectors.

2. En la pestaña Disponible, busca Google Docs y selecciona Connect.

3. Completa el flujo de inicio de sesión de Google y concede los permisos solicitados.

En su lugar, para configurar un conector con una OAuth aplicación personalizada, usa la pestaña Crear para tu equipo, tal y como se describe a continuación.

Crea desde la pestaña Crear para tu equipo

Tras completar cualquier configuración de Google Cloud requerida, crea el conector en Amazon Quick.

1. En la consola Amazon Quick, selecciona Connectors.

2. Selecciona la pestaña Crear para tu equipo.

3. Busca y selecciona Google Docs.

   nota

   Si ya existe un conector de Google Docs, aparecerá un cuadro de diálogo con los conectores existentes. Para usar un conector existente, elíjalo. Para crear uno nuevo, elija No, crear nuevo.

4. Introduzca un nombre para el conector. Si lo desea, elija + Añadir descripción para añadir una descripción.

5. En Tipo de conexión, elija Red pública.

6. Para OAuth la configuración, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.

   1. Para la OAuthaplicación predeterminada:

      No se necesitan credenciales adicionales. Elija Siguiente para continuar.

   2. Para OAuth la aplicación personalizada, configure los siguientes campos:

      • URL base (opcional): la URL base de la API de Google Docs. Por ejemplo: https://docs.googleapis.com

      • ID de cliente: el ID de cliente de tu OAuth cliente de Google Cloud.

      • Secreto de cliente: el secreto de cliente de tu OAuth cliente de Google Cloud.

      • URL del token: el punto final del token. Por ejemplo: https://oauth2.googleapis.com/token

      • URL de autorización: el punto final de autorización. Por ejemplo: https://accounts.google.com/o/oauth2/v2/auth

      • URL de redireccionamiento: se rellena previamente con la URL de devolución de llamada rápida de Amazon.

7. Elija Siguiente.

8. Si seleccionas la OAuth aplicación predeterminada o la OAuth aplicación personalizada, se abre una ventana de autorización de Google. Revisa los permisos solicitados y selecciona Permitir.

9. En la página de revisión, revise las acciones disponibles para el conector. Elija Siguiente.

10. En la página de publicación, elija quién puede acceder al conector. Puedes habilitar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.

11. Elija Publicar.

Acciones disponibles

Tras configurar el conector, estarán disponibles las siguientes acciones.

Acciones disponibles de Google Docs

Categoría	Action	Description (Descripción)
Documentos	Obtenga el documento	Recupera un documento por ID.
Documentos	Obtenga el texto sin formato del documento	Recupera el contenido de texto plano de un documento.
Documentos	Busca documentos	Busca documentos.
Documentos	Crear documento	Crea un documento nuevo.
Documentos	Crea un documento Markdown	Crea un nuevo documento a partir del contenido de Markdown.
Documentos	Copia el documento	Crea una copia de un documento existente.
Documentos	Actualizar documento	Actualiza un documento existente.
Documentos	Actualiza el Markdown del documento	Actualiza un documento con contenido de Markdown.
Documentos	Sección de actualización de documentos	Actualiza una sección específica de un documento con Markdown.
Documentos	Actualiza el estilo del documento	Actualiza el estilo de un documento.
Documentos	Exportar PDF	Exporta un documento como archivo PDF.
Contenidos	Inserta texto	Inserta texto en una ubicación específica.
Contenidos	Actualizar texto	Sustituye todas las apariciones del texto especificado.
Contenidos	Eliminar rango de contenido	Elimina el contenido de un rango específico.
Contenidos	Inserta una imagen en línea	Inserta una imagen en línea en un documento.
Contenidos	Crear tabla	Inserta una tabla en un documento.
Contenidos	Crea viñetas de párrafo	Añade formato de bullet a los párrafos.
Contenidos	Cree un rango con nombre	Crea un rango con nombre en un documento.
Contenidos	Crea un salto de página	Inserta un salto de página.
Estructura	Crear encabezado	Crea un encabezado en un documento.
Estructura	Crear pie de página	Crea un pie de página en un documento.

nota

Las acciones que puede utilizar dependen de los documentos a los que pueda acceder el usuario autenticado.

Gestión y solución de problemas

Para editar, compartir o eliminar el conector, consulteAdministrar las integraciones existentes.

Problemas comunes de autenticación de Google

• No se puede iniciar sesión ( OAuth aplicación predeterminada o OAuth aplicación personalizada): comprueba que tu cuenta de Google esté activa y que puedas iniciar sesión directamente en el sitio web de Google. En el caso de OAuth la aplicación personalizada, confirma que el URI de redireccionamiento de tu OAuth cliente de Google Cloud coincide con la URL de devolución de llamada rápida de Amazon.

• Aplicación bloqueada por el administrador: si el administrador de Google Workspace restringe el acceso a aplicaciones de terceros, es posible que veas un error al intentar iniciar sesión. Ponte en contacto con el administrador de Google Workspace para permitir la aplicación Amazon Quick.

• Credenciales de cliente no válidas ( OAuth aplicación personalizada): verifica que el ID de cliente y el secreto del cliente coincidan con los valores de tu OAuth cliente de Google Cloud.

• La ventana emergente de autenticación falla: compruebe que su navegador permite ventanas emergentes del dominio de Amazon Quick console. Intente utilizar un navegador diferente o borrar la memoria caché del navegador.

• Permisos revocados: si anteriormente revocaste el acceso rápido a Amazon desde la configuración de permisos de tu cuenta de Google, tendrás que volver a autenticarte editando el conector e iniciando sesión de nuevo.

• Limitación de la velocidad de las API de Google: es posible que Google limite las solicitudes durante los períodos de uso intensivo. Si las acciones fallan, vuelve a intentarlo transcurridos unos minutos.

Problemas específicos de Google Docs

• La API de Google Docs no está habilitada: verifica que la API de Google Docs esté habilitada en tu proyecto de Google Cloud en la sección APIs y Servicios de la biblioteca.