一、申请腾讯文档开放平台应用

登录腾讯文档开放合作平台，注册成为开发者。创建第三方应用且应用审核成功后，系统将自动分配Client ID和Client Secret。

Client ID: 第三方应用的唯一标识。在OAuth2.0授权和后续OpenAPI调用流程中需要作为请求参数。 Client Secret: Client ID对应的密钥，在后台服务间接口调用时用来验证应用的合法性。

在集成服务云中，如图复制腾讯文档开放平台-API接入中的应用ID以及应用密钥，注意请求腾讯文档接口时请求协议只能为HTTPS，不然会报405错误。

注意：在申请开发账号时，图中回调域名应填写相应的苍穹服务器域名。

开发手册参考链接：开放平台介绍 | 腾讯文档开放平台开发文档 (qq.com)

浏览器版本要求

由于腾讯文档对iframe控件的跨域控制，在不同的浏览器中如果出现如下图所示的授权码显示错误的问题，目前可在chrome 80系列版本中进行设置显示，在Chrome 中打开 chrome://flags/#same-site-by-default-cookies 和 chrome://flags/#cookies-without-same-site-must-be-secure ，设置为 Disabled ，重启浏览器。具体步骤请参考https://blog.csdn.net/weixin_44202904/article/details/108848898

二、新增连接配置

在集成服务云中，新增连接配置时，选择“腾讯文档”连接类型对应的连接配置后，只需要将之前步骤获得的应用ID和应用密钥填写到集成服务云的配置界面中，如图所示，点击保存后点击认证按钮，弹出扫码认证授权界面后进行扫码，成功后则刷新token自动填充。

三、外部系统API登记及测试

首先在连接配置界面点击已保存的TencentDoc连接配置，弹出腾讯文档连接配置界面后点击创建数据源，弹出数据源管理窗口后点击保存。

在外部API登记列表页面中，选择如下腾讯文档API。 

1、新建文档API（新建文档 | 腾讯文档开放平台开发文档 (qq.com)）

其输入参数如图所示：

其中入参的type描述如下图所示，title为文档的标题。

得到的结果中url为新建的在线文档地址，用浏览器打开该地址可打开在线文档。ID为新建表格的唯一标识，可作为后续更新表格区域的入参使用。

2、更新表格区域API（更新区域内容 | 腾讯文档开放平台开发文档 (qq.com)）

该接口只针对于在线文档类型为sheet（表格），用于更新区域内的所有单元格的内容。示例如下图所示，请求结果中ret的值为0时，则更新成功。

入参示例：

{ "data" : {"values":[["555"]]},
 "bookID" : "300000000$LPqXSzqdlDkr"
 }

其中data中values的构造说明如下图，bookID值为文档ID。

其中bookID，有两种获取方式：

1. 从新建文档接口的响应结果中获取（ID值）。

2. 登录腾讯文档网页，打开指定文件，截取文档网址的编码后的文档ID值，如下图所示，根据文档ID转换API说明将网址中的文档编码ID转换成文档ID。 

调用API成功后，登录腾讯文档查看相应文档，如下图所示，可见输入值成功插入。

3、文档ID转换API（文档ID转换 | 腾讯文档开放平台开发文档 (qq.com)）

本接口用于支持文档ID（fileID）与编码后的文档ID（encodedID）相互转换其中入参示例如图所示：

其中type，value描述如下图，

示例中value值为encodedID，该值可登录腾讯文档网页，打开指定文件，截取获得，如下图所示。

其返回的成功结果为下图所示，其中fileID为文档ID，如果入参为文档ID（fileID），则返回结果为encodedID，编码后的文档ID。

参考

集成服务云使用指南：https://club.kdcloud.com/article/45312

集成服务云新特性发布汇总：https://club.kdcloud.com/article/146134

集成云常见问题处理合集: https://vip.kingdee.com/article/45556