追加数据

该接口用于根据 spreadsheetToken 和 range 遇到空行则进行覆盖追加或新增行追加数据。空行：默认该行第一个格子是空，则认为是空行；单次写入不超过5000行，100列，每个格子不超过5万字符。

错误码

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

{ "code": 0, "msg": "Success", "data": { "revision": 0, "spreadsheetToken": "***", "tableRange": "***", "updates": { "spreadsheetToken": "***", "updatedRange": "***", "updatedRows": 0, "updatedColumns": 0, "updatedCells": 0, "revision": 0 } } }

请求参数

Path 参数

spreadsheetToken

string

必需

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

Query 参数

insertDataOption

string

可选

遇到空行追加，默认 OVERWRITE，若空行的数量小于追加数据的行数则覆盖数据 append；可选 INSERT_ROWS ，会在插入足够数量的行后再 append

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 支持写入数据类型

示例

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

revision

integer

必需

sheet 的版本号

spreadsheetToken

string

必需

spreadsheet 的 token

tableRange

string

写入的范围

必需

updates

object

必需

插入数据的范围、行列数等

错误码#

请求参数

返回响应

错误码