x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

• 企业内部应用，调用获取企业内部应用的accessToken接口获取。

• 第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

workbookId

String

是

表格文件 ID ，知识库 API 返回的nodeId(dentryUuid)即是表格workbookId，可通过调用获取节点和创建知识库文档接口获取。

sheetId

String

是

工作表的ID或标题。

• 企业内部应用，可调用获取所有工作表接口获取id或者传工作表的标题。
• 第三方企业应用，建议传递工作表的标题。

工作表的标题查看步骤如下图。

rangeAddress

String

是

需要清除的单元格范围，格式为区域内左上角单元格:区域内右下角单元格。

例如：B2:C3，表示的区域如下图所示。

operatorId

String

是

操作人unionId。

• 企业内部应用，调用查询用户详情接口获取unionid参数值。

• 第三方企业应用，调用查询用户详情接口获取unionid参数值。

400

invalidRequest.inputArgs.invalid

%s

请求参数不合法，请查看错误信息。

400

invalidRequest.inputArgs.workbookIdIllegal

The workbookId is illegal.

workbookId不合法。

400

invalidRequest.resource.notWorkbook

%s

不支持的文档类型，请检查workbookId。

403

forbidden.accessDenied

The operator has no permission.

当前用户无此操作权限。

403

forbidden.acrossOrg

%s

请求不合法，请检查要访问的文档是否归属于accessToken指定的组织。

403

forbidden.operationIllegal

%s

请求操作不合法，请查看错误信息。

403

forbidden.document.sizeOverLimit

The document size is over limit and the server is unable to complete your request. Retry is unlikely to work unless the document size is decreased.

表格内容过大，请尝试缩减表格内容。

404

invalidRequest.resource.notFound

%s

请求失败，无法找到要访问的资源。

500

serviceBusy

The server is busy and unable to complete your request. Please try again later.

服务繁忙，请稍后重试。

500

internalError

The server encountered an internal error and was unable to complete your request. Please try again later.

服务内部错误，请稍后再试。