View a markdown version of this page

Conector de acción de Google Drive - Amazon Quick

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conector de acción de Google Drive

Con el conector de acción de Google Drive, puedes acceder a Google Drive directamente en Amazon Quick a través de un lenguaje natural. Puedes cargar y descargar archivos, gestionar carpetas, buscar contenido y realizar un seguimiento de los cambios sin salir de Amazon Quick.

Amazon Quick admite varios métodos de autenticación para el conector de acciones de Google Drive. 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 Drive.

  • 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 Drive.

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

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

Ámbitos recomendados por Google Drive
Alcance Description (Descripción)
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.
https://www.googleapis.com/auth/drive.metadata.readonly Lee los metadatos de los 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 Drive y selecciona Conectar.

  3. Completa el flujo de inicio de sesión de Google y concede 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 Google Drive.

    nota

    Si ya existe un conector de Google Drive, 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 Drive. Por ejemplo: https://www.googleapis.com/drive

      • 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 Drive
Categoría Action Description (Descripción)
Archivos Obtener el archivo Descarga un archivo de Google Drive.
Archivos Busca archivos Busca archivos por nombre o contenido.
Archivos Obtenga metadatos de archivos Recupera los metadatos de un archivo.
Archivos Importar archivo Carga un archivo a Google Drive.
Archivos Sube el archivo desde la URL Carga un archivo desde una URL.
Archivos Crear archivo Crea un archivo nuevo.
Archivos Crear archivo a partir del texto Crea un archivo a partir del contenido de texto.
Archivos Poner archivo Sustituye el contenido de un archivo existente.
Archivos Actualizar el contenido del archivo Edita el contenido de un archivo existente.
Archivos Actualiza la ubicación del archivo Mueve un archivo a una carpeta diferente.
Archivos Copiar archivo Crea una copia de un archivo.
Archivos Exportar archivo Exporta un archivo de Google Workspace a un formato diferente.
Archivos Eliminar archivo Mueve un archivo a la papelera.
Carpetas Crear carpeta Crea una carpeta nueva.
Carpetas Busca carpetas Busca carpetas por nombre.
Permisos Listar permisos Muestra los permisos de un archivo o una carpeta.
Comentarios Lista de comentarios Muestra los comentarios de un archivo.
Cambios Enumere los cambios Muestra los cambios recientes en los archivos.
Cambios Obtenga el token de la página de inicio de Changes Recupera un token de página de inicio para realizar un seguimiento de los cambios.
Conduce Obtenga información sobre la conducción Recupera información sobre la unidad Drive del usuario.
nota

Las acciones que puedes usar dependen de los archivos y carpetas a los que pueda acceder el usuario autenticado.

Administració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 Drive-specific

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