向单个范围写入数据

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

错误码

curl --location --request PUT 'https://open.feishu.cn/open-apis/sheets/v2/spreadsheets//values' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "valueRange":{ "range": "string", "values": [ [ "string", 1 ,"http://www.xx.com" ] ] } }'

请求参数

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

valueRange

object

值与范围

必需

range

string

必需

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

values

array [array]

必需

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

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

revision

integer

必需

sheet 的版本号

spreadsheetToken

string

必需

spreadsheet 的 token

updatedCells

integer

写入的单元格总数

必需

updatedColumns

integer

写入的列数

必需

updatedRange

string

写入的范围

必需

updatedRows

integer

写入的行数

必需

msg

string

必需

向单个范围写入数据

错误码#

请求参数

返回响应

错误码