Drive Google Docs via

curl + jq

. The user's OAuth bearer token is in

$GOOGLE_DOCS_TOKEN

; every call needs

Authorization: Bearer $GOOGLE_DOCS_TOKEN

. Base URL:

https://docs.googleapis.com/v1/documents

. The token carries

documents.readonly

(+ identity); writes need

documents

.

Failures are

{"error":{"code","message","status"}}

— show verbatim.

= re-install.

403 PERMISSION_DENIED

on a write = read-only scope.

The doc id is the

…/document/d/<ID>/edit

segment of the URL.

bash

D="https://docs.googleapis.com/v1/documents"; AUTH="Authorization: Bearer $GOOGLE_DOCS_TOKEN"

通过

curl + jq

操作Google Docs。用户的OAuth承载令牌存储在

$GOOGLE_DOCS_TOKEN

中；每次调用都需要带上

Authorization: Bearer $GOOGLE_DOCS_TOKEN

。基础URL：

https://docs.googleapis.com/v1/documents

。令牌包含

documents.readonly

（+身份验证）权限；写入操作需要

documents

权限。

错误返回格式为

{"error":{"code","message","status"}}

——需原样展示。

错误表示需要重新安装授权。写入时出现

403 PERMISSION_DENIED

错误表示当前为只读权限范围。

文档ID是URL中

…/document/d/<ID>/edit

部分的<ID>。

bash

D="https://docs.googleapis.com/v1/documents"; AUTH="Authorization: Bearer $GOOGLE_DOCS_TOKEN"

Read the document. The body is a tree of structural elements; pull plain text:

curl -sS -H "$AUTH" "$D/DOC_ID"
| jq -r '.title, ([.body.content[]?.paragraph?.elements[]?.textRun?.content] | join(""))'

undefined

curl -sS -H "$AUTH" "$D/DOC_ID"
| jq -r '.title, ([.body.content[]?.paragraph?.elements[]?.textRun?.content] | join(""))'

undefined

Create & edit

创建与编辑

bash

undefined

bash

undefined

Create an empty doc

curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json"
-d '{"title":"Meeting notes 2026-06-21"}' "$D" | jq '{documentId, title}'

Insert text at the start (index 1) via batchUpdate (confirm first)

curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json"
-d '{"requests":[{"insertText":{"location":{"index":1},"text":"Hello\n"}}]}'
"$D/DOC_ID:batchUpdate" | jq '.documentId'

Replace all occurrences of a placeholder

curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json"
-d '{"requests":[{"replaceAllText":{"containsText":{"text":"{{name}}","matchCase":true},"replaceText":"Alex"}}]}'
"$D/DOC_ID:batchUpdate" | jq '.replies'

undefined

curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json"
-d '{"requests":[{"replaceAllText":{"containsText":{"text":"{{name}}","matchCase":true},"replaceText":"Alex"}}]}'
"$D/DOC_ID:batchUpdate" | jq '.replies'

undefined

Gotchas

注意事项

The document model is index-based: text edits target character indices, and every insert shifts later indices — for multiple inserts, apply them back-to-front or recompute indices between calls.
To get clean Markdown/plain text, walk
```
body.content[].paragraph.elements[] .textRun.content
```
(the jq above). Tables / lists need deeper traversal.
Creating a doc puts it in the user's Drive root; use the
```
google-drive
```
skill to move/share it.

文档模型是基于索引的：文本编辑以字符索引为目标，每次插入操作都会改变后续索引——如果要执行多次插入，需从后往前操作，或者在每次调用之间重新计算索引。
若要获取整洁的Markdown/纯文本，需遍历
```
body.content[].paragraph.elements[] .textRun.content
```
（如上述jq命令所示）。表格/列表需要更深入的遍历。
创建的文档会存放在用户的Drive根目录中；可使用
```
google-drive
```
技能来移动/共享文档。

google-docs

Original

Translation

Read the document. The body is a tree of structural elements; pull plain text:

Read the document. The body is a tree of structural elements; pull plain text:

Create & edit

创建与编辑

Create an empty doc

Create an empty doc

Insert text at the start (index 1) via batchUpdate (confirm first)

Insert text at the start (index 1) via batchUpdate (confirm first)

Replace all occurrences of a placeholder

Replace all occurrences of a placeholder

Gotchas

注意事项