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.
# Integración con Google Docs
Con el conector de acciones de Google Docs, puedes acceder a Google Docs directamente en Amazon Quick mediante lenguaje natural. Puede 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.
+ 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, consulte[Métodos de autenticación](quick-action-auth.md).
## 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 **aplicación OAuth personalizada**: accede a [Google Cloud Console](https://console.cloud.google.com/) en el sitio web de Google con permisos para crear clientes de OAuth.
+ Para conocer los requisitos de suscripción a Amazon Quick, consulte[Configurar integraciones en la consola](integration-console-setup-process.md).
## Configuración de Google Cloud
Si utilizas la autenticación de **la aplicación OAuth predeterminada**, omite esta sección y consulta. [Configuración del conector en Amazon Quick](#google-docs-quicksuite-setup)
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 Docs**.
### 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](https://developers.google.com/identity/protocols/oauth2).
1. Inicia sesión en [Google Cloud Console en el sitio](https://console.cloud.google.com/) web de Google.
1. Crea un proyecto nuevo o selecciona uno existente.
1. 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**.
1. Selecciona la **pantalla de consentimiento de OAuth** y selecciona **Comenzar**.
1. 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**.
1. Selecciona **Crear cliente OAuth.**
1. 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`
1. Seleccione **Crear**.
1. 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 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**.
1. En la pestaña **Disponible**, busca **Google Docs** y selecciona **Connect**.
1. 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**.
1. Selecciona la pestaña **Crear para tu equipo**.
1. 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**.
1. Introduzca un **nombre** para el conector. Si lo desea, elija **\+ Añadir descripción** para añadir una descripción.
1. En **Tipo de conexión**, elija **Red pública**.
1. 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.
1. Para la **aplicación OAuth personalizada**, configura 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 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.
1. Elija **Siguiente**.
1. 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.**
1. **En la página de revisión, revise las acciones disponibles para el conector.** Elija **Siguiente**.
1. 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.
1. 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 un 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, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).
### 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](https://accounts.google.com) 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 Docs-specific
+ 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 **API y servicios** de la **biblioteca**.