首页 专区 Skill 文章 专题 AI工具 学习 编程手册

PHP MySQL jquery HTML CSS
首页 > Skill > 知识管理

Google Docs

Polar Sponsor
爱发电 赞助
.NET 9.0
立即下载

与托管 OAuth 集成的 Google Docs API。支持创建文档、插入文本、应用格式化样式以及管理文档内容。当用户需要与 Google Docs 进行交互时，请使用此技能。对于其他第三方应用，请使用 api-gateway 技能（https://clawhub.ai/byungkyu/api-gateway）。

Google Docs: 使用管理好的 OAuth 认证访问 Google Docs API. 创建文档,插入和格式文本,并管理文档内容.

功能概述

Google Docs: 使用管理好的 OAuth 认证访问 Google Docs API. 创建文档,插入和格式文本,并管理文档内容.是一项面向实际任务的技能，主要用于QQS快速启动.；CLI:.；

核心要点

  • Python:.；
  • Base URL.；
  • Maton Proxies requ。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

Google Docs

通过受管 OAuth 认证访问 Google Docs API。支持创建文档、插入与格式化文本，以及管理文档内容。

快速开始

CLI：

maton google-docs document view DOC_ID

maton api '/google-docs/v1/documents/{documentId}'

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/google-docs/v1/documents/{documentId}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

基础 URL

https://api.maton.ai/google-docs/{native-api-path}

Maton 将请求代理至 docs.googleapis.com，并自动注入您的 OAuth Token。

安装

NPM：

npm install -g @maton/cli

Homebrew：

brew install maton-ai/cli/maton

认证

CLI：

maton login                          # 打开浏览器获取 API 密钥
maton login --interactive            # 跳过浏览器，直接粘贴 API 密钥
maton whoami                         # 显示当前认证状态

手动配置：

  1. 在 maton.ai 登录或注册账户
  2. 访问 maton.ai/settings
  3. 复制您的 API 密钥
  4. 将 API 密钥设为环境变量 MATON_API_KEY：
export MATON_API_KEY="YOUR_API_KEY"

连接管理

在 https://api.maton.ai 管理您的 Google OAuth 连接。

列出连接

CLI：

maton connection list google-docs --status ACTIVE

maton api -X GET /connections -f app=google-docs -f status=ACTIVE

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=google-docs&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建连接

CLI：

maton connection create google-docs

maton api /connections -f app=google-docs

Python：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'google-docs'}).encode()
req = urllib.request.Request('https://api.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

获取连接

CLI：

maton connection view {connection_id}

maton api /connections/{connection_id}

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应示例：

{
  "connection": {
    "connection_id": "{connection_id}",
    "status": "ACTIVE",
    "creation_time": "2025-12-08T07:20:53.488460Z",
    "last_updated_time": "2026-01-31T20:03:32.593153Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "google-docs",
    "metadata": {}
  }
}

在浏览器中打开返回的 url 以完成 OAuth 授权。

删除连接

CLI：

maton connection delete {connection_id}

maton api -X DELETE /connections/{connection_id}

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

若您拥有多个 Google Docs 连接，请显式指定要使用的连接：

CLI：

maton google-docs document view DOC_ID --connection {connection_id}

maton api /google-docs/v1/documents/{documentId} --connection {connection_id}

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/google-docs/v1/documents/{documentId}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '{connection_id}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

若存在多个连接，务必始终指定连接，以确保请求路由至目标账户。

安全与权限

  • 访问范围限定于已连接 Google Docs 账户内的文档、内容、格式及文档元数据。
  • 所有写入操作均需用户显式授权。 在执行任何创建（create）、更新（update）或删除（delete）调用前，必须向用户确认目标资源及其预期影响。

API 参考

获取文档

GET /google-docs/v1/documents/{documentId}

示例：

maton google-docs document view DOC_ID            # 人类可读摘要（ID、标题、修订版本）
maton google-docs document view DOC_ID --json     # 完整文档载荷（正文、样式等）

创建文档

POST /google-docs/v1/documents
Content-Type: application/json

{
  "title": "New Document"
}

示例：

maton google-docs document create --title 'New Document'

批量更新文档

POST /google-docs/v1/documents/{documentId}:batchUpdate
Content-Type: application/json

{
  "requests": [
    {
      "insertText": {
        "location": {"index": 1},
        "text": "Hello, World!"
      }
    }
  ]
}

示例：

maton google-docs document write DOC_ID --text 'Hello, World!'

常用 batchUpdate 请求类型

插入文本

{
  "insertText": {
    "location": {"index": 1},
    "text": "Text to insert"
  }
}

删除内容

{
  "deleteContentRange": {
    "range": {
      "startIndex": 1,
      "endIndex": 10
    }
  }
}

替换全部文本

{
  "replaceAllText": {
    "containsText": {
      "text": "{{placeholder}}",
      "matchCase": true
    },
    "replaceText": "replacement value"
  }
}

插入表格

{
  "insertTable": {
    "location": {"index": 1},
    "rows": 3,
    "columns": 3
  }
}

更新文本样式

{
  "updateTextStyle": {
    "range": {
      "startIndex": 1,
      "endIndex": 10
    },
    "textStyle": {
      "bold": true,
      "fontSize": {"magnitude": 14, "unit": "PT"}
    },
    "fields": "bold,fontSize"
  }
}

插入分页符

{
  "insertPageBreak": {
    "location": {"index": 1}
  }
}

代码示例

CLI

# 创建新文档
maton google-docs document create --title 'Sprint notes'

# 查看文档
maton google-docs document view DOC_ID

# 向文档写入文本
maton google-docs document write DOC_ID --text 'Hello!'

JavaScript

// 创建文档
const response = await fetch(
  'https://api.maton.ai/google-docs/v1/documents',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    },
    body: JSON.stringify({ title: 'New Document' })
  }
);

// 插入文本
await fetch(
  `https://api.maton.ai/google-docs/v1/documents/${docId}:batchUpdate`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    },
    body: JSON.stringify({
      requests: [{ insertText: { location: { index: 1 }, text: 'Hello!' } }]
    })
  }
);

Python

import os
import requests

# 创建文档
response = requests.post(
    'https://api.maton.ai/google-docs/v1/documents',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
    json={'title': 'New Document'}
)

注意事项

  • 索引位置为 1-based（文档起始索引为 1）
  • 使用 endOfSegmentLocation 在末尾追加内容
  • batchUpdate 中的多个请求将原子性地应用
  • 建议先调用 Get Document 获取准确索引，再执行更新操作
  • 样式更新中的 fields 参数采用字段掩码（field mask）语法
  • 重要：使用 curl 命令时，若 URL 中含方括号（如 fields[]、sort[]、records[]），请添加 curl -g 参数禁用 glob 解析
  • 重要：当将 curl 输出管道传输至 jq 或其他命令时，在部分 Shell 环境下环境变量（如 $MATON_API_KEY）可能无法正确展开，导致“Invalid API key”错误

错误处理

状态码 含义
400 缺少 Google Docs 连接
401 Maton API 密钥无效或缺失
429 请求频率受限（每账户 10 次/秒）
4xx/5xx 来自 Google Docs API 的透传错误

故障排查：API 密钥问题

CLI：

  1. 检查当前认证状态：
maton whoami
  1. 通过列出连接验证 API 密钥有效性：
maton connection list

手动验证：

  1. 确认 MATON_API_KEY 环境变量已设置：
echo $MATON_API_KEY
  1. 通过列出连接验证 API 密钥有效性：
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

故障排查：应用名称无效

  1. 确保您的 URL 路径以 google-docs 开头。例如：
  • 正确：https://api.maton.ai/google-docs/v1/documents/{documentId}
  • 错误：https://api.maton.ai/docs/v1/documents/{documentId}

相关资源

  • Docs API 概览
  • 获取文档
  • 创建文档
  • 批量更新
  • 请求类型
  • 文档结构
  • Maton CLI 手册
  • Maton 社区
  • Maton 支持

作者最新文章

如何在屏幕旋转时保存并恢复九宫格按钮的文本状态

理解元素拖拽缩放中的“魔法数字”：为何需减去边框与内边距偏移量

理解元素拖拽缩放中的“魔法数字”：消除硬编码偏移量的正确实践

Drupal 9 中表单字段 ID 自动追加 ---2 的原因与解决方案

如何在动态生成的食谱列表中正确实现编辑与删除功能

热门AI工具

更多
Loomy

Loomy

Hot DeepSeek

DeepSeek

 VibeKnow

VibeKnow

Hot Seko

Seko

Hot PixPix

PixPix

Hot 豆包大模型

豆包大模型

 小橡皮AI

小橡皮AI

Hot 音述AI

音述AI

Hot

相关专题

更多
Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。

2026.10.22

0

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。

2026.10.22

0

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。

2026.10.22

0

15

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。

2026.10.22

0

10

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。

2026.10.22

0

25

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。

2026.10.22

0

15

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。

2026.10.22

0

15

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。

2026.10.22

0

12

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理，讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

2026.10.22

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多
MDPHP(麦迪php框架系统)1.1
PHP 多国语言框架2.0
ujframe简单快速PHP开发框架1.0
php轻量型框架1.0
MyQEE开源PHP多项目及模块化开发框架3.0 RC2
php开源学习型框架CMVC1.2.0
PHP框架Kohana3.3.1

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gemini Notebook官方手册
Gemini Notebook官方手册

共0课时 | 0人学习

Google Cloud开发者文档
Google Cloud开发者文档

共0课时 | 0人学习

Veo 3 官方文档
Veo 3 官方文档

共0课时 | 0人学习

最新文章

更多
纯国产算力跑出星火X2.6：刘庆峰直言“小米加步枪”硬刚封锁，端侧模型成破局关键
三十亿美元加码!英伟达与Meta联手重塑AI智能体新纪元
IDC评WPS：AI嵌入文档，数据留于企业
OpenAI官宣数学与物理学三大突破：AI攻克百年猜想，携手全球学者开启科学验证新模式
千问App重磅上线三大核心学习功能，精准狙击学生提分痛点
金山办公三季报：营收增长16.11%，经调整后净利润增长8.44%
千问办公接入乐奇AI眼镜，一句话发起任务
参数直逼2.8T、支持百万上下文：月之暗面发布开源旗舰大模型K3.1 Pro
苹果 iOS 27.2 给 AI 图片打上隐身水印
马斯克明年扫货 2 万套英伟达机架，成 Vera Rubin 最大买家