更新区域内容

... 2022-7-18 大约 2 分钟

# 更新区域内容

fileID

300

# 接口说明

本接口用于更新区域内的所有单元格的内容。单新的范围大小需满足以下限制：

范围行数 <=1000
范围内的总单元格数量 <=10000

注意： 本接口无法更新不存在的表格区域。

# 权限说明

本接口需要拥有以下任意一项权限：

scope.sheet

# 请求格式

描述	定义
Path	/openapi/sheetbook/v2/{bookID}/values/{range}
Method	PUT
Content-Type	application/json
Accept	application/json

# 请求头部

详见Headers。

# 请求参数

# 路径参数

参数名	类型	必选	描述
bookID	string	是	文档唯一标识，详见bookID
range	string	是	A1 表示法表示的一个范围

# 查询参数

无

# 请求体

参数名	类型	必选	描述
values	array(array(string))	是	二维数组，表示需要更新的单元格的内容

# 响应参数

# 请求体

参数名	类型	描述
ret	integer	业务返回码
msg	string	业务返回码描述

# 请求包体

PUT /openapi/sheetbook/v2/300000000$AAAAAAAAAAAA/values/BB0000!D2:D3 HTTP/1.1
Host: docs.qq.com
Access-Token: ACCESS_TOKEN
Client-Id: CLIENT_ID
Open-Id: OPEN_ID
Content-Type: application/json
Content-Length: 1

{'values': [['123'], ['test']]}

1
2
3
4
5
6
7
8
9

# 示例

curl --location --request PUT 'https://docs.qq.com/openapi/sheetbook/v2/300000000$AAAAAAAAAAAA/values/BB0000!D2:F3' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Open-Id: OPEN_ID' \
--header 'Content-Type: application/json' \
--data-raw '{
    "values": [["123","123","123"],["test","test","test"]]
}'

1
2
3
4
5
6
7
8

# 响应包体

HTTP/1.1 200 OK
Date: Thu, 28 Jul 2022 15:34:46 GMT
Content-Type: text/plain; charset=utf-8
Content-Length: 2
Connection: keep-alive

{'ret': 0, 'msg': 'Succeed'}

1
2
3
4
5
6
7

# 错误码

错误码	错误说明	排查建议
10313	Access-Token 为空	HTTP Header 里 `Access-Token` 校验失败，请参考示例中的携带方式，检查相应字段。详情请见Headers。
10303	Open-Id 错误	HTTP Header 里 `Open-Id` 与预期不符，可能的原因有： - `Open-Id` 为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - `Open-Id` 与 `Access-Token` 不匹配，请检查 Header 内容和获取 Token 接口回包是否一致。
10302	Client-Id 错误	HTTP Header 里 `Client-Id` 与预期不符，可能的原因有： - `Client-Id` 为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - `Client-Id` 与 `Access-Token` 不匹配，请检查 Header 内容和调用获取 Token 接口接口时参数中的 `Client-Id` 是否一致。
37019	Token 校验失败，错误或过期	检查位于 HTTP Header 中的 `Access-Token` 是否正确，获取 Token 的方式请查阅授权流程以及获取 Token 接口

查询更多业务返回码

清空区域内容批量插入图片