SuperAPI AI 工具集

google-docs

办公与效率

查看项目

更新于 10-16 02:36

技能介绍

用途:通过 Google Docs API(基础地址 https://docs.googleapis.com/v1)对 Google 文档进行程序化编辑,适合在用户提及 Google Doc、docs.google.com、分享文档链接或要求创建、修改文档时使用。

主要能力:创建空白文档;读取文档完整内容或仅元数据;在开头或指定索引插入文本;删除内容区间;查找并替换文本;设置加粗、斜体、字号、颜色等文本样式;设置段落对齐;创建项目符号列表;插入表格、分页符和行内图片;通过 batchUpdate 合并多个操作。

使用方式:文档 ID 位于链接 https://docs.google.com/document/d/{DOCUMENT_ID}/edit 中。请求需携带 Authorization: Bearer $GOOGLE_DOCS_TOKEN 与 Content-Type: application/json。创建文档用 POST /v1/documents;读取用 GET /v1/documents/{document-id};修改用 POST /v1/documents/{document-id}:batchUpdate,请求体写入 /tmp/gdocs_request.json 后以 -d @/tmp/gdocs_request.json 提交。常用 scope 包括 documents.readonly、documents、drive.readonly、drive.file、drive,完整 URL 为 https://www.googleapis.com/auth/documents。

限制与注意:索引从 1 开始,每个字符、换行和结构元素都会递增索引,修改前应先读取文档内容确认索引;请求按顺序执行,后续请求会受前面操作影响;updateTextStyle 等需在 fields 中明确指定要更新的字段;RGB 颜色取值为 0.0 到 1.0;需确保认证用户拥有文档编辑权限;部分操作(如 updateParagraphStyle、insertTable、insertPageBreak、insertInlineImage)可能不返回 replies,无 .error 即表示成功。官方参考见 https://developers.google.com/docs/api/reference/rest。