需先在Google Cloud Console启用Google Ads API并创建含adwords scope的OAuth凭据，下载credentials.json；再导入ads_evaluator.yml工作流模板，配置refresh_token、client_id、client_secret及report_date_range参数，设置UTC时区定时任务，最后通过GAQL查询验证连接并运行生成中文分析结论。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在Dify中快速搭建一个能自动拉取Google Ads账户数据、分析点击率/转化成本/ROAS等核心指标、并生成中文可读结论的评估助手，而不是手动导出报表再贴到AI里反复提问。
准备Google Ads API访问权限
进入Google Cloud Console，新建项目并启用Google Ads API服务。这一步不可跳过，Dify无法绕过API直接登录你的Ads账户。
创建OAuth 2.0凭据，授权范围必须包含 【https://www.googleapis.com/auth/adwords】。漏掉这个scope会导致后续所有数据拉取返回403错误，且错误提示极其模糊。
下载生成的credentials.json文件，保存到本地安全位置——它将用于Dify工作流中配置认证环节。
导入预置工作流模板
访问Awesome-Dify-Workflow项目仓库（https://gitcode.com/GitHub_Trending/aw/Awesome-Dify-Workflow），定位到 ads-analytics/ads_evaluator.yml 模板文件。
方法一：在Dify Web界面 →「工作流」→「导入」→ 粘贴YAML内容 → 点击「部署」。
方法二：使用Dify CLI执行 dify-cli workflow import --file ads_evaluator.yml。CLI方式会自动校验YAML语法，避免因缩进错误导致部署失败。
配置工作流参数
第一步：在Dify工作流编辑页，找到「变量」区域，点击「+添加变量」。
第二步：依次填入以下三项必填参数：
• google_ads_refresh_token：从Google OAuth流程获取的长期有效refresh token；
• google_ads_client_id：OAuth凭据中的Client ID；
• google_ads_client_secret：OAuth凭据中的Client Secret。
第三步：设置时间范围变量 report_date_range，格式为“LAST_7_DAYS”或“20260722,20260728”，不要加空格或引号——加引号会导致API解析失败并静默返回空结果。
第四步：勾选「启用定时触发」，设定为每天上午9:00 UTC+0执行。注意：Dify云端版的定时任务基于UTC时区，若你在中国，需换算为17:00北京时间。
连接Google Ads数据源
在工作流节点中找到「Google Ads Query」组件，点击编辑图标。
粘贴标准GAQL查询语句，例如：SELECT campaign.name, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_7_DAYS
这一步操作起来很简单，直接把上面语句复制进去就行。但必须确保字段名大小写完全匹配GAQL规范，比如metrics.conversions写成metrics.Conversions会导致整个查询返回空。
点击「测试连接」按钮，等待约8秒。如果看到绿色「Success」和返回的JSON样例数据，说明API通路已打通。
启动评估运行
返回工作流概览页，点击右上角「运行」按钮。
首次运行会触发OAuth授权流程：Dify自动打开Google登录页 → 你选择对应Ads管理员账号 → 授予「查看广告数据」权限 → 页面跳转回Dify并显示「授权成功」。
等待约45秒，工作流状态变为「已完成」，输出区块中将显示结构化分析结论，例如：“搜索广告系列ROAS同比下降23%，主因是品牌词CPC上涨18%；建议暂停‘通用词包’组并重设否定关键词。”
