向多个范围写入数据

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

错误码

curl --location --request POST 'https://open.feishu.cn/open-apis/sheets/v2/spreadsheets//values_batch_update' \ --header 'Authorization;' \ --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" }

请求参数

Path 参数

spreadsheetToken

string

必需

spreadsheet 的 token，获取方式见在线表格开发指南

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

valueRanges

array [object {2}]

需要更新的多个范围

必需

range

string

必需

更新范围，包含 sheetId 与单元格范围两部分，目前支持三种索引方式，详见在线表格开发指南。range所表示的范围需要大于等于values占用的范围。

values

array [array]

必需

需要写入的值，如要写入公式、超链接、email、@人等，可详看附录sheet 支持写入数据类型

示例

application/json

Body

code

integer

必需

data

object

必需

responses

array [object {5}]

响应

必需

revision

integer

必需

sheet 的版本号

spreadsheetToken

string

必需

spreadsheet 的 token

msg

string

必需

向多个范围写入数据

错误码#

请求参数

返回响应

错误码