Integración con Google Calendar

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.

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

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

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

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

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

Configuración de Google Cloud

Si utilizas la autenticación de OAuth aplicaciones predeterminada, omite esta sección y ve aConfiguración del conector en Amazon Quick.

Para OAuth la autenticación de aplicaciones personalizadas, completa 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 OAuth cliente en Google Cloud Console

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

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

7. Configure el cliente:

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

   • Introduzca un nombre para su cliente.

   • En Redirección autorizada URIs, 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 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 OAuth consentimiento para la autenticación del usuario. No son necesarios para Service-to-Service OAuth.

Configuración del conector en Amazon Quick

Conectarse desde la pestaña Disponible

Si desea utilizar la autenticación de OAuth aplicaciones predeterminada, puede conectarse 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 Calendar y selecciona Conectar.

3. Completa el flujo de inicio de sesión de Google y concede los permisos solicitados.

En su lugar, para configurar un conector con una OAuth aplicación 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 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.

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

   1. Para la OAuthaplicación predeterminada:

      No se necesitan credenciales adicionales. Elija Siguiente para continuar.

   2. Para OAuth la aplicación personalizada, configure 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 OAuth cliente de Google Cloud.

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

7. Elija Siguiente.

8. Si seleccionas la OAuth aplicación predeterminada o la OAuth aplicación personalizada, se abre 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 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

Para editar, compartir o eliminar el conector, consulteAdministrar las integraciones existentes.

Problemas comunes de autenticación de Google

• No se puede iniciar sesión ( OAuth aplicación predeterminada o OAuth aplicación 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 OAuth la aplicación personalizada, confirma que el URI de redireccionamiento de tu OAuth cliente 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 ( OAuth aplicación personalizada): verifica que el ID de cliente y el secreto del cliente coincidan con los valores de tu OAuth cliente 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 específicos de Google Calendar

• La API de Google Calendar no está habilitada: comprueba que la API de Google Calendar esté habilitada en tu proyecto de Google Cloud en la sección APIs y Servicios de la biblioteca.