

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 Calendar
<a name="google-calendar-integration"></a>

Con el conector de acciones de Google Calendar, puedes acceder a Google Calendar directamente en Amazon Quick a través de un lenguaje natural. Puedes crear y actualizar eventos, comprobar la disponibilidad, gestionar calendarios y organizar a los asistentes sin salir de Amazon Quick.

Amazon Quick admite varios métodos de autenticación para Google Calendar. 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
<a name="google-calendar-integration-prerequisites"></a>

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

Si utilizas la autenticación **por defecto de la aplicación OAuth**, omite esta sección y ve a. [Configuración del conector en Amazon Quick](#google-calendar-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 Calendar**.

### Crea un cliente OAuth en Google Cloud Console
<a name="w2aac49c28c65c13b7"></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-calendar-oauth-scopes"></a>

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


**Ámbitos recomendados por Google Calendar**  

| Alcance | Description (Descripción) | 
| --- | --- | 
| https://www.googleapis.com/auth/calendar | Lee y escribe los eventos y ajustes del calendario. | 
| 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-calendar-quicksuite-setup"></a>

### Conectarse desde la pestaña Disponible
<a name="google-calendar-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 Calendar** y selecciona **Conectar**.

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-calendar-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 selecciona **Google Calendar**.
**nota**  
Si ya existe un conector de Google Calendar, 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 Calendar. Ejemplo: `https://www.googleapis.com/calendar`
      + **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. Ejemplo: `https://oauth2.googleapis.com/token`
      + **URL de autorización**: el punto final de autorización. 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-calendar-integration-actions"></a>

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


**Acciones disponibles en Google Calendar**  

| Categoría | Action | Description (Descripción) | 
| --- | --- | --- | 
| Events (Eventos) | Lista de eventos | Muestra los eventos de un calendario. | 
| Events (Eventos) | Buscar eventos | Busca eventos por palabra clave o criterio. | 
| Events (Eventos) | Obtenga el evento | Recupera los detalles de un evento específico. | 
| Events (Eventos) | Crear evento | Crea un nuevo evento en el calendario. | 
| Events (Eventos) | Crea un evento rápido | Crea un evento a partir de una cadena de texto. | 
| Events (Eventos) | Evento de actualización | Actualiza un evento existente. | 
| Events (Eventos) | Actualizar el calendario de eventos | Mueve un evento a un calendario diferente. | 
| Events (Eventos) | Importar eventos | Importa eventos a un calendario. | 
| Events (Eventos) | Enumere las instancias de eventos | Enumera las instancias de un evento recurrente. | 
| Events (Eventos) | Eliminar asistente | Elimina a un asistente de un evento. | 
| Disponibilidad. | Lista de tragaperras gratis | Busca las franjas horarias disponibles en todos los calendarios. | 
| Calendarios | Listar calendarios | Muestra los calendarios del usuario autenticado. | 
| Calendarios | Listar eventos del calendario | Muestra los eventos de todos los calendarios. | 
| Calendarios | Obtenga el calendario | Recupera los detalles de un calendario específico. | 
| Calendarios | Obtenga la lista de calendarios | Recupera una entrada de la lista de calendarios. | 
| Calendarios | Actualizar la lista de calendarios | Actualiza una entrada de la lista de calendarios. | 
| Configuración | Configuración de la lista | Muestra la configuración del calendario para el usuario. | 
| Utilidades | Obtenga la fecha y hora actuales | Recupera la fecha y hora actuales. | 

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

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