1. Objetivo da integração
O Agente 12K utiliza a Google Ads API para apoiar planejamento, medição e análise das contas Google Ads autorizadas da própria operação. O objetivo é reduzir trabalho manual, aumentar a consistência das análises e registrar decisões com base em dados da plataforma.
2. Planejamento de palavras-chave
Um dos casos de uso centrais é o planejamento de Search. A aplicação pretende consultar serviços de Keyword Planning, incluindo KeywordPlanIdeaService, para obter ideias de palavras-chave e métricas disponíveis que ajudem a avaliar demanda, concorrência e viabilidade econômica antes de investir.
KeywordPlanIdeaService são restritas no Explorer Access e exigem Basic ou Standard Access conforme a documentação atual da Google Ads API.3. Relatórios e análise de desempenho
A aplicação também consulta métricas de contas, campanhas, anúncios e palavras-chave acessíveis à operação para analisar custo, cliques, conversões, CPA e outros indicadores necessários à tomada de decisão.
| Área | Uso pretendido | Finalidade |
|---|---|---|
| Keyword Planning | Ideias e métricas de planejamento | Avaliar intenção, volume e viabilidade antes de mídia. |
| Reporting | Métricas de contas e campanhas autorizadas | Medir custo, cliques, conversões e eficiência. |
| Monitoring | Estado de recursos relevantes | Conferir coerência operacional e suportar diagnóstico. |
4. Usuários e contas acessadas
A aplicação é first-party e de uso interno. As chamadas são feitas somente para contas Google Ads às quais a operação possui acesso autorizado. Não existe cadastro público para terceiros utilizarem o developer token ou os recursos internos da integração.
5. Fluxo técnico
- Um operador autorizado solicita uma análise ou rotina permitida.
- O backend valida o contexto, as permissões e o estado operacional.
- Credenciais e tokens permanecem em ambiente protegido no backend ou em cofre de segredos.
- O backend realiza a chamada necessária à Google Ads API.
- Os dados estritamente necessários são processados ou registrados para análise interna.
- Qualquer ação com impacto financeiro permanece sujeita aos gates internos aplicáveis.
6. Fora do escopo
- Venda, sublicenciamento ou redistribuição do acesso à Google Ads API.
- Criação de contas Google Ads para terceiros como serviço público.
- Gerenciamento público de usuários, convites, faturamento ou pagamentos.
- Exposição pública de dados de contas, developer token ou credenciais OAuth.
- Cloaking, evasão de revisão, mascaramento de identidade ou tentativa de contornar políticas.
7. Supervisão humana e impacto financeiro
Pesquisa, análise e recomendação não autorizam gasto por si só. Antes de ações de impacto financeiro, o desenho operacional considera compliance, tracking, limites de risco, estado da operação e aprovação humana.
8. Estado atual
A integração está em validação técnica. Funcionalidades de produção que dependem de um nível superior do developer token permanecem condicionadas à aprovação do acesso adequado pela Google.
9. Referências técnicas oficiais
Esta documentação foi estruturada para ser consistente com as páginas oficiais da Google Ads API sobre níveis de acesso e uso permitido e developer token.