

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 Slides
<a name="google-slides-integration"></a>

Con el conector de acciones de Google Slides, puedes acceder a Google Slides directamente en Amazon Quick a través de un lenguaje natural. Puedes crear presentaciones, editar diapositivas, copiar plantillas y recuperar el contenido de la presentación sin salir de Amazon Quick.

Amazon Quick admite varios métodos de autenticación para Google Slides. Elige el método que mejor se adapte a los requisitos de seguridad de tu 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
<a name="google-slides-integration-prerequisites"></a>

Asegúrese de disponer de lo siguiente antes de configurar la integración.
+ Una cuenta de Google con acceso a Google Slides.
+ 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
<a name="google-slides-source-setup"></a>

Si utilizas la autenticación **predeterminada de la aplicación OAuth**, omite esta sección y consulta. [Configuración del conector en Amazon Quick](#google-slides-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 Slides**.

### Crea un cliente OAuth en Google Cloud Console
<a name="w2aac49c28c85c13b7"></a>

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
<a name="google-slides-oauth-scopes"></a>

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


**Ámbitos recomendados por Google Slides**  

| Alcance | Description (Descripción) | 
| --- | --- | 
| https://www.googleapis.com/auth/presentations | Lee y escribe presentaciones de Google Slides. | 
| 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
<a name="google-slides-quicksuite-setup"></a>

### Conectarse desde la pestaña Disponible
<a name="google-slides-quick-connect"></a>

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 Slides** 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
<a name="google-slides-full-setup"></a>

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 elige **Google Slides**.
**nota**  
Si ya existe un conector para Google Slides, 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 Slides. Por ejemplo: `https://slides.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
<a name="google-slides-integration-actions"></a>

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


**Acciones disponibles de Google Slides**  

| Categoría | Action | Description (Descripción) | 
| --- | --- | --- | 
| Presentaciones | Obtenga una presentación | Recupera una presentación por ID. | 
| Presentaciones | Crear presentación | Crea una nueva presentación. | 
| Presentaciones | Crea diapositivas Markdown | Crea diapositivas a partir del contenido de Markdown. | 
| Presentaciones | Copiar plantilla de presentación | Crea una presentación a partir de una plantilla. | 
| Presentaciones | Presentación de Batch Update | Aplica varias actualizaciones a una presentación en una sola solicitud. | 
| Páginas | Obtenga la página de presentación | Recupera una página específica de una presentación. | 

**nota**  
Las acciones que puede utilizar dependen de las presentaciones a las que pueda acceder el usuario autenticado.

## Gestión y solución de problemas
<a name="google-slides-integration-troubleshooting"></a>

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
<a name="w2aac49c28c85c19b5"></a>
+ **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 Slides-specific
<a name="google-slides-troubleshooting-service"></a>
+ La **API de Google Slides no está habilitada**: verifica que la API de Google Slides esté habilitada en tu proyecto de Google Cloud en la sección **API y servicios** de la **biblioteca**.