Especifique a pergunta de relatório e a autorização
Escolha a propriedade, o intervalo de datas, as dimensões, os filtros e o tipo de pesquisa necessários para a decisão. Confirme que a conta que executará a operação tem acesso e que a autorização do projeto é adequada. Mantenha os identificadores da propriedade e a configuração separados da saída do relatório. Nunca peça a um visitante que cole senhas de conta ou tokens privados em uma planilha pública.
- ✓ Documente o escopo dos relatórios antes de solicitar acesso.
- ✓ Consulte as instruções oficiais atuais de configuração da API e do Apps Script durante a implementação.
Torne as importações repetíveis e rastreáveis
Recupere dados em lotes compatíveis, trate a paginação quando aplicável e respeite os limites atuais do serviço. Use uma regra clara para substituir ou acrescentar um intervalo de datas, de modo que novas tentativas não contem as linhas em duplicidade. Registre a configuração da consulta e o horário da coleta. Os relatórios do Search Console têm limitações de agregação e cobertura; não devem ser apresentados como um registro completo de eventos brutos.
- ✓ Valide totais, limites de datas e chaves duplicadas.
- ✓ Crie pontos de verificação para tarefas longas e destaque falhas, em vez de registrar silenciosamente um sucesso parcial.
Conecte o relatório a uma ação
Associe cuidadosamente as evidências exportadas aos identificadores das páginas, preservando o contexto de URLs canônicas e redirecionamentos. Use o resultado para investigar uma mudança específica na descoberta ou no desempenho. O SearchGraph pode oferecer suporte a fluxos de trabalho baseados em relatórios, mas uma importação pelo Apps Script e uma integração nativa do produto são recursos distintos. Inclua na transferência a responsabilidade pela conta, a manutenção dos acionadores e os procedimentos de exclusão.
- ✓ Preserve a importação bruta junto às tabelas de relatórios transformadas.
- ✓ Teste uma pequena amostra antes de programar execuções recorrentes.