向多个范围写入数据

POST

/sheets/v2/spreadsheets/{spreadsheetToken}/values_batch_update

该接口用于根据 spreadsheetToken 和 range 向多个范围写入数据，若范围内有数据，将被更新覆盖；单次写入不超过5000行，100列，每个格子不超过5万字符。

错误码

具体可参考：服务端错误码说明

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/sheets/v2/spreadsheets//values_batch_update' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "valueRanges": [
    {
      "range": "range1",
      "values": [
        [
          "string1", 1, "http://www.xx.com"
        ]
      ]
    },
    {
      "range": "range2",
      "values": [
        [
          "string2", 2, "http://www.xx.com"
        ]
      ]
    }
  ]
}'

响应示例

{
    "code": 0,
    "data": {
        "responses": [
            {
                "spreadsheetToken": "***",
                "updatedCells": 0,
                "updatedColumns": 0,
                "updatedRange": "***",
                "updatedRows": 0
            },
            {
                "spreadsheetToken": "***",
                "updatedCells": 0,
                "updatedColumns": 0,
                "updatedRange": "***",
                "updatedRows": 0
            }
        ],
        "revision": 0,
        "spreadsheetToken": "***"
    },
    "msg": "Success"
}

修改于 2025-10-21 06:08:13

向单个范围写入数据

设置单元格样式

向多个范围写入数据

错误码#

请求参数

返回响应

错误码