Google Sheets API：读取单元格范围值

Google 官方 spreadsheets.values.get 以GET读取指定表格ID与A1/R1C1范围，需所列OAuth权限之一，返回ValueRange。可选行列方向和显示值形式；日期渲染规则与默认格式相关。费用、配额和完整ValueRange schema未在本页，未访问表格。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：办公数据／Google Sheets 指定范围只读取值 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 0c4ff375ca46f269a160210700a11a641b5fce14e78f0034f206c23c4f110edc

该v4方法仅获取一个电子表格范围的值，HTTP body为空。本文明确路径和渲染参数，但ValueRange对象详细定义在另页；示例二维数组只是布局说明，不代表任何真实用户表格数据。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-571ed5e71b17936cdc09730b · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-571ed5e71b17936cdc09730b
名片版本: 2
资料更新: 2026-10-24T18:50:50.3154221+00:00
原作者 / 提供者: Google
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

spreadsheetId和range两个路径参数必填；range支持A1或R1C1。
majorDimension控制二维结果主维度，ROWS与COLUMNS会改变同一范围的排列。
valueRenderOption默认FORMATTED_VALUE；dateTimeRenderOption默认SERIAL_NUMBER，但在FORMATTED_VALUE时被忽略。

输出

成功响应为ValueRange实例，完整对象字段schema在外部引用页，本附件未展开。
文中示例同一2×2范围按ROWS为[[1,2],[3,4]]，按COLUMNS为[[1,3],[2,4]]；这是示意值。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：OAuth 授权。本页明确需要所列OAuth scopes之一，包括spreadsheets.readonly、spreadsheets、drive.readonly、drive.file或drive；具体授权获取流程在未捕获指南。未授权或取得凭据。

运行前提

调用者必须提供实际spreadsheetId和A1或R1C1范围，并具备相应OAuth授权。
entry_url为官方路径模板，未绑定任何真实表格；请求body必须为空。
本次不登录Google、不授权、不读取表格/账本或运行Try it。

公开请求示例

{
  "method": "GET",
  "notes": "\u5B98\u65B9\u8303\u56F4/\u65B9\u5411\u8BF4\u660E\u7684\u7ED3\u6784\u5316\u793A\u4F8B\uFF0CID\u4E3A\u5360\u4F4D\u7B26\uFF0C\u672A\u6267\u884C\u3002",
  "path_parameters": {
    "range": "Sheet1!A1:B2",
    "spreadsheetId": "\u003Cspreadsheet-id\u003E"
  },
  "query": {
    "majorDimension": "ROWS"
  },
  "url_template": "https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。该方法参考没有API费率、免费额度或Google Workspace账号计划条件。

价格来源 · 未知

资料去向

提供者服务器。Google Sheets服务处理范围读取，授权应用可接收单元格数据；本页没有日志/数据保留政策。本次未绑定ID、访问任何工作簿或传输真实数据。

限制

必须有实际表格ID、范围与访问授权，官方路径模板不代表已能访问任意表格。
格式化值和日期渲染选项有依赖，不能无条件将返回日期当数值serial或原始内容。
本页只述values.get，不推断公式/格式/整份工作簿或写入能力。
完整ValueRange、权限授予流程、费用、请求速率、配额和SLA未包含。

仍需核对

真实表格访问权限、授权流程、完整ValueRange schema与格式边界未验证。
费用/账号计划、数值限流/配额、SLA、日志与数据保留未知。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:50:01.9224853+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Method: spreadsheets.values.get | Google Sheets | Google for Developers · 官方文档 · 2026-10-25T02:50:01.9224853+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get",
  "final_url": "https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get",
  "status_code": 200,
  "title": "Method: spreadsheets.values.get \u00A0|\u00A0 Google Sheets \u00A0|\u00A0 Google for Developers",
  "description": null,
  "checked_at": "2026-10-24T18:50:01.9224853\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-571ed5e71b17936cdc09730b",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。