明确报告问题和授权范围
选择决策所需的资源、日期范围、维度、筛选条件和搜索类型。确认执行账户有权访问,且项目授权恰当。将资源标识符和配置与报告输出分开。切勿要求访客将账户密码或私密令牌粘贴到公开工作表中。
- ✓ 申请访问权限前,先记录报告范围。
- ✓ 实施时请查阅最新的官方 API 和 Apps Script 设置说明。
让导入可重复且可追溯
按受支持的批次检索数据,并在适用时处理分页,同时遵守当前服务限制。制定明确规则,说明日期范围是替换还是追加,以免重试造成行数重复累计。记录查询配置和数据采集时间。Search Console 报告存在聚合与覆盖范围限制,不应将其描述为完整的原始事件日志。
- ✓ 验证总计、日期边界和重复键。
- ✓ 为长时间运行的任务设置检查点,并明确显示失败,而不是悄然写入不完整的成功结果。
将报告与行动关联起来
将导出的证据与页面标识符关联时,应谨慎处理,并保留规范网址和重定向的上下文。利用结果调查发现或绩效的具体变化。SearchGraph 可支持基于报告的工作流,但 Apps Script 导入与原生产品集成是不同的能力。交接时应明确账户归属、触发器维护和删除流程。
- ✓ 保留原始导入数据及其转换后的报告表。
- ✓ 安排重复运行前先测试少量样本。