把 Apple Ads 和 Google Drive 连接到 Hermoso，两者都会变成同一个智能体可以调用的工具。apple_ads_report 拉取表现数据行；create_sheet 和 append_to_sheet 把它们放进你自己拥有的电子表格。没有导出文件，没有数据仓库，也没有第三方工具保管你的凭据。
实际效果
“Pull last week's Apple Search Ads spend by keyword and append it to my Apple Ads sheet.”智能体会调用报告、整理数据行，然后追加写入。下周一再问一次，表格就会多出一周的数据。
Hermoso 请求的 Drive 权限范围是 drive.file，它只能访问自己创建的文件或你选中的文件，而不是你的整个 Drive。
如何将 Apple Search Ads 连接到 Google 表格
- 连接两个账户。在应用中打开连接器，连接 Apple Ads，然后连接 Google Drive。表格和文档共用同一次 Google 授权，因此只会出现一个同意界面，而不是三个。Apple Ads 靠的是密钥交换，而不是一个按钮；Apple Search Ads 设置指南讲解了这一步，包括如何将 Apple Search Ads 连接到 Claude或 ChatGPT，也就是你输入请求的地方。
- 提出第一次拉取的请求。“Pull Apple Search Ads performance by campaign for the last 30 days and put it in a new sheet called Apple Ads.”智能体会调用
apple_ads_report，然后调用create_sheet，并返回链接。 - 让它定期执行。把同一句话中的“new sheet”换成“append”，并由你使用的客户端按计划运行（Claude 或 ChatGPT 中的定时任务，或调用 Hermoso CLI 的 cron 任务），每次都会添加一批新行。除非你要求，否则不会覆盖任何内容。
- 让你的仪表板指向该表格。Looker Studio、Power BI 和 Tableau 都通过它们自己的连接器读取 Google 表格。
表格的样子
每个实体每个周期一行。列遵循你要求的层级（广告系列、广告组、广告、关键词或搜索词），外加 Apple 报告的指标：展示、点击、安装、花费、点击率、单次点击成本和单次获取成本。如果要求按天，每个实体每天一行；如果要求总计，则每个实体一行。智能体可以添加总计行，在 App Store 报告中还可以保留没有投放的实体，使暂停的关键词显示为零，而不是消失。
由于智能体在写入之前先整理数据行，你可以精确地要求你想要的表格：只包含超过某个花费门槛的关键词，广告系列名称旁边附上其 ID，或者在写入之前就算好周环比变化。这些是 CSV 导出会留给你自己去做的工作。
追加、替换或设置格式
表格工具涵盖了完整的编辑操作：append_to_sheet 添加行，update_sheet 原地写入某个区域，clear_sheet_range 在你需要替换而不是堆叠时先清空区域，format_sheet 处理标题、列宽和数字格式，manage_sheet_tabs 可以为每个广告系列或每个月分配独立的标签页。“刷新仪表板表格”这类请求，就是在你指定的标签页上先清空再写入。
从表格将 Apple Search Ads 导出到 Looker Studio
Hermoso 没有原生的 Looker Studio 连接器；表格就是桥梁。在 Looker Studio 中新建数据源，选择 Google Sheets，然后挑选电子表格以及智能体追加写入的那个标签页。把报告搭建一次即可。只要每次运行之间的列标题保持不变，每次追加都会在仪表板下一次数据刷新时显示。Power BI 和 Tableau 也可以采用同样的方式。
想要 JSON 而不是表格？
同一份报告也可以通过 Hermoso API（POST /v1/tools/apple_ads_report）或 CLI 以原始 JSON 获取。参见将 Apple Search Ads 导出为 JSON，以及其他所有目的地的从 Apple Search Ads 导出数据。
常见问题
如何将 Apple Search Ads 连接到 Google 表格？
在 Hermoso 中连接 Apple Ads 和 Google Drive，然后让智能体把报告放进表格。它会用 apple_ads_report 拉取数据行，用 create_sheet 或 append_to_sheet 写入，并返回链接。
Hermoso 需要访问我整个 Google Drive 吗？
不需要。它请求的是 drive.file，只涵盖 Hermoso 创建的文件以及你明确选中的文件。
表格中可以放哪些层级和指标？
广告系列、广告组、广告、关键词或搜索词层级，包含展示、点击、安装、花费、点击率、单次点击成本和单次获取成本，可以是总计，也可以是按小时、天、周或月的序列。
定期报告会覆盖我的表格吗？
除非你要求，否则不会。追加只会添加行；替换则是在你指定的标签页上先清空再写入，且只有在请求中明确说明时，智能体才会这样做。
Looker Studio 或 Power BI 能读取结果吗？
可以。Hermoso 对这两者都没有原生连接器，但两者都能通过各自的连接器读取 Google 表格，因此基于该表格搭建的仪表板会随着智能体的追加而刷新。
报告能定时运行吗？
可以，由你的智能体所在的客户端运行：Claude 或 ChatGPT 中的定时任务，或调用 Hermoso CLI 或 API 的 cron 任务。每次运行都会拉取新的周期并追加。