As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Integração com o Gmail
Com o conector de ação do Gmail, você pode acessar o Gmail diretamente no Amazon Quick por meio de linguagem natural. Você pode ler e enviar e-mails, gerenciar etiquetas e rascunhos, organizar tópicos e pesquisar contatos sem sair do Amazon Quick.
O Amazon Quick oferece suporte a vários métodos de autenticação para o Gmail. Escolha o método mais adequado 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 Gmail.
-
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ê usa a autenticação padrão do aplicativo OAuth, pule esta seção e consulte. 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 Gmail.
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
-
Faça login no Console do Google Cloud
no site do Google. -
Crie um novo projeto ou selecione um projeto existente.
-
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.
-
Escolha a tela de consentimento do OAuth e escolha Começar.
-
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.
-
-
Escolha Criar cliente OAuth.
-
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
-
-
Escolha Criar.
-
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 Gmail.
| Escopo | Description |
|---|---|
https://www.googleapis.com/auth/gmail.modify |
Lê, envia e gerencia e-mails e etiquetas. |
https://www.googleapis.com/auth/gmail.send |
Envia e-mails em nome do usuário. |
https://www.googleapis.com/auth/contacts.readonly |
Lê as informações de contato. |
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.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, encontre o Gmail e escolha Conectar.
-
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 a partir da guia Criar para sua equipe
Depois de concluir qualquer configuração necessária do Google Cloud, crie o conector no Amazon Quick.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Encontre e escolha o Gmail.
nota
Se já existir um conector do Gmail, 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.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
Para o aplicativo OAuth personalizado, configure os seguintes campos:
-
URL base (opcional) — O URL base da API do Gmail. Por exemplo:
https://gmail.googleapis.com -
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. Por exemplo:
https://oauth2.googleapis.com/token -
URL de autorização — O endpoint de autorização. Por exemplo:
https://accounts.google.com/o/oauth2/v2/auth -
URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.
-
-
-
Escolha Próximo.
-
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.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
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.
-
Selecione Publish.
Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão disponíveis.
| Categoria | Ação | Description |
|---|---|---|
| Mensagens | Receba e-mails | Recupera e-mails da caixa de correio. |
| Mensagens | Obter mensagem por ID de tópico | Recupera uma mensagem pelo ID do tópico. |
| Mensagens | Obter mensagem por ID de mensagem | Recupera uma mensagem pelo ID da mensagem. |
| Mensagens | Enviar e-mail | Envia uma nova mensagem de e-mail. |
| Mensagens | Enviar resposta ao tópico | Responde a um tópico de e-mail existente. |
| Mensagens | Encaminhar mensagem | Encaminha um e-mail para outros destinatários. |
| Mensagens | Obter anexo | Recupera um anexo de e-mail. |
| Mensagens | Mensagem de atualização em lote | Modifica os rótulos em várias mensagens em uma única operação. |
| Threads | Listar tópicos | Lista os tópicos de e-mail na caixa de correio. |
| Threads | Atualizar rótulos de tópicos | Modifica os rótulos em uma linha de discussão. |
| Lixeira | Excluir e-mail | Move um e-mail para a lixeira. |
| Lixeira | Excluir tópico | Move uma linha para a lixeira. |
| Lixeira | Restaurar mensagem | Restaura um e-mail da lixeira. |
| Lixeira | Restaurar tópico | Restaura um fio da lixeira. |
| Rótulos | Listar rótulos | Lista todas as etiquetas na caixa de correio. |
| Rótulos | Obter etiqueta | Recupera detalhes de uma etiqueta específica. |
| Rótulos | Criar etiqueta | Cria um novo rótulo. |
| Rótulos | Atualizar rótulo | Atualiza as propriedades de um rótulo. |
| Rótulos | Etiqueta: E-mail | Adiciona uma etiqueta a um e-mail. |
| Rascunhos | Rascunhos da lista | Lista rascunhos de e-mail. |
| Rascunhos | Obtenha o rascunho | Recupera um rascunho específico. |
| Rascunhos | Criar rascunho | Cria um novo rascunho de e-mail. |
| Rascunhos | Atualizar rascunho | Atualiza um rascunho existente. |
| Rascunhos | Enviar rascunho | Envia um rascunho existente. |
| Contatos | Pesquisar contatos | Pesquisa contatos por nome ou e-mail. |
| Contatos | Obter contatos | Recupera as informações de contato. |
| Histórico | Histórico da lista | Lista o histórico de alterações da caixa de correio. |
| Configurações | Obter perfil | Recupera o perfil do Gmail do usuário autenticado. |
| Configurações | Receba Enviar como alias | Recupera uma configuração específica de alias de envio como. |
| Configurações | Listar Enviar como aliases | Lista todos os aliases de envio da conta. |
nota
As ações que você pode usar dependem dos dados acessíveis ao usuário autenticado.
Gerenciar e solucionar 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.
Gmail-specific problemas
-
API do Gmail não ativada — verifique se a API do Gmail está ativada em seu projeto do Google Cloud em APIs e Serviços, Biblioteca.
