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

news2025/3/13 19:23:55

智能表格

应用限制条件

在这里插入图片描述

获取 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  Current
                                 Dload  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  Current
                                 Dload  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.coloradmin.cn/o/2271288.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

调试：用电脑开发移动端网页，然后用手机真机调试

调试：用电脑开发移动端网页，然后用手机真机调试

一、背景 电脑开发移动端，然后想真机调试... 二、实现 2.1、电脑和手机链接相同局域网 2.2、pnpm run dev 启动项目 2.3、浏览器访问 localhost:3001/login 2.4、Windowsr 输入cmd，在cmd输入 ipconfig 2.5、浏览器访问 ip地址加/login 2.6、手机端…
阅读更多...
华为ensp-BGP路由过滤

华为ensp-BGP路由过滤

学习新思想，争做新青年，今天学习的是BGP路由过滤 实验目的： 掌握利用BGP路由属性AS_Path进行路由过滤的方法 掌握利用BGP路由属性Community进行路由过滤的方法 掌握利用BGP路由属性Next_Hop进行路由过滤的方法 实验内容： 本实…
阅读更多...
【书籍连载】《软件测试架构实践与精准测试》| 有关软件测试模型的调查结果

【书籍连载】《软件测试架构实践与精准测试》| 有关软件测试模型的调查结果

各位软件领域的精英们，今天小编邀请你继续深入学习《软件测试架构实践与精准测试》。 《软件测试架构实践与精准测试》是作者李龙（安畅检测首席技术专家）基于软件测试“川模型”的著作。本书结合作者首次提出的软件测试新的模型“川模型”测试…
阅读更多...
nginx学习之路-windows系统安装nginx

nginx学习之路-windows系统安装nginx

文章目录 1. 下载2. 启动3. 验证参考文档 1. 下载 官方下载地址：https://nginx.org/en/download.html 可以下载windows版本，如nginx-1.26.2.zip。解压后，加入系统变量。 2. 启动 可以使用命令行启动（windows系统自带的cmd可能…
阅读更多...
word中编号统一格式

word中编号统一格式

不要手敲编号，要利用工具来。要善于利用多级编号和编号，分别对标题和段落进行组织 尤其是段落和标题特别多的时候，像毕设、标书这些 为什么呢？因为这样更方便修改，后续的增加和删除段落，编号会自动排列&am…
阅读更多...
MQ-导读

MQ-导读

什么是MQ？ MQ是一款消息中间件，通常被称为"消息队列",用于分布式架构中上下文的异步通信， 由三个角色组成： 1. 消息提供者：发送消息的人 2. 消息接收者：接收、处理消息的人 3. 消息代理者&#x…
阅读更多...
深入剖析MySQL数据库架构：核心组件、存储引擎与优化策略（四）

深入剖析MySQL数据库架构：核心组件、存储引擎与优化策略（四）

慢查询日志，顾名思义，就是查询慢的日志，是指mysql记录所有执行超过long_query_time（默认的时间10秒）参数设定的时间阈值的SQL语句的日志。该日志能为SQL语句的优化带来很好的帮助。默认情况下，慢查询日志是…
阅读更多...
MySQL数据库笔记——版本号机制和CAS（Compare And Swap）

MySQL数据库笔记——版本号机制和CAS（Compare And Swap）

大家好，这里是Good Note，关注 公主号：Goodnote，本文详细介绍乐观锁的两种实现方式：版本号机制和CAS（Compare And Swap）。 文章目录 MySQL 内置的并发控制机制MVCC（多版本并发控制&am…
阅读更多...
使用 commitlint 和 husky 检查提交描述是否符合规范要求

使用 commitlint 和 husky 检查提交描述是否符合规范要求

在上一小节中，我们了解了 Git hooks 的概念，那么接下来我们就使用 Git hooks 来去校验我们的提交信息。 要完成这么个目标，那么我们需要使用两个工具： 注意：npm 需要在 7.x 以上版本。 1. commitlint 用于检查提交信…
阅读更多...
使用函数求e的近似值（PTA）C语言

使用函数求e的近似值（PTA）C语言

自然常数e可以用级数11/1!1/2!⋯1/n!来近似计算。本题要求实现一个计算阶乘的简单函数，使得可以利用该函数，对给定的非负整数n，求该级数的前n1项和。 函数接口定义： double fact( int n ); 其中n是用户传入的参数，函…
阅读更多...
使用Clion在ubuntu上进行交叉编译，并在Linux上远程编译五子棋

使用Clion在ubuntu上进行交叉编译，并在Linux上远程编译五子棋

目录 1.工具以及概念介绍 （1）Clion软件简介 （2）交叉编译 （3）远程编译 2.操作原理 3.详细操作步骤 （1）配置Clion与虚拟机ubuntu的ssh连接 CLion远程开发Ubuntu，并显…
阅读更多...
ubuntu如何禁用 Snap 更新

ubuntu如何禁用 Snap 更新

.禁用 Snap 更新（通过修改 snapd 配置） 打开并编辑 /etc/apt/apt.conf.d/50unattended-upgrades文件。 这个文件控制自动更新的行为。 sudo vim /etc/apt/apt.conf.d/50unattended-upgrades 里面有一行将里面的auto改为false即可禁用更新：…
阅读更多...
SpringBoot - Spring Profiles 详解

SpringBoot - Spring Profiles 详解

文章目录 Pre官方文档Spring Profiles 详解1. 基本用法2. 激活 Profiles3. 添加 Active Profiles4. Profile Groups5. 在代码中设置 Profiles6. Profile 特定的配置文件 总结 Pre SpringBoot - Spring Boot 中的配置体系Profile全面解读 SpringBoot - spring.profiles.active…
阅读更多...
MyBatis如何处理延迟加载？

MyBatis如何处理延迟加载？

大家好，我是锋哥。今天分享关于【MyBatis如何处理延迟加载？】面试题。希望对大家有帮助； MyBatis如何处理延迟加载？ 1000道 互联网大厂Java工程师 精选面试题-Java资源分享网 在 MyBatis 中，延迟加载（Laz…
阅读更多...
ELK 使用教程采集系统日志 Elasticsearch、Logstash、Kibana

ELK 使用教程采集系统日志 Elasticsearch、Logstash、Kibana

前言 你知道对于一个系统的上线考察，必备的几样东西是什么吗？其实这也是面试中考察求职者，是否真的做过系统开发和上线的必备问题。包括：服务治理(熔断/限流) (opens new window)、监控 (opens new window)和日志，如果…
阅读更多...
重庆市大数据局：基于可信数据空间的公共数据流通利用

重庆市大数据局：基于可信数据空间的公共数据流通利用

在2024年可信数据空间论坛上，重庆市大数据局相关领导发表了题为：基于可信数据空间的公共数据流通利用的演讲，系统介绍了重庆公共数据流通方面的实践经验和案例。 篇幅限制，部分内容如下：
阅读更多...
Sublime Text4 4189 安装激活【 2025年1月3日 亲测可用】

Sublime Text4 4189 安装激活【 2025年1月3日 亲测可用】

-----------------测试时间2025年1月3日------------------- 下载地址 官方网址：https://www.sublimetext.com 更新日志：https://www.sublimetext.com/download V4189 64位：https://www.sublimetext.com/download_thanks?targetwin-x64 ....…
阅读更多...
LabVIEW开发中常见硬件通讯接口快速识别

LabVIEW开发中常见硬件通讯接口快速识别

在 LabVIEW 开发中，与硬件进行通讯是实现数据采集与控制的重要环节。准确判断通讯接口类型和协议，可以提高开发效率，减少调试时间。本文结合 LabVIEW 的实际应用，详细介绍如何识别和判断常见硬件通讯接口的定义，并提供…
阅读更多...
刷机TP TP-Link-WDR5660【持续更新】

刷机TP TP-Link-WDR5660【持续更新】

上文中简单介绍了：路由器刷机TP-Link tp-link-WDR5660 路由器升级宽带速度-CSDN博客 步骤如下： 第一步：安装Linux系统 本文使用virtualBox 安装Ubuntu的debian系统，本文不在讲述章 请自行参考：Kali 安装之腾讯云经验…
阅读更多...
Linux-Redis哨兵搭建

Linux-Redis哨兵搭建

环境资源准备 主机名IP端口号角色vm1192.168.64.156379/26379mastervm2192.168.64.166379/26379slavevm3192.168.64.176379/26379slave 6379为redis服务暴露端口号、26379为sentinel暴露端口号。 安装Redis # 包文件下载 wget https://github.com/redis/redis/archive/7.2.2…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023