该工具用于编写和编辑 Google Docs,覆盖结构化写作、字符与段落样式、列表、表格、图片、页眉页脚等文档操作。
核心思路是避免手工计算索引:文档编辑基于单个标签页内的零基 UTF-16 索引范围,每次写入都会移动后续索引,猜测或过期的索引会静默命中错误段落。因此优先用 find_text 获取精确文本的全新 {start, end} 范围,再紧接调用 apply_text_style、apply_paragraph_style、delete_content、set_paragraph_format 等;create_list 用 firstItemText/lastItemText 锚点自行解析范围,每个列表单独调用一次,正确选择 BULLET_* 或 NUMBERED_* 预设。需要按结构取范围时,从 read_document 元素读取;注意 end 为排他,短一位会漏掉最后字符,长一位会误样式化后一字符。不得不使用原始索引时,先 read_document、只计算一次编辑、传入 requiredRevisionId、应用后再读取;多段位置编辑可从后往前进行。
创建文档时,create_document 生成空白文档;内容已知可优先用 google_drive_create_file 以 Markdown 导入。增量构建可用 insert_text 省略 index 追加段落,并在同一次调用中设置 paragraphStyle 与 bold/italic。创建无法直接设置父文件夹,需要时用 google_drive_move_or_rename。
样式方面,apply_text_style 支持粗体、斜体、下划线、删除线、字号、字体、文字与背景色、链接;apply_paragraph_style 设置命名样式,set_paragraph_format 设置对齐、缩进和行距。表格先插入空网格,再从最后单元格到第一格填入;填充后再按表格元素起始位置设置底纹、合并单元格和列宽。insert_image 需要可公开获取的 PNG/JPEG/GIF URL,尺寸以点为单位。页眉页脚用 set_header_footer 设置或清空,文本为静态,不支持页码字段。replace_text 可做全局或指定标签页的文本替换。
完成后可用 read_document 检查结构与样式,或用 google_drive_read_file 读取整篇 Markdown,或用 google_drive_export_file 导出 PDF 查看视觉效果。资料未提供收费、平台限制等更多信息。