Integración de Google Sheets

Con el conector de acciones de Google Sheets, puedes acceder a Google Sheets directamente en Amazon Quick a través de un lenguaje natural. Puede crear y editar hojas de cálculo, leer y escribir rangos de celdas, formatear celdas y buscar datos sin salir de Amazon Quick.

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

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

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

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 Sheets.

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

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

Configuración de Google Cloud

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

Para la autenticación personalizada de aplicaciones OAuth, complete 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 Sheets.

Crea un cliente OAuth en Google Cloud Console

Crea un cliente OAuth 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 OAuth 2.0 para acceder a las API de Google 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 API y servicios y, a continuación, selecciona Biblioteca. Busca la API que requiere tu integración y selecciona Activar.

4. Selecciona la pantalla de consentimiento de OAuth 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 cliente OAuth.

7. Configura el cliente:

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

   • Introduzca un nombre para su cliente.

   • En URI de redireccionamiento autorizado, 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

Al conectarse a Google Sheets, se solicitan los siguientes ámbitos.

Ámbitos recomendados por Google Sheets

Alcance	Description (Descripción)
https://www.googleapis.com/auth/spreadsheets	Lee y escribe hojas de cálculo de Google Sheets.
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 consentimiento de OAuth para la autenticación de los usuarios. No son necesarios para OAuth. Service-to-Service

Configuración del conector en Amazon Quick

Conectarse desde la pestaña Disponible

Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte 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 Sheets y selecciona Connect.

3. Complete el flujo de inicio de sesión de Google y conceda los permisos solicitados.

Para configurar un conector con la aplicación OAuth 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 Hojas de cálculo de Google.

   nota

   Si ya existe un conector de Google Sheets, 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 la configuración de OAuth, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.

   1. Para la aplicación OAuth predeterminada:

      No se necesitan credenciales adicionales. Elija Siguiente para continuar.

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

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

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

      • Secreto de cliente: el secreto de cliente de tu cliente OAuth 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: Pre-filled con la URL de devolución de llamada rápida de Amazon.

7. Elija Siguiente.

8. Si seleccionas la aplicación OAuth predeterminada o la aplicación OAuth personalizada, se abrirá 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 en Google Sheets

Categoría	Action	Description (Descripción)
Valores	Obtenga valores	Lee valores de un rango de celdas.
Valores	Batch Get Value	Lee valores de varios rangos de celdas en una sola solicitud.
Valores	Obtenga valores por filtro	Lee los valores mediante un filtro de datos.
Valores	Actualizar valores	Escribe valores en un rango de celdas.
Valores	Valor de actualización por lotes	Escribe valores en varios rangos de celdas en una sola solicitud.
Valores	Añade valores	Añade valores después de la última fila de datos de un rango.
Valores	Eliminar valores	Borra los valores de un rango de celdas.
Valores	Actualizar texto	Busca y reemplaza texto en una hoja de cálculo.
Filas	Crear fila	Crea una nueva fila en una hoja de cálculo.
Filas	Poner filas	Invierte las filas de una hoja de cálculo.
Filas	Obtenga la fila de la hoja de cálculo	Busca una fila según los criterios coincidentes.
Hojas de cálculo	Crea una hoja de cálculo	Crea una nueva hoja de cálculo.
Hojas de cálculo	Obtenga información sobre la hoja de cálculo	Recupera los metadatos de una hoja de cálculo.
Hojas de cálculo	Busca hojas de cálculo	Busca hojas de cálculo.
Hojas	Crear hoja	Añade una hoja nueva a una hoja de cálculo.
Hojas	Lista los nombres de las hojas	Muestra los nombres de las hojas en una hoja de cálculo.
Hojas	Actualice las propiedades de la hoja	Actualiza las propiedades de la hoja, como el nombre o la visibilidad.
Formato	Actualiza el formato de celda	Formatea las celdas de un rango.
Formato	Actualice las reglas de formato condicional	Crea o actualiza las reglas de formato condicional.

nota

Las acciones que puede utilizar dependen de las hojas de cálculo a las 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

• Sign-in falla (aplicación OAuth predeterminada o aplicación OAuth 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 la aplicación OAuth personalizada, confirma que el URI de redireccionamiento de tu cliente OAuth 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 (aplicación OAuth personalizada): comprueba que el ID de cliente y el secreto del cliente coincidan con los valores de tu cliente OAuth 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 con Google Sheets-specific

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