主动授权 Google 访问
维护者配置桌面程序后，使用者在 Google 官方授权页面选择账户并确认权限。程序使用本机回调接收授权结果。
内部运营工具 · Desktop automation
账户与账单同步，
每次更新都有依据。
珊瑚数据平台是一款面向固定内部使用者的本机桌面工具。现有 Meta 流程将 Coral 业务系统中的广告账户与近期账单，同步至指定的 Google 电子表格，并回读核验更新结果。Google Ads 日花费流程已完成 API 读取、本机 XLSX 整理、Coral 导入及回读核验。
A desktop tool for the operator and a fixed group of authorized internal users. Coral Meta records sync to a designated Google spreadsheet. The Google Ads workflow has been tested from API reporting through a local XLSX file to Coral import and readback verification.
CURRENT WORKFLOW · CORAL META TO SHEETS
01
Coral 业务系统
读取 Meta 账户及最近三天的账单记录
02
本机校验与整理
检查数据来源、字段、日期与目标工作表
03
指定 Google 电子表格
更新账户、日账单工作表，并完整回读核验
供固定内部使用者使用。本网站提供产品与隐私说明；桌面程序由维护者提供。
使用方式
由使用者授权，在自己的电脑上运行。
本应用面向运营者本人及经授权的固定内部使用者。Google 授权由桌面程序在系统浏览器中发起；无需在本网站注册账户。
更新固定业务表
程序读取 Coral 账户与账单，检查字段及日期，仅向预先配置的工作簿更新“系统数据”和“日账单”目标工作表。
核验结果并保留状态
更新后回读单元格值，检查旧数据尾部及格式样本。程序保留本机运行状态，便于核对成功、失败与待恢复的任务。
已实测接入 · Tested integration
Google Ads 每日广告花费接入
读取经授权 Google Ads 账户的每日广告花费，按日期、币种、账户时区及 Coral 平台金额精度整理为本机 XLSX，再导入 Coral 后端并回读核验，用于内部归集与对账。Google Sheets 继续用于原有 Meta 同步流程。
读取授权账户日花费
通过 Google Ads API 读取客户 ID、账户名称、日期、花费（cost_micros）、币种和账户时区，明确数据归属与统计口径。离线刷新授权已实测可用。
整理本机导入文件
按 Coral 模板生成本机 XLSX，校验账户、日期和金额，并按平台金额精度整理。原始 cost_micros 保留在本机审计资料中。
导入 Coral 并回读
将核验后的日花费记录导入 Coral 后端，逐笔回读确认结果。此流程已完成实测；尚未设置 Google Ads 每日定时任务。
Google Ads 流程仅用于读取报表及内部对账，不创建或修改广告活动、预算及出价。品牌审核、Google Ads API 访问级别与 Google OAuth 权限范围验证是不同事项；本流程实测可用不表示 OAuth 敏感范围已审核通过。广告花费不等于含税费、抵扣及调整的最终发票结算金额。
Tested workflow: authorized Google Ads daily media spend → local XLSX → Coral backend import and readback. Amounts are prepared to the platform's precision. No Google Ads daily schedule is configured. Successful operation does not establish OAuth sensitive-scope verification. Media spend is distinct from final invoice settlement.
Google 授权说明
权限范围与实际用途，
分别说明清楚。
https://www.googleapis.com/auth/spreadsheets
现有 Meta 同步流程申请 Google Sheets 权限，用于读取工作表属性、写入同步记录和核验结果。此权限在 Google 授权层面可查看、编辑、创建和删除您的 Google 电子表格；现有应用代码将实际操作限制在预先配置的一个工作簿及其目标工作表，并会创建和清理用于更新的临时隐藏工作表。
The Google Sheets scope is broader than one spreadsheet. This app restricts its own operations to a configured workbook; this is an application restriction, not a Google-enforced per-file grant.
https://www.googleapis.com/auth/adwords
Google Ads 流程经使用者同意后仅请求 adwords 范围，使用独立于 Meta／Sheets 流程的本机令牌。此范围本身不是只读授权；本应用将实际用途限制为读取日花费报表，不创建或修改广告活动、预算及出价。Google Ads 流程不请求或写入 Google Sheets。原有 Meta 同步代码仍仅请求 Google Sheets 范围，无需 Gmail、Google 日历或 Google 账户资料权限。
您可随时前往 Google 账户连接管理检查对应应用并撤销访问。撤销不会自动删除已有本机文件、Google Sheets 副本或 Coral 记录。各流程的数据处理、保留及删除方式请见隐私政策。
产品支持与数据请求
有关使用、授权、隐私或本机数据删除，请联系应用维护者。