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 Google Docs
Com o conector de ação do Google Docs, você pode acessar o Google Docs diretamente no Amazon Quick por meio de linguagem natural. Você pode criar e editar documentos, ler conteúdo, inserir texto e imagens e gerenciar a estrutura do documento sem sair do Amazon Quick.
O Amazon Quick oferece suporte a vários métodos de autenticação para o Google Docs. 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, 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 Google Docs.
+ 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](#google-docs-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 Google Docs.**
### 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 Google Docs.
**Escopos recomendados pelo Google Docs**
| Escopo | Description |
| --- | --- |
| https://www.googleapis.com/auth/documents | Lê e grava documentos do Google Docs. |
| https://www.googleapis.com/auth/drive | Lê e grava arquivos no Google Drive. |
| https://www.googleapis.com/auth/drive.readonly | Lê arquivos no Google Drive. |
| 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 **Google Docs** e escolha **Connect**.
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 **Google Docs.**
**nota**
Se já existir um conector do Google Docs, 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 Google Docs. Por exemplo: `https://docs.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 Google Docs**
| Categoria | Ação | Description |
| --- | --- | --- |
| Documentos | Obter documento | Recupera um documento por ID. |
| Documentos | Obter texto simples do documento | Recupera o conteúdo de texto sem formatação de um documento. |
| Documentos | Pesquisar documentos | Pesquisa documentos. |
| Documentos | Criar documento | Cria um novo documento. |
| Documentos | Criar marcação de documentos | Cria um novo documento a partir do conteúdo do Markdown. |
| Documentos | Copiar documento | Cria uma cópia de um documento existente. |
| Documentos | Atualizar documento | Atualiza um documento existente. |
| Documentos | Atualizar o Markdown do documento | Atualiza um documento com conteúdo Markdown. |
| Documentos | Atualizar seção do documento | Atualiza uma seção específica de um documento com o Markdown. |
| Documentos | Atualizar estilo do documento | Atualiza o estilo de um documento. |
| Documentos | Exportar PDF | Exporta um documento como um arquivo PDF. |
| Conteúdo | Inserir texto | Insere texto em um local especificado. |
| Conteúdo | Atualizar texto | Substitui todas as ocorrências do texto especificado. |
| Conteúdo | Excluir intervalo de conteúdo | Exclui conteúdo dentro de um intervalo especificado. |
| Conteúdo | Inserir imagem embutida | Insere uma imagem embutida em um documento. |
| Conteúdo | Criar tabela | Insere uma tabela em um documento. |
| Conteúdo | Crie marcadores de parágrafos | Adiciona formatação de bullet aos parágrafos. |
| Conteúdo | Criar intervalo nomeado | Cria um intervalo nomeado em um documento. |
| Conteúdo | Criar quebra de página | Insere uma quebra de página. |
| Estrutura | Criar cabeçalho | Cria um cabeçalho em um documento. |
| Estrutura | Criar rodapé | Cria um rodapé em um documento. |
**nota**
As ações que você pode usar dependem dos documentos acessíveis ao usuário autenticado.
## Gerenciamento e solução de 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.
### Docs-specific Problemas do Google
+ **API do Google Docs não ativada** **— verifique se a API do Google Docs está ativada em seu projeto do Google Cloud em **APIs e Serviços**, Biblioteca.**