Integração com o Google Calendar

Com o conector de ação do Google Calendar, você pode acessar o Google Calendar diretamente no Amazon Quick por meio de linguagem natural. Você pode criar e atualizar eventos, verificar a disponibilidade, gerenciar calendários e organizar participantes sem sair do Amazon Quick.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Google Calendar. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.

• Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Você se autentica diretamente com sua conta do Google.

• Aplicativo OAuth personalizado — usa um cliente OAuth gerenciado pelo cliente criado no Console do Google Cloud. Essa opção dá à sua organização controle total sobre a configuração do OAuth.

Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Verifique se você tem o seguinte antes de configurar a integração.

• Uma conta do Google com acesso ao Google Calendar.

• Para um aplicativo OAuth personalizado: acesso ao Console do Google Cloud no site do Google com permissões para criar clientes OAuth.

• Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando o Google Cloud

Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e acesse. Configurando o conector no Amazon Quick

Para a autenticação personalizada do aplicativo OAuth, conclua as etapas a seguir no Console do Google Cloud antes de configurar o Amazon Quick. Ao ativar a API na etapa 3, pesquise e ative a API do Google Calendar.

Crie um cliente OAuth no Google Cloud Console

Crie um cliente OAuth no Console do Google Cloud para obter as credenciais de cliente necessárias para o Amazon Quick. Para obter mais informações, consulte Como usar o OAuth 2.0 para acessar as APIs do Google no site do Google.

1. Faça login no Console do Google Cloud no site do Google.

2. Crie um novo projeto ou selecione um projeto existente.

3. No painel de navegação esquerdo, escolha APIs e serviços e, em seguida, escolha Biblioteca. Pesquise a API que sua integração exige e escolha Ativar.

4. Escolha a tela de consentimento do OAuth e escolha Começar.

5. Configure a tela de consentimento:

   • Insira o nome do aplicativo e selecione um e-mail de suporte ao usuário.

   • Em Audience, escolha Interno (somente para sua organização) ou Externo (qualquer usuário do Google).

   • Adicione os detalhes de contato do desenvolvedor e escolha Criar.

6. Escolha Criar cliente OAuth.

7. Configure o cliente:

   • Em Tipo de aplicativo, escolha Aplicativo Web.

   • Insira um nome para seu cliente.

   • Em URIs de redirecionamento autorizados, adicione o URL de retorno de chamada do Amazon Quick: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Escolha Criar.

9. Registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.

   • ID do cliente

   • Segredo do cliente

Escopos recomendados

Os escopos a seguir são solicitados quando você se conecta ao Google Agenda.

Escopos recomendados pelo Google Agenda

Escopo	Description
https://www.googleapis.com/auth/calendar	Lê e grava eventos e configurações do calendário.
openid	Autentica a identidade do usuário.
email	Lê o endereço de e-mail do usuário.

nota

Os email escopos openid e são incluídos automaticamente no fluxo de consentimento do OAuth para autenticação do usuário. Eles não são necessários para o Service-to-Service OAuth.

Configurando o conector no Amazon Quick

Conecte-se a partir da guia Disponível

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.

1. No console do Amazon Quick, escolha Conectores.

2. Na guia Disponível, encontre o Google Calendar e escolha Connect.

3. Conclua o fluxo de login do Google e conceda as permissões solicitadas.

Em vez disso, para configurar um conector com o aplicativo OAuth personalizado, use a guia Criar para sua equipe, conforme descrito abaixo.

Crie na guia Criar para sua equipe

Depois de concluir qualquer configuração necessária do Google Cloud, crie o conector no Amazon Quick.

1. No console do Amazon Quick, escolha Conectores.

2. Escolha a guia Criar para sua equipe.

3. Encontre e escolha o Google Calendar.

   nota

   Se já existir um conector do Google Agenda, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.

4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

5. Em Tipo de conexão, escolha Rede pública.

6. Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.

   1. Para o aplicativo OAuth padrão:

      Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.

   2. Para o aplicativo OAuth personalizado, configure os seguintes campos:

      • URL base (opcional) — O URL base da API do Google Calendar. Exemplo: https://www.googleapis.com/calendar

      • ID do cliente — O ID do cliente do Google Cloud OAuth.

      • Segredo do cliente — O segredo do cliente do Google Cloud OAuth.

      • URL do token — O endpoint do token. Exemplo: https://oauth2.googleapis.com/token

      • URL de autorização — O endpoint de autorização. Exemplo: https://accounts.google.com/o/oauth2/v2/auth

      • URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.

7. Escolha Próximo.

8. Se você escolher o aplicativo OAuth padrão ou o aplicativo OAuth personalizado, uma janela de autorização do Google será aberta. Revise as permissões solicitadas e escolha Permitir.

9. Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.

10. Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, as ações a seguir estarão disponíveis.

Ações disponíveis do Google Agenda

Categoria	Ação	Description
Eventos	Listar eventos	Lista eventos em um calendário.
Eventos	Pesquisar eventos	Pesquisa eventos por palavra-chave ou critério.
Eventos	Obter evento	Recupera detalhes de um evento específico.
Eventos	Criar evento	Cria um novo evento no calendário.
Eventos	Crie um evento rápido	Cria um evento a partir de uma sequência de texto.
Eventos	Evento de atualização	Atualiza um evento existente.
Eventos	Atualizar calendário de eventos	Move um evento para um calendário diferente.
Eventos	Importar eventos	Importa eventos para um calendário.
Eventos	Listar instâncias de eventos	Lista instâncias de um evento recorrente.
Eventos	Excluir participante	Remove um participante de um evento.
Disponibilidade	Listar slots grátis	Encontra os horários disponíveis em todos os calendários.
Calendários	Listar calendários	Lista os calendários do usuário autenticado.
Calendários	Listar eventos do calendário	Lista eventos em todos os calendários.
Calendários	Obtenha o calendário	Recupera detalhes de um calendário específico.
Calendários	Obter lista de calendários	Recupera uma entrada da lista de calendários.
Calendários	Atualizar lista de calendários	Atualiza uma entrada da lista de calendários.
Configurações	Configurações da lista	Lista as configurações de calendário para o usuário.
Serviços públicos	Obter data e hora atual	Recupera a data e a hora atuais.

nota

As ações que você pode usar dependem dos calendários acessíveis ao usuário autenticado.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas comuns de autenticação do Google

• Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta do Google está ativa e se você pode fazer login diretamente no site do Google. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu cliente Google Cloud OAuth corresponde ao URL de retorno de chamada do Amazon Quick.

• Aplicativo bloqueado pelo administrador: se o administrador do Google Workspace restringir o acesso a aplicativos de terceiros, talvez você veja um erro ao tentar fazer login. Entre em contato com seu administrador do Google Workspace para permitir o aplicativo Amazon Quick.

• Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores do seu cliente Google Cloud OAuth.

• O pop-up de autenticação falha — Verifique se seu navegador permite pop-ups do domínio do console Amazon Quick. Tente usar um navegador diferente ou limpar o cache do navegador.

• Permissões revogadas — Se você revogou anteriormente o Amazon Quick Access nas configurações de permissões da sua Conta do Google, você precisa se autenticar novamente editando o conector e fazendo login novamente.

• Limitação da taxa de API do Google — o Google pode limitar as solicitações durante períodos de alto uso. Se as ações falharem, tente novamente após alguns minutos.

Calendar-specific Problemas do Google

• API do Google Calendar não ativada — Verifique se a API do Google Calendar está ativada no seu projeto do Google Cloud em APIs e Serviços, Biblioteca.