企业微信——智能表格学习

devtools/2025/1/6 21:59:01/

智能表格

应用限制条件

在这里插入图片描述

获取 token

https://developer.work.weixin.qq.com/document/10013#%E5%BC%80%E5%8F%91%E6%AD%A5%E9%AA%A4

开发步骤

你可以通过以下步骤，使用access_token来访问企业微信的接口。需要注意的是，所有的接口需使用Https协议、Json数据格式、UTF8编码。
注：查看接口说明中，参数中标注大写的单词，表示为需要替换的变量。

第一步：获取secret
  • 通讯录管理、外部联系人管理、审批、打卡等基础应用是企业微信默认集成的应用，可以直接开启并拿到secret。参考上文secret的介绍。
  • 如果企业需要开发自定义的应用，进入“企业应用”页面，在“自建应用”栏点击“创建应用”，完成应用的添加和配置，详细步骤请参见应用概述。
第二步：开启接收消息模式

开启接收消息模式并不是必须步骤，但是如果在你的企业应用中需要用到如下功能时需提前开启接收消息模式。

  • 获取企业成员的地理位置信息
  • 动态调整企业应用的信息
  • 获取企业成员点击事件类型的应用菜单行为
  • 获取企业成员通过应用给企业后台发送的消息

关于如何开启接收消息模式，请阅读接收消息配置章节。

第三步：获取access_token

**请求方式：**GET（HTTPS）
**请求URL：**https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
注：此处标注大写的单词ID和SECRET，为需要替换的变量，根据实际获取值更新。其它接口也采用相同的标注，不再说明。

若企业安装了第三方应用，该服务商可通过“获取企业access_token”获得此调用凭证。

参数说明：

参数必须说明
corpid是企业ID
corpsecret是应用的凭证密钥

权限说明：

每个应用有独立的secret，所以每个应用的access_token应该分开来获取

返回结果：

{"errcode":0,"errmsg":"","access_token": "accesstoken000001","expires_in": 7200
}
参数说明
access_token获取到的凭证,最长为512字节
expires_in凭证的有效时间（秒）

api

创建文件

https://developer.work.weixin.qq.com/document/path/97470

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedoc/create_doc?access_token=ACCESS_TOKEN

请求包体

{"spaceid": "SPACEID","fatherid": "FATHERID","doc_type": 3,"doc_name": "DOC_NAME","admin_users": ["USERID1", "USERID2", "USERID3"]
}

参数说明

参数类型是否必须说明
spaceidstring否空间spaceid。若指定spaceid，则fatherid也要同时指定
fatheridstring否父目录fileid, 在根目录时为空间spaceid
doc_typeuint32是文档类型, 3:文档 4:表格 10:智能表格
doc_namestring是文档名字（注意：文件名最多填255个字符, 超过255个字符会被截断）
admin_usersstring[]否文档管理员userid

在这里插入图片描述

在这里插入图片描述

说明：

新增文档包含一个默认Sheet 名：q979lj

文档查询

https://qyapi.weixin.qq.com/cgi-bin/wedoc/get_doc_base_info

{"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA"
}

在这里插入图片描述

新增sheet

https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/add_sheet


{"docid": "dcNCrxIDPxTtI8QzxxxDA0zKIPg","properties": {"title": "智能表111"}
}

说明：新增 sheet 包含一个默认字段：fabcde

查询sheet

论坛问题：https://developer.work.weixin.qq.com/community/question/detail?content_id=16671111556455089080

https://developer.work.weixin.qq.com/document/path/99911

在这里插入图片描述

{

“docid”: “dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA”

}

在这里插入图片描述

重命名sheet

https://developer.work.weixin.qq.com/document/path/100215

在这里插入图片描述

查看字段

https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/get_fields


{"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA","sheet_id": "q979lj","offset": 0,"limit": 10
}
{"errcode": 0,"errmsg": "ok","total": 13,"has_more": true,"next": 10,"fields": [{"field_id": "f0B8fw","field_title": "人员","field_type": "FIELD_TYPE_USER","property_user": {"is_multiple": true,"is_notified": true}},{"field_id": "f43PE3","field_title": "asfasdasdasa","field_type": "FIELD_TYPE_TEXT"},{"field_id": "f53B4X","field_title": "日期","field_type": "FIELD_TYPE_DATE_TIME","property_date_time": {"format": "yyyy\"年\"m\"月\"d\"日\"","auto_fill": false}},{"field_id": "fHh3jp","field_title": "TITLE","field_type": "FIELD_TYPE_TEXT"},{"field_id": "fImfIr","field_title": "TITLE11111111","field_type": "FIELD_TYPE_TEXT"},{"field_id": "fSNPFZ","field_title": "文件","field_type": "FIELD_TYPE_ATTACHMENT","property_attachment": {"display_mode": "DISPLAY_MODE_GRID"}},{"field_id": "fW8Thg","field_title": "风格","field_type": "FIELD_TYPE_TEXT"},{"field_id": "fc5FyT","field_title": "单选","field_type": "FIELD_TYPE_SINGLE_SELECT","property_single_select": {"is_multiple": false,"is_quick_add": true,"options": []}},{"field_id": "fiWfNd","field_title": "数字","field_type": "FIELD_TYPE_NUMBER","property_number": {"decimal_places": 1,"use_separate": true}},{"field_id": "fl1uff","field_title": "图片","field_type": "FIELD_TYPE_IMAGE"}]
}
添加字段

https://developer.work.weixin.qq.com/document/path/100220#fieldtype

{"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA","sheet_id": "q979lj","fields": [{"field_title": "风格","field_type": "FIELD_TYPE_TEXT"},{"field_title": "发货日期","field_type": "FIELD_TYPE_DATE_TIME","property_date_time": {"format": "yyyy\"年\"m\"月\"d\"日\"","auto_fill": false}}]
}
删除字段
{"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA","sheet_id": "q979lj","field_ids": ["f43PE3"]
}
字段类型

在这里插入图片描述

添加记录

https://developer.work.weixin.qq.com/document/path/100224

  • 添加记录

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

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

请求包体：

{"docid": "DOCID","sheet_id": "123Abc","key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE","records": [{"values": {"FILED_TITLE": [{"type": "text","text": "文本内容"}]}}]
}

参数说明

参数类型是否必须说明
docidstring是文档的docid
sheet_idstring是Smartsheet 子表ID
key_typestring(CellValueKeyType)否返回记录中单元格的key类型，默认用标题
recordsObject是需要添加的记录的具体内容组成的 JSON 数组

权限说明

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

返回示例

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

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
recordsObject由添加成功的记录的具体内容组成的 JSON 数组
添加字段

在这里插入图片描述

https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/add_records

{"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA","sheet_id": "q979lj","key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE","records": [{"values": {"文本": [{"type": "text","text": "文本内容3"}],"日期": "1735625722000",  // 毫秒级别时间戳"数字": 1.1,"单选": [{"text": "浅红","style": 1}]}}]
}

在这里插入图片描述

更新记录

https://developer.work.weixin.qq.com/document/path/100226#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_idstring是Smartsheet 子表ID
key_typestring(CellValueKeyType)否返回记录中单元格的key类型
recordsObject是由需要更新的记录组成的 JSON 数组
删除记录

https://developer.work.weixin.qq.com/document/path/99908

本接口用于删除 Smartsheet 的某个子表中的一行或多行记录。

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

请求包体：

{"docid": "DOCID","sheet_id": "123Abc","record_ids": ["re9IqD","rpS0P9"]
}

参数说明

参数类型是否必须说明
docidstring是文档的docid
sheet_idstring是Smartsheet 子表ID
record_idsstring[]是要删除的记录 ID
查询记录

https://developer.work.weixin.qq.com/document/path/99915

https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/get_records{"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA","sheet_id": "q979lj","record_ids": [],"key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE","field_titles": [],"field_ids": [],"sort": [],"offset": 0,"limit": 100
}

元数据

表列表
[root@localhost app]# curl http://xxxxx:8090/api/metalakes/StarRocks/catalogs/StarRocks/schemas/ads_test/tables | jq .% Total    % Received % Xferd  Average Speed   Time    Time     Time  CurrentDload  Upload   Total   Spent    Left  Speed
100  4365  100  4365    0     0   221k      0 --:--:-- --:--:-- --:--:--  224k
{"code": 0,"identifiers": [{"namespace": ["StarRocks","StarRocks","ads_test"],"name": "ads_fail_import_group_vip"},{"namespace": ["StarRocks","StarRocks","ads_test"],"name": "ads_group"}
表信息
[root@localhost app]# curl http://xxxxx:8090/api/metalakes/StarRocks/catalogs/StarRocks/schemas/ads_test/tables/ads_fail_import_group_vip | jq .% Total    % Received % Xferd  Average Speed   Time    Time     Time  CurrentDload  Upload   Total   Spent    Left  Speed
100  3806  100  3806    0     0   165k      0 --:--:-- --:--:-- --:--:--  168k
{"code": 0,"table": {"name": "ads_fail_import_group_vip","comment": "导入失败会员表","columns": [{"name": "comp_id","type": "varchar(100)","nullable": false,"autoIncrement": false},...{"name": "vip_gender_name","type": "varchar(50)","comment": "会员性别名称","nullable": true,"autoIncrement": false,"defaultValue": {"type": "literal","dataType": "null","value": "NULL"}}

博客

企业微信 API 接口调用教程：一步步学习企业微信 API 的使用技巧

问题

获取所有文档的docid?

在这里插入图片描述


http://www.ppmy.cn/devtools/148010.html

相关文章

多层设计模式：可否设计各层之间公用的数据定义模块？

多层设计模式：可否设计各层之间公用的数据定义模块？

在多层程序设计模式中，可以设计一个各层之间公用的数据类型定义模块。这种模块通常被称为“公共模块”或“共享模块”，它包含所有层都需要使用的数据类型定义。这有助于确保数据在不同层之间传递时的一致性和准确性。 以下是一些设计这种公用数据类型定…
阅读更多...
电子电气架构 --- 安全相关内容汇总

电子电气架构 --- 安全相关内容汇总

我是穿拖鞋的汉子，魔都中坚持长期主义的汽车电子工程师。 老规矩，分享一段喜欢的文字，避免自己成为高知识低文化的工程师： 所谓鸡汤，要么蛊惑你认命，要么怂恿你拼命，但都是回避问题的根源，以现象替代逻辑，以情绪代替思考，把消极接受现实的懦弱，伪装成乐观面对不幸的…
阅读更多...
fromData使用详解

fromData使用详解

介绍 把属性和属性值进行数组结合，高效传输 FormData的主要用途有两个： 1、将form表单元素的name与value进行组合，实现表单数据的序列化，从而减少表单元素的拼接，提高工作效率。 2、异步上传文件（想了解为…
阅读更多...
深度信念网络 (Deep Belief Network, DBN) 算法详解与PyTorch实现

深度信念网络 (Deep Belief Network, DBN) 算法详解与PyTorch实现

深度信念网络 (Deep Belief Network, DBN) 算法详解与PyTorch实现 目录 深度信念网络 (Deep Belief Network, DBN) 算法详解与PyTorch实现1. 深度信念网络 (DBN) 算法概述1.1 受限玻尔兹曼机 (RBM)1.2 DBN的优势2. DBN的核心技术2.1 受限玻尔兹曼机 (RBM)2.2 对比散度 (CD) 算法…
阅读更多...
需求上线，为什么要刷缓存？

需求上线，为什么要刷缓存？

在需求上线的过程中，刷缓存主要有以下几个重要原因： 一、保证数据的准确性 旧数据残留问题 缓存是为了加快数据访问速度而存储的数据副本。在需求更新后，之前缓存中的数据可能已经不符合新的业务逻辑。例如，一个电商网站修改了商…
阅读更多...
dbeaver导入导出数据库（sql文件形式）

dbeaver导入导出数据库（sql文件形式）

目录 前言dbeaver导出数据库dbeaver导入数据库 前言 有时候我们需要复制一份数据库，可以使用dbeaver简单操作！ dbeaver导出数据库 选中数据库右键->工具->转储数据库 dbeaver导入数据库 选中数据库右键->工具->执行脚本 mysql 默…
阅读更多...
TCP Listen 原语：端口失衡、对称性及协议演进

TCP Listen 原语：端口失衡、对称性及协议演进

TCP 最初就是作为 server 存在的，参见 RFC675 The TCP as a POST OFFICE，但最初它以一种很奇怪的方式定义这个 C/S 结构： Server 指定 local address 和 foreign address，只有来自该特定 foreign address 的 packet 发往该 local…
阅读更多...
代码实战：基于InvSR对视频进行超分辨率重建

代码实战：基于InvSR对视频进行超分辨率重建

Diffusion Models专栏文章汇总：入门与实战 前言：上一篇博客《使用Diffusion Models进行图像超分辩重建》中讲解了InvSR的原理，博主实测的效果是非常不错的，和PASD基本持平。这篇博客就讲解如何利用InvSR对视频进行超分辨率重建。 目录 环境准备 代码讲解 环境准备
阅读更多...
最新文章

Copyright @ 2022~2023