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, consulte[Métodos de autenticação](quick-action-auth.md).
## 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](https://console.cloud.google.com/) no site do Google com permissões para criar clientes OAuth.
+ Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md).
## 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](#gmail-quicksuite-setup)
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](https://developers.google.com/identity/protocols/oauth2) do Google.
1. Faça login no [Console do Google Cloud](https://console.cloud.google.com/) no site do Google.
1. Crie um novo projeto ou selecione um projeto existente.
1. **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**.
1. Escolha a **tela de consentimento do OAuth** e escolha **Começar**.
1. 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**.
1. Escolha **Criar cliente OAuth.**
1. 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`
1. Escolha **Criar**.
1. 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.
**Escopos recomendados pelo 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.
1. No console do Amazon Quick, escolha **Conectores**.
1. Na guia **Disponível**, encontre o **Gmail** e escolha **Conectar**.
1. 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.
1. No console do Amazon Quick, escolha **Conectores**.
1. Escolha a guia **Criar para sua equipe**.
1. 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**.
1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição.
1. Em **Tipo de conexão**, escolha **Rede pública**.
1. 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.
1. 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.
1. Escolha **Próximo**.
1. 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**.
1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**.
1. 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.
1. 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 Gmail**
| 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, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
### 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](https://accounts.google.com) 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.**