删除列新版SDK

更新于 2024-12-27

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，删除表格中的列。

调用本接口与下图操作实现的效果一致。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	钉钉表格写权限	API Explorer
第三方企业应用	支持	钉钉表格写权限	API Explorer
第三方个人应用	暂不支持	暂不支持	暂不支持

请求方法

Header参数

名称	类型	是否必填	描述
x-acs-dingtalk-access-token	String	是	调用该接口的访问凭证。企业内部应用，调用获取企业内部应用的accessToken接口获取。第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

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

Path参数

名称	类型	是否必填	描述
workbookId	String	是	表格文件 ID ，知识库 API 返回的`nodeId(dentryUuid)`即是表格`workbookId`，可通过调用获取节点和创建知识库文档接口获取。
sheetId	String	是	工作表的ID或标题。企业内部应用，可调用获取所有工作表接口获取id或者传工作表的标题。第三方企业应用，建议传递工作表的标题。工作表的标题查看步骤如下图。

名称

类型

是否必填

描述

workbookId

String

是

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

sheetId

String

是

工作表的ID或标题。

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

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

Query参数

名称	类型	是否必填	描述
operatorId	String	是	操作人unionId。企业内部应用，调用查询用户详情接口获取。第三方企业应用，调用查询用户详情接口获取。

名称

类型

是否必填

描述

operatorId

String

是

操作人unionId。

企业内部应用，调用查询用户详情接口获取。
第三方企业应用，调用查询用户详情接口获取。

Body参数

名称	类型	是否必填	描述
column	Long	是	要删除的第一列的游标，从0开始。
columnCount	Long	是	要删除的列的数量。

返回参数

名称	类型	描述
id	String	工作表ID。

示例

请求示例

HTTP

Java

Python

PHP

Node.js

返回示例

错误码

HttpCode	错误码	错误信息	说明
400	invalidRequest.inputArgs.workbookIdIllegal	The workbookId is illegal.	workbookId不合法。
400	invalidRequest.inputArgs.operatorIdIllegal	The operatorId is illegal.	operatorId不合法。
400	invalidRequest.inputArgs.invalid	%s	请求参数不合法，请查看错误信息。
403	forbidden.operationIllegal	%s	请求操作不合法，请查看错误信息。
403	forbidden.accessDenied	The operator has no permission.	当前用户无此操作权限。
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	internalError	The server encountered an internal error and was unable to complete your request. Please try again later.	服务内部错误，请稍后再试。
503	serviceBusy	The server is busy and unable to complete your request. Please try again later.	服务繁忙，请稍后重试。

这篇文档是否有帮助？

本页内容