View a markdown version of this page

Integração com Google Slides - Amazon Quick

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 Google Slides

Com o conector de ação do Google Slides, você pode acessar o Google Slides diretamente no Amazon Quick por meio de linguagem natural. Você pode criar apresentações, editar slides, copiar modelos e recuperar o conteúdo da apresentação sem sair do Amazon Quick.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Google Slides. 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.

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

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

Escopos recomendados pelo Google Slides
Escopo Description
https://www.googleapis.com/auth/presentations Lê e grava apresentações do Google Slides.
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 Slides 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 Slides.

    nota

    Se já existir um conector do Google Slides, 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 Google Slides. Por exemplo: https://slides.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 Slides
Categoria Ação Description
Apresentações Obtenha a apresentação Recupera uma apresentação por ID.
Apresentações Criar apresentação Cria uma nova apresentação.
Apresentações Criar Slides Markdown Cria slides a partir do conteúdo do Markdown.
Apresentações Copiar modelo de apresentação Cria uma apresentação a partir de um modelo.
Apresentações Apresentação do Batch Update Aplica várias atualizações a uma apresentação em uma única solicitação.
Páginas Obtenha a página de apresentação Recupera uma página específica de uma apresentação.
nota

As ações que você pode usar dependem das apresentações 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.

Slides-specific Problemas do Google

  • API do Google Slides não ativada — verifique se a API do Google Slides está ativada em seu projeto do Google Cloud em APIs e serviços, Biblioteca.