# Google 表格 (https://sellersheetai.com/zh/docs/mcp-api/workflows/sheets)

> AI 操作表格的工具——读取、写入、格式、筛选、图表和保护——让结果落在团队审核的地方。



<Callout title="一句话">
  亚马逊和 noon 工具本身从不写入表格。当你在 Google 表格里工作时，AI 用这些工具把结果记录到表格中，包括表头、格式、筛选和下拉菜单。你在表格里审核、修改，然后说“把我改过的行提交”。
</Callout>

## AI 如何使用表格 [#ai-如何使用表格]

<Steps>
  <Step>
    ### 读取已有内容 [#读取已有内容]

    `list_sheet_tabs` 和 `get_sheet_metadata` 显示工作簿结构；`read_sheet` 读取一个区域，`get_sheet_cell` 读取单个单元格及其下拉菜单和批注，`get_sheet_notes` 读取标签页的批注。
  </Step>

  <Step>
    ### 写入结果 [#写入结果]

    `write_sheet` 写入一块数据，`append_sheet_rows` 在末尾追加行，`write_sheet_formula` 写入公式，`import_sheet_tsv` 导入整份报表。`setup_sheet` 和 `add_sheet_tab` 新建标签页。
  </Step>

  <Step>
    ### 让它易读 [#让它易读]

    `format_sheet_range`、`set_sheet_number_format`、`freeze_sheet_panes`、`autofit_sheet_columns` 和 `apply_sheet_table_style` 负责格式；`add_sheet_conditional_format`、`add_sheet_chart` 和 `insert_sheet_sparkline` 添加可视化。
  </Step>

  <Step>
    ### 变成工作台 [#变成工作台]

    `add_sheet_dropdown` 把亚马逊的取值放进下拉菜单，`create_sheet_filter` 和 `sort_sheet_range` 排列行，`protect_sheet_range` 锁定不该编辑的区域。其他需求用 `sheet_batch_update` 兜底。
  </Step>
</Steps>

## 可以这样问 [#可以这样问]

> “读取我 Sales 表格里的数据。”

> “把 listings 表的表头行加上格式、冻结，并加筛选。”

## 读取区域的两种调用方式 [#读取区域的两种调用方式]

同一个工具、同样的参数——通过 AI 客户端，或者从你自己的代码。

**MCP**——你说：“我的 Sales 标签页 A1:F20 里是什么？” AI 调用 `read_sheet`。

<ToolCall tool="read_sheet" args="{ spreadsheet_id: &#x22;<your spreadsheet id>&#x22;, range_: &#x22;Sales!A1:F20&#x22; }" lang="zh" />

<Callout type="warn" title="这些工具会改动你的表格">
  写入和格式工具改动的是你指定的工作簿——不会改动你的亚马逊账户。表格必须是你的 Google 账号能打开的。
</Callout>

## 本页用到的工具 [#本页用到的工具]

构建时从工具目录读取，每个工具带有自己的权限标签。

<ToolList domains="[&#x22;sheets&#x22;]" lang="zh" />

## 常见问题 [#常见问题]

### 有教 AI 做好表格的技能吗？ [#有教-ai-做好表格的技能吗]

有——`sellersheet-sheets`（建表、格式、实时数据）和 `sellersheet-dashboard`（多标签页看板）。见[安装技能](/zh/docs/start/skills)。

### Google 表格插件呢？ [#google-表格插件呢]

插件的按钮在表格内运行各自的流程——见[插件按钮](/zh/help/sheets/buttons)。Docs 和 Drive 有各自的页面：[Google 文档](/zh/docs/mcp-api/workflows/docs)、[Google 云盘](/zh/docs/mcp-api/workflows/drive)。