Skip to content

概述

借助AirScript的高级服务,开发者只需要完成较少设置,即可连接到某些公开的金山文档API。 它们的使用方式与AirScript脚本的内置函数十分相似。

AirScript在运行时会自动处理授权流程。 不过开发者必须启用高级服务,才能在脚本中使用该服务,若跳过该步骤,会因为找不到该服务而抛出undefined错误。

启用高级服务

要使用高级服务,请按以下说明操作:

  1. 打开效率-AirScript编辑工具弹出编辑页面。
  2. 点击AirScript编辑工具上方的服务
  3. 点击添加服务
  4. 选择一项服务,然后点击确认

启用高级服务后,该服务会在自动补全中显示。

授权流程

AirScript需要用户授权才能访问高级服务中的私密数据。

授予运行权限

AirScript会根据开发者编写脚本时启用高级服务的配置内容来确定授权范围 (例如访问指定文件或访问网络)。如果脚本需要授权,用户在运行脚本时会弹出授权对话框。 描述这个脚本涉及到的授权范围。

普通的代码更改并不会清空用户对脚本的授权。但如果开发者对更改了高级服务的配置(新增,修改或删除), 那用户对脚本的授权也会清空,再次运行脚本时会重新触发授权流程。

注意:我的脚本中的脚本的所有权完全归属于用户本身,该分类运行脚本时无需触发授权流程。

取消授权

用户可以对已授权的脚本手动取消授权,请按以下说明操作

  1. 打开效率-AirScript编辑工具弹出编辑页面。
  2. 找到文件共享脚本下的想取消授权的脚本,点击 显示更多操作。
  3. 点击取消服务授权

使用限制

为防止向用户提供恶意的脚本,出于安全性考虑,使用高级服务存在一些限制。

  • 过于高频地使用高级服务,当出现这种情况时,脚本的运行会抛出明显的错误通知用户异常调用。
  • 使用HTTP服务时,禁止使用IP地址发起请求,禁止使用端口发起请求。
  • 使用HTTP服务时,收到内容的消息体最大为2M,超过2M会抛出错误。
  • 使用KSDrive.openFile 获得的File对象没有调用close, 就再次使用KSDrive.openFile 会报错。