脚本状态
API 根地址（脚本自动携带）
生成脚本时，系统会把下面的地址自动写入脚本里的
GADS_API_BASE
常量，不需要任何人手动填写。这里显示出来只是给你核对——地址在生成脚本那一刻写死，
如果当时状态不对，脚本会失效。
三段状态机
待脚本拉取 → 脚本执行中 → 预览已生成，待确认 → 已成功发布
保存广告后会先强制进入预览：脚本拉到 → 生成预览（不实际创建）→ 在预览页核对结构 → 点「暂停广告（防烧钱）」或「直接投放（立即跑）」→ 脚本应用创建。
- 先选服务商
- 再选AI模型
- 系统自动计算API端点
- 填写当前服务商对应的API Key
脚本发布配置
添加 MCC
填写 MCC 信息并保存。保存后点对应卡片里的「生成上传脚本」，把脚本安装到该 MCC 的 Google Ads 后台。
脚本执行计划（MCC）
- 系统为每个 MCC 连接生成两份 Loader 脚本（slot-0 / slot-30，错峰约 30 分钟）。
- 安装到 MCC（经理账号）的「批量操作 → 脚本」，授权后设为每小时运行一次。
- 脚本会遍历 MCC 名下的子账号，只为已在「单 Ads 账号配置」登记且 customer_id 匹配的子账号拉取并执行任务。
- 每个子账号的任务独立租约、独立回传，与单账号模式共用同一套广告 / 日志 / 已发布面板。
- 日常业务升级只需在网页里修改，Loader 自动拉取最新 publisher，无需重贴脚本。
注意：单次脚本运行最多并行处理 50 个子账号，超过会自动分批；Google 限制脚本总时长 30 分钟，子账号非常多时建议拆分 MCC。
添加用户
由超级管理员直接创建用户，创建即开通（可立即使用全部功能）。
管理员联系方式
未开通功能的用户登录后会看到这条联系方式，用于联系你开通权限（文案可在此修改）。
数据迁移（备份 / 恢复）
换服务器时用：在旧服务器点「导出备份」下载 JSON，把文件带到新服务器（首次访问会自动建好空库）后，在这里点「选择备份文件并恢复」，所有用户 / Ads 账号 / 广告 / 文案一条不丢。
Google Ads API / OAuth 配置 （系统级，只需设置一次）
这套 OAuth 客户端用于「API 模式」直连 Google Ads API（建视频系列、查关键词搜索量）。 client_id / client_secret 只是「应用身份」，本身不带任何账户的访问权； 真正能操作某个账户的是各账号各自授权拿到的 refresh token，它按账号加密隔离存储（见下方说明）。
（保存配置后显示）
如何创建 OAuth 客户端（分步指南）
- 打开 Google Cloud Console，新建或选择一个项目。
- 左侧 APIs & Services → Library，搜索并启用 Google Ads API。
- 左侧 OAuth consent screen：User Type 选 External；填应用名、用户支持邮箱、开发者联系邮箱；在「测试用户」里加上你自己的 Google 账号邮箱（否则授权时会报 access blocked）。发布状态保持 Testing 即可。
- 左侧 Credentials → Create Credentials → OAuth client ID：应用类型选 Web application；在 Authorized redirect URIs 填入上方系统显示的「授权回调地址」（必须是 https 的本站绝对地址）。
- 创建后得到 Client ID 和 Client Secret，填到本页上面两个框，点「保存配置」。
- 回到「Ads 账号 / MCC」页签，对每个账号点「连接 Google Ads API」，用你自己的 Google 账号完成一次性授权。refresh token 会按该账号加密存储。
⚠ 注意：OAuth 同意屏幕处于 Testing 状态时，refresh token 在闲置 7 天后会被 Google 回收，届时需重新连接。长期商用建议把同意屏幕送审并发布为 Production。
ℹ 开发者 Token 已于 2026-09-09 被 Google 弃用：新项目改在 Google Cloud 控制台的 Google Ads API Overview 页申请访问级别（Basic/Standard，需品牌验证），不再需要 Developer Token。本系统的该输入框仅作旧项目兼容，留空即可。
凭证隔离说明（其他用户会用到我的 client_id / secret 吗？）
不会。这里配置的 client_id / client_secret 只是「这个应用的身份」，相当于一把公共大门的牌子——它不携带任何 Google Ads 账户的访问权，谁拿去都没法直接操作账户。
真正能操作某个账户的，是各账号在「连接」时用你（或该账号主人）自己的 Google 账号授权换来的 refresh token。它的隔离规则是：
- 每个 Google Ads 账号各自独立授权，拿到各自专属的 refresh token；
- token 在服务器加密存储（AES-256），且只在「该账号主人登录态下」才返回连接状态，不跨用户共享；
- 普通用户若要用 API 模式，必须用他们自己的 Google 账号走一遍授权，拿到属于自己的 token——拿不到你的。