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 Analytics
Com o conector de ação do Google Analytics, você pode acessar o Google Analytics diretamente no Amazon Quick por meio de linguagem natural. Você pode gerar relatórios, recuperar dados do público, monitorar eventos importantes e acessar métricas em tempo real sem sair do Amazon Quick.
O Amazon Quick oferece suporte a vários métodos de autenticação para o Google Analytics. 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 às propriedades e dados do Google Analytics que você deseja usar.
+ 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ê estiver usando a autenticação **padrão do aplicativo OAuth**, pule esta seção e acesse. [Configurando o conector no Amazon Quick](#google-analytics-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 de dados do Google Analytics**.
### 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 Analytics.
**Escopos recomendados pelo Google Analytics**
| Escopo | Description |
| --- | --- |
| https://www.googleapis.com/auth/analytics.readonly | Lê os dados e a configuração do Analytics. |
| https://www.googleapis.com/auth/analytics.edit | Edita a configuração e os dados do Analytics. |
| 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 Analytics** 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 Analytics**.
**nota**
Se um conector do Google Analytics já existir, 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 Analytics. Exemplo: `https://analyticsdata.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. Exemplo: `https://oauth2.googleapis.com/token`
+ **URL de autorização** — O endpoint de autorização. 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 Analytics**
| Categoria | Ação | Description |
| --- | --- | --- |
| Relatórios | Criar relatório | Gera um relatório para uma propriedade. |
| Relatórios | Relatório de criação em lote | Executa vários relatórios em uma única solicitação. |
| Relatórios | Criar relatório em tempo real | Executa um relatório em tempo real para uma propriedade. |
| Relatórios | Criar relatório de funil | Executa um relatório de funil para uma propriedade. |
| Públicos | Listar públicos | Lista os públicos de uma propriedade. |
| Públicos | Criar lista de públicos-alvo | Cria uma lista de públicos para exportação. |
| Públicos | Listar listas de públicos | Lista as listas de público de uma propriedade. |
| Públicos | Obtenha a lista de públicos | Recupera dados de uma lista de públicos. |
| Públicos | Criar exportação de público | Cria uma exportação de público. |
| Públicos | Obtenha o Audience Export | Recupera dados de uma exportação de público. |
| Contas | Listar resumos de contas | Lista os resumos da conta acessíveis ao usuário. |
| Contas | Listar contas | Lista todas as contas acessíveis ao usuário. |
| Contas | Obter conta | Recupera detalhes de uma conta específica. |
| Propriedades | Adquira a propriedade | Recupera detalhes de uma propriedade específica. |
| Propriedades | Pesquisar propriedades | Pesquisa propriedades com filtragem. |
| Propriedades | Obtenha cotas de propriedade | Recupera o uso da cota de uma propriedade. |
| Eventos | Listar os principais eventos | Lista os principais eventos (conversões) de uma propriedade. |
| Metadados | Obter metadados | Recupera as dimensões e métricas disponíveis para geração de relatórios. |
| Metadados | Obtenha compatibilidade | Verifica a compatibilidade das dimensões e métricas de um relatório. |
| Anotações | Listar anotações | Lista as anotações de dados de relatórios de uma propriedade. |
**nota**
As ações que você pode usar dependem das propriedades e contas do Analytics 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.
### Analytics-specific Problemas do Google
+ **API de dados do Google Analytics não ativada** — verifique se a API de dados do Google Analytics está ativada em seu projeto do Google Cloud em **APIs e serviços**, **biblioteca**.
+ **Nenhuma propriedade visível** — verifique se a conta do Google autenticada tem acesso às propriedades do Google Analytics que você deseja consultar.