Conectando o Google Trends

A conexão com o Google Trends é feita pelo login Google (OAuth): você entra com a sua conta e autoriza a permissão na tela de consentimento do próprio Google. Nenhuma senha é digitada na Toca. Como o Google não publica uma API do Trends, a Toca consulta o dataset público do Google Trends no BigQuery — por isso, além do login, você escolhe um projeto do Google Cloud, que é onde as consultas rodam. A integração pode estar em liberação gradual: se o card não aparecer para a sua conta em Configurações → Integrações, fale com o suporte.

Antes de começar

• Tenha em mãos a conta Google que você quer conectar.
• Tenha um projeto do Google Cloud com faturamento ativo acessível por essa conta: as consultas rodam no BigQuery e são cobradas desse projeto (na ordem de centavos por consulta; o custo exato depende da tarifa do BigQuery — confirme na documentação oficial do Google).
• O consentimento do Google é por integração: conectar o Google Trends não autoriza o Gmail nem as outras integrações Google. Cada uma tem o próprio card e o próprio pedido de permissão.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Google Trends e clique no botão de conexão.
3. Na tela do Google, escolha a conta e autorize a permissão de leitura do BigQuery.
4. De volta ao card, escolha no seletor o projeto do Google Cloud que vai executar as consultas. A integração só fica ativa depois dessa escolha, e você pode trocar o projeto no próprio card quando quiser.

O que a Toca acessa

Com a conexão ativa, a Toca consulta o que está em alta nas buscas do Google: os termos mais buscados e os que mais cresceram, por semana, no Brasil e por estado, para cruzar com a sazonalidade da sua loja. Os valores são posição no ranking, score relativo (0 a 100 dentro da semana) e percentual de crescimento — não há volume absoluto de buscas.

Esta integração é somente leitura: a Toca não altera nada na sua conta Google nem no seu BigQuery. O que existe de escrita nas outras integrações Google não se aplica aqui.

Manutenção da conexão

A conexão usa tokens que a Toca renova automaticamente: ela permanece ativa até você desconectar a integração na Toca ou revogar o acesso nas configurações da sua conta Google. Se o acesso for revogado no Google, as consultas param de funcionar e é preciso refazer a conexão pelo card em Configurações → Integrações. O projeto escolhido continua valendo até você selecionar outro no card.

Problemas comuns

• Aviso de app não verificado na tela do Google — enquanto a verificação do app junto ao Google estiver em andamento, a tela de consentimento pode exibir um aviso de app não verificado. Se tiver dúvida sobre como prosseguir, fale com o suporte.
• Nenhum projeto aparece no seletor — a conta conectada precisa ter acesso a pelo menos um projeto no Google Cloud. Crie um projeto ou peça acesso a um existente e recarregue o card.
• A consulta falha ou não retorna — confira se o projeto escolhido tem faturamento ativo no Google Cloud; é dele que a consulta é cobrada. As condições de cobrança do BigQuery, confirme na documentação oficial do Google.
• Conectei a conta errada — desconecte a integração na Toca e refaça a conexão escolhendo a conta certa na tela do Google.