当前位置： 首页 > article >正文

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

article 2025/1/6 10:22:54

智能表格

应用限制条件

在这里插入图片描述

获取 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.kler.cn/a/465601.html

相关文章：

  • 《learn_the_architecture_-_aarch64_exception_model》学习笔记
  • Science Robotics让软机器人“活”得更久的3D打印！
  • 力扣--494.目标和
  • 浅谈分布式共识算法
  • Maven 教程之 pom.xml 详解
  • 在Ubuntu 18.04.6 LTS安装OpenFace流程
  • 实战项目模块之1------单个按键短按切换不同工作模式
  • 《HarmonyOS第一课》焕新升级，赋能开发者快速掌握鸿蒙应用开发
  • 【前端系列】Pinia状态管理库
  • 测试岗位面试常见的数据库问题及解答
  • gitlab高级功能之 CICD Steps
  • 微前端Webpack集成Vite子应用避坑指南
  • 微信小程序获取后端数据
  • PS4代理伺服器指南
  • JavaScript 基础2
  • 【网络安全】PostMessage：分析JS实现XSS
  • .e01, ..., .e0n的分卷压缩包怎么解压
  • 多目标优化算法——基于分解的多目标进化算法（MOEA-D）
  • [C++]vector（超详细）
  • Docker入门常用命令总结
  • 软考教材重点内容 信息安全工程师 第 12 章网络安全审计技术原理与应用
  • 牛客网刷题 ——C语言初阶——OR76 两个整数二进制位不同个数
  • 计算效率提升 10 倍，存储成本降低 60%，灵犀科技基于 Apache Doris 建设统一数据服务平台
  • Swift Combine 学习（三）：Subscription和 Subscriber
  • React Router 用法概览
  • Redis的数据过期清除策略