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, 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 Docs.

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

2. Na guia Disponível, encontre o Google Docs 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 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.

2. Escolha a guia Criar para sua equipe.

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

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

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

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.