服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
文档
编辑智能表格内容
更新记录
更新记录
最后更新:2024/09/12

目录

  • 更新记录
  • 参数详细说明
  •       CellValueKeyType
  •       UpdateRecord
  •       CommonRecord
  • 更新记录

    本接口用于更新 Smartsheet 中的某个子表里的一行或多行记录。
    注意
    不能通过更新记录接口给创建时间、最后编辑时间、创建人和最后编辑人四种类型的字段更新记录。

    请求方式:POST(HTTPS)
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/update_records?access_token=ACCESS_TOKEN

    请求包体

    {
    	"docid": "DOCID",
    	"sheet_id": "123Abc",
    	"key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE",
    	"records": [
    	]
    }

    参数说明

    参数类型是否必须说明
    docidstring文档的docid
    sheet_idstringSmartsheet 子表ID
    key_typestring(CellValueKeyType)返回记录中单元格的key类型
    recordsObject[](UpdateRecord)由需要更新的记录组成的 JSON 数组

     

    权限说明

    • 自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用(accesstoken如何获取?
    • 第三方应用需具有“文档”权限
    • 代开发自建应用需具有“文档”权限

    返回示例

    {
        "errcode": 0,
        "errmsg": "ok",
        "records": [
        ]
    }

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明
    recordsObject[](CommonRecord)由更新成功的记录的具体内容组成的 JSON 数组

    参数详细说明

    CellValueKeyType

    记录(CommonRecord)中key的类型

    枚举类型描述
    CELL_VALUE_KEY_TYPE_FIELD_TITLEkey用字段标题表示
    CELL_VALUE_KEY_TYPE_FIELD_IDkey用字段 ID 表示

    UpdateRecord

    参数名类型描述
    record_idstring记录 ID
    valuesObject记录的具体内容,key 为字段标题或字段 ID ,value 详见(Value)

    CommonRecord

     

    参数名类型描述
    record_idstring记录 ID
    valuesObject记录的具体内容,key 为字段标题或字段 ID ,value 详见(Value)

     

    上一篇删除记录
    下一篇获取文档数据
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们