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

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

Google Docs Skill

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

通过 OAuth 2.0 认证，集成 Google Docs API，实现文档的创建、读取、更新、格式化和管理。

Google Docs API 集成

功能概述

Google Docs API 集成是一项面向实际任务的技能，主要用于Direct 访问 Google Docs API 使用 OAuth 2. 0. 创建文档,插入和格式文本,并管理文档内容.；Prerequisites.；

核心要点

  • Google Cloud Project Setup.。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

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

Google Docs API 集成

使用 OAuth 2.0 直接访问 Google Docs API。支持创建文档、插入与格式化文本，以及管理文档内容。

前提条件

  1. Google Cloud 项目配置

    • 访问 Google Cloud Console
    • 新建项目或选择已有项目
    • 启用 Google Docs API
    • 创建 OAuth 2.0 凭据（桌面应用或 Web 应用）
    • 下载凭据 JSON 文件

  2. 环境配置

    export GOOGLE_CLIENT_ID="your-client-id"
export GOOGLE_CLIENT_SECRET="your-client-secret"
export GOOGLE_REFRESH_TOKEN="your-refresh-token"

认证

获取 OAuth Token

使用以下 Python 脚本获取刷新令牌（一次性设置）：

import urllib.request
import urllib.parse
import json
import webbrowser
from http.server import HTTPServer, BaseHTTPRequestHandler
import os

# OAuth 配置
CLIENT_ID = os.environ.get('GOOGLE_CLIENT_ID')
CLIENT_SECRET = os.environ.get('GOOGLE_CLIENT_SECRET')
REDIRECT_URI = 'http://localhost:8080'
SCOPES = 'https://www.googleapis.com/auth/documents'

# 步骤 1：获取授权码
auth_url = (
    f"https://accounts.google.com/o/oauth2/v2/auth?"
    f"client_id={CLIENT_ID}&"
    f"redirect_uri={REDIRECT_URI}&"
    f"response_type=code&"
    f"scope={urllib.parse.quote(SCOPES)}&"
    f"access_type=offline&"
    f"prompt=consent"
)

print("正在打开浏览器进行授权...")
webbrowser.open(auth_url)

# 步骤 2：捕获授权码
auth_code = None

class OAuthHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        global auth_code
        query = urllib.parse.urlparse(self.path).query
        params = urllib.parse.parse_qs(query)
        auth_code = params.get('code', [None])[0]
        
        self.send_response(200)
        self.send_header('Content-type', 'text/html')
        self.end_headers()
        self.wfile.write(b'
授权成功！
您可以关闭此窗口。
')

server = HTTPServer(('localhost', 8080), OAuthHandler)
server.handle_request()

# 步骤 3：使用授权码换取 Token
if auth_code:
    data = urllib.parse.urlencode({
        'code': auth_code,
        'client_id': CLIENT_ID,
        'client_secret': CLIENT_SECRET,
        'redirect_uri': REDIRECT_URI,
        'grant_type': 'authorization_code'
    }).encode()
    
    req = urllib.request.Request('https://oauth2.googleapis.com/token', data=data)
    response = json.load(urllib.request.urlopen(req))
    
    print(f"\n刷新令牌（Refresh Token）: {response['refresh_token']}")
    print(f"访问令牌（Access Token）: {response['access_token']}")
    print(f"\n请设置您的刷新令牌：")
    print(f"export GOOGLE_REFRESH_TOKEN=\"{response['refresh_token']}\"")

获取访问令牌

在调用 API 前，请先获取新的访问令牌：

import urllib.request
import urllib.parse
import json
import os

def get_access_token():
    """使用刷新令牌获取新的访问令牌"""
    data = urllib.parse.urlencode({
        'client_id': os.environ['GOOGLE_CLIENT_ID'],
        'client_secret': os.environ['GOOGLE_CLIENT_SECRET'],
        'refresh_token': os.environ['GOOGLE_REFRESH_TOKEN'],
        'grant_type': 'refresh_token'
    }).encode()
    
    req = urllib.request.Request('https://oauth2.googleapis.com/token', data=data)
    response = json.load(urllib.request.urlopen(req))
    return response['access_token']

# 缓存供后续复用
access_token = get_access_token()
print(f"访问令牌（Access Token）: {access_token}")

基础 URL

https://docs.googleapis.com/v1

所有请求均需在 Authorization 请求头中携带访问令牌：

Authorization: Bearer {access_token}

快速开始

import urllib.request
import json
import os

# 首先获取访问令牌（使用上方定义的函数）
access_token = get_access_token()

# 获取文档
req = urllib.request.Request('https://docs.googleapis.com/v1/documents/{documentId}')
req.add_header('Authorization', f'Bearer {access_token}')
doc = json.load(urllib.request.urlopen(req))
print(json.dumps(doc, indent=2))

API 参考

创建文档

import urllib.request
import json

access_token = get_access_token()

data = json.dumps({'title': 'My New Document'}).encode()
req = urllib.request.Request(
    'https://docs.googleapis.com/v1/documents',
    data=data,
    method='POST'
)
req.add_header('Authorization', f'Bearer {access_token}')
req.add_header('Content-Type', 'application/json')

response = json.load(urllib.request.urlopen(req))
doc_id = response['documentId']
print(f"已创建文档: {doc_id}")
print(f"URL: https://docs.google.com/document/d/{doc_id}/edit")

获取文档

req = urllib.request.Request(
    f'https://docs.googleapis.com/v1/documents/{doc_id}'
)
req.add_header('Authorization', f'Bearer {access_token}')
doc = json.load(urllib.request.urlopen(req))

批量更新文档

# 在文档开头插入文本
updates = {
    'requests': [
        {
            'insertText': {
                'location': {'index': 1},
                'text': 'Hello, World!\n\n'
            }
        }
    ]
}

data = json.dumps(updates).encode()
req = urllib.request.Request(
    f'https://docs.googleapis.com/v1/documents/{doc_id}:batchUpdate',
    data=data,
    method='POST'
)
req.add_header('Authorization', f'Bearer {access_token}')
req.add_header('Content-Type', 'application/json')

response = json.load(urllib.request.urlopen(req))

常用操作

插入文本

{
    'requests': [
        {
            'insertText': {
                'location': {'index': 1},
                'text': 'Your text here'
            }
        }
    ]
}

格式化文本（加粗、斜体、字号）

{
    'requests': [
        {
            'updateTextStyle': {
                'range': {
                    'startIndex': 1,
                    'endIndex': 10
                },
                'textStyle': {
                    'bold': True,
                    'italic': True,
                    'fontSize': {
                        'magnitude': 14,
                        'unit': 'PT'
                    }
                },
                'fields': 'bold,italic,fontSize'
            }
        }
    ]
}

插入表格

{
    'requests': [
        {
            'insertTable': {
                'location': {'index': 1},
                'rows': 3,
                'columns': 4
            }
        }
    ]
}

替换文本

{
    'requests': [
        {
            'replaceAllText': {
                'containsText': {
                    'text': '{{placeholder}}',
                    'matchCase': True
                },
                'replaceText': 'Actual value'
            }
        }
    ]
}

删除内容

{
    'requests': [
        {
            'deleteContentRange': {
                'range': {
                    'startIndex': 1,
                    'endIndex': 50
                }
            }
        }
    ]
}

插入分页符

{
    'requests': [
        {
            'insertPageBreak': {
                'location': {'index': 1}
            }
        }
    ]
}

更新段落样式

{
    'requests': [
        {
            'updateParagraphStyle': {
                'range': {
                    'startIndex': 1,
                    'endIndex': 50
                },
                'paragraphStyle': {
                    'namedStyleType': 'HEADING_1',
                    'alignment': 'CENTER'
                },
                'fields': 'namedStyleType,alignment'
            }
        }
    ]
}

完整示例：创建并格式化文档

import urllib.request
import urllib.parse
import json
import os

def get_access_token():
    """获取新的访问令牌"""
    data = urllib.parse.urlencode({
        'client_id': os.environ['GOOGLE_CLIENT_ID'],
        'client_secret': os.environ['GOOGLE_CLIENT_SECRET'],
        'refresh_token': os.environ['GOOGLE_REFRESH_TOKEN'],
        'grant_type': 'refresh_token'
    }).encode()
    
    req = urllib.request.Request('https://oauth2.googleapis.com/token', data=data)
    response = json.load(urllib.request.urlopen(req))
    return response['access_token']

def create_document(title, access_token):
    """创建新文档"""
    data = json.dumps({'title': title}).encode()
    req = urllib.request.Request(
        'https://docs.googleapis.com/v1/documents',
        data=data,
        method='POST'
    )
    req.add_header('Authorization', f'Bearer {access_token}')
    req.add_header('Content-Type', 'application/json')
    
    response = json.load(urllib.request.urlopen(req))
    return response['documentId']

def batch_update(doc_id, requests, access_token):
    """对文档执行批量更新"""
    data = json.dumps({'requests': requests}).encode()
    req = urllib.request.Request(
        f'https://docs.googleapis.com/v1/documents/{doc_id}:batchUpdate',
        data=data,
        method='POST'
    )
    req.add_header('Authorization', f'Bearer {access_token}')
    req.add_header('Content-Type', 'application/json')
    
    return json.load(urllib.request.urlopen(req))

# 主流程
access_token = get_access_token()

# 创建文档
doc_id = create_document('Project Report', access_token)
print(f"已创建: https://docs.google.com/document/d/{doc_id}/edit")

# 添加带格式的内容
requests = [
    # 插入标题
    {
        'insertText': {
            'location': {'index': 1},
            'text': 'Project Report\n\n'
        }
    },
    # 将标题设为一级标题
    {
        'updateParagraphStyle': {
            'range': {'startIndex': 1, 'endIndex': 15},
            'paragraphStyle': {'namedStyleType': 'HEADING_1'},
            'fields': 'namedStyleType'
        }
    },
    # 添加正文
    {
        'insertText': {
            'location': {'index': 16},
            'text': 'Executive Summary\n\nThis report covers...\n\n'
        }
    },
    # 格式化章节标题
    {
        'updateParagraphStyle': {
            'range': {'startIndex': 16, 'endIndex': 34},
            'paragraphStyle': {'namedStyleType': 'HEADING_2'},
            'fields': 'namedStyleType'
        }
    }
]

batch_update(doc_id, requests, access_token)
print("文档更新成功！")

核心概念

文档索引机制

  • 索引基于 1（文档起始位置索引为 1）
  • 每个字符（包括换行符）占用一个索引位置
  • 如需在末尾追加内容，请使用 endOfSegmentLocation

批量更新

  • 多个请求以原子方式统一提交执行
  • 请求按顺序依次处理
  • 执行更新前应先获取当前文档状态，以确定准确的索引位置

字段掩码（Field Masks）

  • 更新样式时，需明确指定要修改的字段
  • 使用逗号分隔的字段名列表，例如：'fields': 'bold,fontSize,foregroundColor'

错误处理

状态码 含义
400 错误请求 — 请求格式无效
401 未授权 — 访问令牌无效或已过期
403 禁止访问 — 权限不足
404 未找到 — 文档不存在
429 请求频率超限 — 请求次数过多

令牌刷新

访问令牌有效期为 1 小时。若收到 401 错误，请刷新令牌：

try:
    # 发起 API 请求
    req = urllib.request.Request(url)
    req.add_header('Authorization', f'Bearer {access_token}')
    response = urllib.request.urlopen(req)
except urllib.error.HTTPError as e:
    if e.code == 401:
        # 刷新令牌后重试
        access_token = get_access_token()
        req = urllib.request.Request(url)
        req.add_header('Authorization', f'Bearer {access_token}')
        response = urllib.request.urlopen(req)

最佳实践

  1. 令牌管理

    • 缓存访问令牌（有效期 1 小时）
    • 安全存储刷新令牌
    • 实现自动令牌刷新逻辑

  2. 批量操作

    • 将多个更新合并为单次批量调用
    • 减少 API 调用次数，提升性能

  3. 索引计算

    • 每次更新前务必先获取文档最新状态
    • 注意换行符（\n）也计入索引
    • 追加内容时优先使用 endOfSegmentLocation

  4. 速率限制

    • Google Docs API 具有配额限制（请在 Cloud Console 中查看）
    • 针对速率限制错误，建议实现指数退避（exponential backoff）重试机制

参考资料

作者最新文章

如何找回云文档网盘入口？

如何对表格文件进行密码加密？

如何开启PPT“备注页”视图模式？详细方法

如何在表格中不显示水平滚动条？

如何在 DynamoDB 中安全实现并发更新与乐观锁机制

热门AI工具

更多
SkildArt

SkildArt

Hot 豆包大模型

豆包大模型

 AionClaw

AionClaw

Hot UpDream

UpDream

Hot DeepSeek

DeepSeek

 火山引擎

火山引擎

Hot Atoms

Atoms

Hot VibeKnow

VibeKnow

Hot

相关专题

更多
Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw（AI龙虾助手）的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体，能直接在电脑上读写文件、运行脚本、操作浏览器，自动交付Word、PPT、Excel等成品。

2026.09.20

0

13

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程，涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能，帮助用户快速掌握AionClaw的实际使用方法。

2026.09.20

0

15

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单，涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比，助您快速选对适合创作需求的AI视频生成工具。

2026.09.16

0

9

ai生成视频的工具免费版合集
ai生成视频的工具免费版合集

本专题汇总了当前免费AI生成视频工具的排行榜与推荐清单，涵盖seko、讯飞智作、AniShort及剧云、Lovart等多模型集成平台。同时整理了各工具的免费额度、输出时长、水印政策及适用场景差异，助您快速选择合适工具开启AI视频创作。

2026.09.16

0

10

Pandas时间序列分析与可视化报表
Pandas时间序列分析与可视化报表

本专题整理Pandas日期转换、时间索引、重采样、滚动窗口、时区处理、plot绘图、Styler表格样式和报表输出方法。

2026.09.16

0

23

Pandas数据筛选索引与清洗处理
Pandas数据筛选索引与清洗处理

本专题整理Pandas中的loc、iloc、条件筛选、query查询、缺失值处理、重复值删除、类型转换和字符串列清洗方法。

2026.09.16

0

25

Pandas数据读取导入与文件导出处理
Pandas数据读取导入与文件导出处理

本专题整理Pandas读取CSV、Excel、JSON、SQL、Parquet等文件的方法，以及to_csv、to_excel、to_sql和to_parquet等常用数据导出流程。

2026.09.16

0

27

GDB怎么设置断点
GDB怎么设置断点

本专题介绍GDB按照函数名、源代码行号和文件位置设置断点的方法，详细说明run、continue、next、step等命令的配合使用，帮助定位程序崩溃、逻辑异常及代码未按预期执行的问题。

2026.09.11

0

28

GDB怎么查看变量值
GDB怎么查看变量值

本专题介绍GDB调试过程中查看变量值的具体方法，涵盖局部变量、函数参数、数组、结构体和指针内容查询，同时整理变量持续显示、格式化输出及无法读取变量时的排查思路。

2026.09.11

0

22

热门下载

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

相关下载

更多
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人学习

最新文章

更多
Jev接口报错不用慌:解析失败/超时/限流问题排查手册
高并发请求怎么优化?Jev接口限流与调优10招
Jev置信度阈值怎么设?不同场景的最佳参考值都在这
拿来即用:电商订单异常判断的Jev接口JSON示例
OpenRouter调用Jev全教程:接入方法+参数适配+避坑点
布尔判断Noul类型实战:条件分支场景的参数优化方案
Score类型配置指南:自定义数值区间+置信度返回完整教程
SpaceXAI 推出 Grok Voice Transcribe 2.0：错误率砍半、价格纹丝不动，流式语音识别登顶榜单
B 站上线“AI 无限竞技场”：百大模型同台 PK，GPT-6 Astra 暂居榜首
谷歌升级AI助手CC:支持最多6名家庭成员协同管理