{"id":4383,"date":"2026-09-03T17:56:52","date_gmt":"2026-09-03T09:56:52","guid":{"rendered":"https:\/\/ai.jxgzhc.cn\/?p=4383"},"modified":"2026-09-03T17:56:55","modified_gmt":"2026-09-03T09:56:55","slug":"%e7%94%a8%e5%91%bd%e4%bb%a4%e8%a1%8c%e7%ae%a1%e7%90%86google-workspace","status":"publish","type":"post","link":"https:\/\/ai.jxgzhc.cn\/?p=4383","title":{"rendered":"\u7528\u547d\u4ee4\u884c\u7ba1\u7406Google Workspace"},"content":{"rendered":"

\"\u7528\u547d\u4ee4\u884c\u7ba1\u7406Google<\/p>\n

\u901a\u8fc7\u7b80\u5355\u7684\u547d\u4ee4\u884c\u6307\u4ee4\uff0c\u9ad8\u6548\u7ba1\u7406 Google Drive \u6587\u4ef6\u3001\u53d1\u9001\u90ae\u4ef6\u3001\u5b89\u6392\u4f1a\u8bae\u53ca\u81ea\u52a8\u5316\u529e\u516c\u6d41\u7a0b\u3002<\/strong><\/p>\n

\u8be6\u7ec6\u4ecb\u7ecd<\/h2>\n

gws<\/p>\n

\u4e00\u4e2a\u7528\u4e8e\u6240\u6709 Google Workspace \u7684\u547d\u4ee4\u884c\u5de5\u5177\u2014\u2014\u4e3a\u4eba\u7c7b\u548c AI \u4ee3\u7406\u8bbe\u8ba1\u3002
\u63d0\u4f9b Drive\u3001Gmail\u3001Calendar \u53ca\u6240\u6709 Workspace API \u7684\u8bbf\u95ee\u3002\u96f6\u6837\u677f\u4ee3\u7801\u3002\u7ed3\u6784\u5316 JSON \u8f93\u51fa\u3002\u5185\u7f6e 40+ \u4e2a\u4ee3\u7406\u6280\u80fd\u3002<\/p>\n

\u26a0\ufe0f \u8fd9\u4e0d\u662f Google \u5b98\u65b9\u652f\u6301\u7684\u6b63\u5f0f\u4ea7\u54c1\u3002<\/p>\n

\u524d\u63d0\u6761\u4ef6<\/p>\n

Node.js 18+ \uff08\u5982\u679c\u4f7f\u7528 npm \u5b89\u88c5\uff09\u6216\u76f4\u63a5\u4f7f\u7528\u9884\u7f16\u8bd1\u4e8c\u8fdb\u5236\u6587\u4ef6\uff08\u4ece GitHub Releases \u4e0b\u8f7d\uff09<\/p>\n

\u4e00\u4e2a Google Cloud \u9879\u76ee \u2014\u2014\u7528\u4e8e OAuth \u51ed\u636e\u3002\u53ef\u901a\u8fc7 Google Cloud Console \u6216\u4f7f\u7528 gcloud CLI \u6216\u8fd0\u884c gws auth setup \u521b\u5efa\u3002<\/p>\n

\u4e00\u4e2a\u62e5\u6709 Google Workspace \u8bbf\u95ee\u6743\u9650\u7684 Google \u8d26\u53f7<\/p>\n

\u5feb\u901f\u5f00\u59cb<\/p>\n

gws auth setup # \u5f15\u5bfc\u4f60\u5b8c\u6210 Google Cloud \u9879\u76ee\u914d\u7f6e
gws auth login # \u540e\u7eed OAuth \u767b\u5f55
gws drive files list –params '{"pageSize": 5}'<\/p>\n

\u4e3a\u4ec0\u4e48\u9009\u62e9 gws\uff1f<\/p>\n

\u5bf9\u4eba\u7c7b\u7528\u6237 \u2014\u2014\u4e0d\u518d\u9700\u8981\u624b\u52a8\u7f16\u5199 curl \u8c03\u7528\u5e76\u67e5\u9605 REST \u6587\u6863\u3002 gws \u4e3a\u6bcf\u4e2a\u8d44\u6e90\u63d0\u4f9b –help \u5e2e\u52a9\u3001 –dry-run \u9884\u89c8\u8bf7\u6c42\uff0c\u4ee5\u53ca\u81ea\u52a8\u5206\u9875\u3002<\/p>\n

\u5bf9 AI \u4ee3\u7406 \u2014\u2014\u6240\u6709\u54cd\u5e94\u90fd\u662f\u7ed3\u6784\u5316 JSON\u3002\u914d\u5408\u5185\u7f6e\u7684\u4ee3\u7406\u6280\u80fd\uff0c\u4f60\u7684 LLM \u65e0\u9700\u81ea\u5b9a\u4e49\u5de5\u5177\u5373\u53ef\u7ba1\u7406 Workspace\u3002<\/p>\n

# \u5217\u51fa\u6700\u8fd1 10 \u4e2a\u6587\u4ef6
gws drive files list –params '{"pageSize": 10}'<\/p>\n

# \u521b\u5efa\u7535\u5b50\u8868\u683c
gws sheets spreadsheets create –json '{"properties": {"title": "Q1 Budget"}}'<\/p>\n

# \u53d1\u9001 Chat \u6d88\u606f
gws chat spaces messages create \\
–params '{"parent": "spaces\/xyz"}' \\
–json '{"text": "Deploy complete."}' \\
–dry-run<\/p>\n

# \u67e5\u770b\u4efb\u610f\u65b9\u6cd5\u7684\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u5f0f
gws schema drive.files.list<\/p>\n

# \u6d41\u5f0f\u8f93\u51fa\u5206\u9875\u7ed3\u679c\uff08NDJSON \u683c\u5f0f\uff09
gws drive files list –params '{"pageSize": 100}' –page-all | jq -r '.files[].name'<\/p>\n

\u8ba4\u8bc1\u65b9\u5f0f<\/p>\n

CLI \u652f\u6301\u591a\u79cd\u8ba4\u8bc1\u5de5\u4f5c\u6d41\uff0c\u9002\u7528\u4e8e\u672c\u5730\u3001CI \u548c\u670d\u52a1\u5668\u73af\u5883\u3002<\/p>\n

\u5982\u4f55\u9009\u62e9\uff1f<\/p>\n

\u4f60\u7684\u60c5\u51b5
\u63a8\u8350\u65b9\u5f0f<\/p>\n

\u5df2\u5b89\u88c5\u5e76\u8ba4\u8bc1\u4e86 gcloud
gws auth setup \uff08\u6700\u5feb\uff09<\/p>\n

\u6709 GCP \u9879\u76ee\u4f46\u6ca1\u6709 gcloud
\u624b\u52a8 OAuth \u8bbe\u7f6e<\/p>\n

\u5df2\u6709 OAuth \u8bbf\u95ee\u4ee4\u724c
GOOGLE_WORKSPACE_CLI_TOKEN<\/p>\n

\u5df2\u6709\u51ed\u636e\u6587\u4ef6
GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE<\/p>\n

\u4ea4\u4e92\u5f0f\uff08\u672c\u5730\u684c\u9762\uff09<\/p>\n

\u51ed\u636e\u4ee5 AES-256-GCM \u52a0\u5bc6\u5b58\u50a8\uff0c\u5bc6\u94a5\u4fdd\u5b58\u5728\u64cd\u4f5c\u7cfb\u7edf\u5bc6\u94a5\u73af\u4e2d\uff08\u6216 ~\/.config\/gws\/.encryption_key \uff0c\u5f53\u8bbe\u7f6e GOOGLE_WORKSPACE_CLI_KEYRING_BACKEND=file \u65f6\uff09\u3002<\/p>\n

gws auth setup # \u4e00\u6b21\u6027\uff1a\u521b\u5efa Cloud \u9879\u76ee\uff0c\u542f\u7528 API\uff0c\u767b\u5f55
gws auth login # \u540e\u7eed\u7684\u4f5c\u7528\u57df\u9009\u62e9\u4e0e\u767b\u5f55<\/p>\n

gws auth setup \u9700\u8981\u5b89\u88c5 gcloud CLI \u3002\u5982\u679c\u6ca1\u6709 gcloud \uff0c\u8bf7\u4f7f\u7528\u4e0b\u9762\u7684 \u624b\u52a8 OAuth \u8bbe\u7f6e \u3002<\/p>\n

\u26a0\ufe0f \u6d4b\u8bd5\u6a21\u5f0f\u4e0b\u7684\u4f5c\u7528\u57df\u9650\u5236\uff1a \u5982\u679c\u4f60\u7684 OAuth \u5e94\u7528\u672a\u9a8c\u8bc1\uff08\u5904\u4e8e\u6d4b\u8bd5\u6a21\u5f0f\uff09\uff0cGoogle \u4f1a\u5c06\u540c\u610f\u5c4f\u5e55\u9650\u5236\u5728\u7ea6 25 \u4e2a\u4f5c\u7528\u57df\u3002 recommended \u4f5c\u7528\u57df\u9884\u8bbe\u5305\u542b 85+ \u4e2a\u4f5c\u7528\u57df\uff0c \u5728\u672a\u9a8c\u8bc1\u7684\u5e94\u7528\u4e2d\u4f1a\u5931\u8d25 \uff08\u7279\u522b\u662f @gmail.com \u8d26\u53f7\uff09\u3002\u8bf7\u9009\u62e9\u5355\u4e2a\u670d\u52a1\u6765\u8fc7\u6ee4\u4f5c\u7528\u57df\u9009\u62e9\u5668\uff1a<\/p>\n

gws auth login -s drive,gmail,sheets<\/p>\n

### \u624b\u52a8 OAuth \u8bbe\u7f6e\uff08Google Cloud Console\uff09<\/p>\n

\u5f53 `gws auth setup` \u65e0\u6cd5\u81ea\u52a8\u521b\u5efa\u9879\u76ee\/\u5ba2\u6237\u7aef\uff0c\u6216\u8005\u4f60\u5e0c\u671b\u5b8c\u5168\u63a7\u5236\u65f6\u4f7f\u7528\u6b64\u65b9\u5f0f\u3002<\/p>\n

1. \u5728\u76ee\u6807\u9879\u76ee\u7684 Google Cloud Console \u4e2d\u64cd\u4f5c\uff1a
– OAuth \u540c\u610f\u5c4f\u5e55\uff1a`https:\/\/console.cloud.google.com\/apis\/credentials\/consent?project=<PROJECT_ID>`
– \u51ed\u636e\uff1a`https:\/\/console.cloud.google.com\/apis\/credentials?project=<PROJECT_ID>`
2. \u5982\u679c\u63d0\u793a\uff0c\u914d\u7f6e OAuth \u54c1\u724c\/\u53d7\u4f17\uff1a
– \u5e94\u7528\u7c7b\u578b\uff1a**\u5916\u90e8**\uff08\u6d4b\u8bd5\u6a21\u5f0f\u5373\u53ef\uff09
3. \u5728 **\u6d4b\u8bd5\u7528\u6237** \u4e0b\u6dfb\u52a0\u4f60\u7684\u8d26\u53f7
4. \u521b\u5efa OAuth \u5ba2\u6237\u7aef\uff1a
– \u7c7b\u578b\uff1a**\u684c\u9762\u5e94\u7528**
5. \u4e0b\u8f7d\u5ba2\u6237\u7aef JSON \u5e76\u4fdd\u5b58\u5230\uff1a
– `~\/.config\/gws\/client_secret.json`<\/p>\n

> \u26a0\ufe0f **\u4f60\u5fc5\u987b\u5c06\u81ea\u5df1\u6dfb\u52a0\u4e3a\u6d4b\u8bd5\u7528\u6237\u3002** \u5728 OAuth \u540c\u610f\u5c4f\u5e55\u4e2d\uff0c\u70b9\u51fb **\u6d4b\u8bd5\u7528\u6237 \u2192 \u6dfb\u52a0\u7528\u6237**\uff0c\u8f93\u5165\u4f60\u7684 Google \u8d26\u53f7\u90ae\u7bb1\u3002\u5426\u5219\u767b\u5f55\u4f1a\u5931\u8d25\uff0c\u663e\u793a\u901a\u7528\u7684\u201c\u8bbf\u95ee\u88ab\u5c4f\u853d\u201d\u9519\u8bef\u3002<\/p>\n

\u7136\u540e\u8fd0\u884c\uff1a<\/p>\n

“`bash
gws auth login<\/p>\n

\u6d4f\u89c8\u5668\u8f85\u52a9\u8ba4\u8bc1\uff08\u4eba\u7c7b\u6216\u4ee3\u7406\uff09<\/p>\n

\u4f60\u53ef\u4ee5\u624b\u52a8\u5b8c\u6210 OAuth\uff0c\u6216\u4f7f\u7528\u6d4f\u89c8\u5668\u81ea\u52a8\u5316\u3002<\/p>\n

\u4eba\u7c7b\u6d41\u7a0b \uff1a\u8fd0\u884c gws auth login \uff0c\u6253\u5f00\u6253\u5370\u7684 URL\uff0c\u6279\u51c6\u4f5c\u7528\u57df\u3002<\/p>\n

\u4ee3\u7406\u8f85\u52a9\u6d41\u7a0b \uff1a\u4ee3\u7406\u6253\u5f00 URL\uff0c\u9009\u62e9\u8d26\u53f7\uff0c\u5904\u7406\u540c\u610f\u63d0\u793a\uff0c\u5728 localhost \u56de\u8c03\u6210\u529f\u540e\u4ea4\u56de\u63a7\u5236\u3002<\/p>\n

\u5982\u679c\u540c\u610f\u5c4f\u5e55\u663e\u793a \u201cGoogle \u5c1a\u672a\u9a8c\u8bc1\u6b64\u5e94\u7528\u201d \uff08\u6d4b\u8bd5\u6a21\u5f0f\uff09\uff0c\u8bf7\u70b9\u51fb \u7ee7\u7eed \u3002
\u5982\u679c\u51fa\u73b0\u4f5c\u7528\u57df\u590d\u9009\u6846\uff0c\u9009\u62e9\u6240\u9700\u4f5c\u7528\u57df\uff08\u6216 \u5168\u9009 \uff09\uff0c\u7136\u540e\u7ee7\u7eed\u3002<\/p>\n

\u65e0\u5934 \/ CI \u73af\u5883\uff08\u5bfc\u51fa\u6d41\u7a0b\uff09<\/p>\n

\u5728\u6709\u6d4f\u89c8\u5668\u7684\u673a\u5668\u4e0a\u5b8c\u6210\u4ea4\u4e92\u5f0f\u8ba4\u8bc1\u3002<\/p>\n

\u5bfc\u51fa\u51ed\u636e\uff1a gws auth export –unmasked > credentials.json<\/p>\n

\u5728\u65e0\u5934\u673a\u5668\u4e0a\uff1a export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=\/path\/to\/credentials.json
gws drive files list # \u76f4\u63a5\u4f7f\u7528<\/p>\n

\u670d\u52a1\u8d26\u53f7\uff08\u670d\u52a1\u5668\u5230\u670d\u52a1\u5668\uff09<\/p>\n

\u6307\u5411\u4f60\u7684\u5bc6\u94a5\u6587\u4ef6\uff0c\u65e0\u9700\u767b\u5f55\u3002<\/p>\n

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=\/path\/to\/service-account.json
gws drive files list<\/p>\n

\u9884\u5148\u83b7\u53d6\u7684\u8bbf\u95ee\u4ee4\u724c<\/p>\n

\u5f53\u5176\u4ed6\u5de5\u5177\uff08\u5982 gcloud \uff09\u5df2\u4e3a\u4f60\u751f\u6210\u4ee4\u724c\u65f6\u975e\u5e38\u6709\u7528\u3002<\/p>\n

export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)<\/p>\n

\u4f18\u5148\u7ea7<\/p>\n

\u4f18\u5148\u7ea7
\u6765\u6e90
\u8bbe\u7f6e\u65b9\u5f0f<\/p>\n

1
\u8bbf\u95ee\u4ee4\u724c
GOOGLE_WORKSPACE_CLI_TOKEN<\/p>\n

2
\u51ed\u636e\u6587\u4ef6
GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE<\/p>\n

3
\u52a0\u5bc6\u51ed\u636e
gws auth login<\/p>\n

4
\u660e\u6587\u51ed\u636e
~\/.config\/gws\/credentials.json<\/p>\n

\u73af\u5883\u53d8\u91cf\u4e5f\u53ef\u4ee5\u653e\u5728 .env \u6587\u4ef6\u4e2d\u3002<\/p>\n

AI \u4ee3\u7406\u6280\u80fd<\/p>\n

\u8be5\u4ed3\u5e93\u5305\u542b 100+ \u4e2a\u4ee3\u7406\u6280\u80fd\uff08 SKILL.md \u6587\u4ef6\uff09\u2014\u2014\u6bcf\u4e2a\u53d7\u652f\u6301\u7684 API \u5bf9\u5e94\u4e00\u4e2a\uff0c\u5916\u52a0\u9ad8\u7ea7\u5de5\u4f5c\u6d41\u5e2e\u52a9\u5668\u4ee5\u53ca 50 \u4e2a\u7cbe\u9009\u7684 Gmail\u3001Drive\u3001Docs\u3001Calendar \u548c Sheets \u914d\u65b9\u3002\u53c2\u89c1\u5b8c\u6574\u7684 \u6280\u80fd\u7d22\u5f15 \u3002<\/p>\n

\u4f60\u53ef\u4ee5\u4e00\u6b21\u6027\u5b89\u88c5\u6240\u6709\u6280\u80fd\uff0c\u6216\u53ea\u6311\u9009\u9700\u8981\u7684\u3002<\/p>\n

OpenClaw \u8bbe\u7f6e
\u53ef\u4ee5\u521b\u5efa\u7b26\u53f7\u94fe\u63a5\u6216\u590d\u5236\u7279\u5b9a\u6280\u80fd\u3002 gws-shared \u6280\u80fd\u5305\u542b\u4e00\u4e2a install \u5757\uff0c\u4f7f OpenClaw \u5728 gws \u4e0d\u5728 PATH \u4e2d\u65f6\u81ea\u52a8\u901a\u8fc7 npm \u5b89\u88c5 CLI\u3002<\/p>\n

Gemini CLI \u6269\u5c55<\/p>\n

\u5148\u8ba4\u8bc1 CLI\uff1a<\/p>\n

gws auth setup<\/p>\n

\u5c06\u6269\u5c55\u5b89\u88c5\u5230 Gemini CLI \u4e2d\u3002\u5b89\u88c5\u540e\uff0c\u4f60\u7684 Gemini CLI \u4ee3\u7406\u53ef\u4ee5\u76f4\u63a5\u8bbf\u95ee\u6240\u6709 gws \u547d\u4ee4\u548c Google Workspace \u4ee3\u7406\u6280\u80fd\u3002\u7531\u4e8e gws \u5b89\u5168\u5730\u5904\u7406\u81ea\u5df1\u7684\u8ba4\u8bc1\uff0c\u4f60\u53ea\u9700\u5728\u4f7f\u7528\u4ee3\u7406\u524d\u5728\u7ec8\u7aef\u4e2d\u5b8c\u6210\u4e00\u6b21\u8ba4\u8bc1\uff0c\u6269\u5c55\u4f1a\u81ea\u52a8\u7ee7\u627f\u4f60\u7684\u51ed\u636e\u3002<\/p>\n

\u9ad8\u7ea7\u7528\u6cd5<\/p>\n

\u591a\u90e8\u5206\u4e0a\u4f20<\/p>\n

gws drive files create –json '{"name": "report.pdf"}' –upload .\/report.pdf<\/p>\n

\u5206\u9875<\/p>\n

\u6807\u5fd7
\u63cf\u8ff0
\u9ed8\u8ba4\u503c<\/p>\n

–page-all
\u81ea\u52a8\u5206\u9875\uff0c\u6bcf\u9875\u8f93\u51fa\u4e00\u884c JSON\uff08NDJSON\uff09
\u5173\u95ed<\/p>\n

–page-limit <N>
\u6700\u5927\u83b7\u53d6\u9875\u6570
10<\/p>\n

–page-delay <MS>
\u9875\u95f4\u5ef6\u8fdf
100 \u6beb\u79d2<\/p>\n

Google Sheets \u2014\u2014 Shell \u8f6c\u4e49<\/p>\n

Sheets \u8303\u56f4\u4f7f\u7528 ! \uff0cbash \u4f1a\u5c06\u5176\u89e3\u91ca\u4e3a\u5386\u53f2\u6269\u5c55\u3002\u59cb\u7ec8\u4f7f\u7528 \u5355\u5f15\u53f7 \u5305\u88f9\u503c\uff1a<\/p>\n

# \u8bfb\u53d6 "Sheet1" \u4e2d\u7684 A1:C10 \u5355\u5143\u683c
gws sheets spreadsheets values get \\
–params '{"spreadsheetId": "SPREADSHEET_ID", "range": "Sheet1!A1:C10"}'<\/p>\n

# \u8ffd\u52a0\u884c
gws sheets spreadsheets values append \\
–params '{"spreadsheetId": "ID", "range": "Sheet1!A1", "valueInputOption": "USER_ENTERED"}' \\
–json '{"values": [["Name", "Score"], ["Alice", 95]]}'<\/p>\n

\u5e2e\u52a9\u5668\u547d\u4ee4<\/p>\n

\u90e8\u5206\u670d\u52a1\u5728\u81ea\u52a8\u751f\u6210\u7684 Discovery \u8868\u9762\u4e4b\u5916\u989d\u5916\u63d0\u4f9b\u4e86\u624b\u5199\u7684\u5e2e\u52a9\u5668\u547d\u4ee4\u3002\u5e2e\u52a9\u5668\u547d\u4ee4\u4ee5 + \u524d\u7f00\u6807\u8bb0\uff0c\u4ee5\u4fbf\u4e0e Discovery \u751f\u6210\u7684\u65b9\u6cd5\u540d\u533a\u5206\u4e14\u6c38\u4e0d\u51b2\u7a81\u3002<\/p>\n

\u65f6\u95f4\u611f\u77e5\u7684\u5e2e\u52a9\u5668\uff08 +agenda \u3001 +standup-report \u3001 +weekly-digest \u3001 +meeting-prep \uff09\u4f1a\u81ea\u52a8\u4f7f\u7528\u4f60\u7684 Google \u8d26\u53f7\u65f6\u533a \uff08\u4ece Calendar Settings API \u83b7\u53d6\u5e76\u7f13\u5b58 24 \u5c0f\u65f6\uff09\u3002\u53ef\u4ee5\u901a\u8fc7 +agenda \u7684 –timezone \/ –tz \u8986\u76d6\uff0c\u6216\u8bbe\u7f6e –timezone \u6807\u5fd7\u663e\u5f0f\u63a7\u5236\u3002<\/p>\n

\u8fd0\u884c gws <service> –help \u53ef\u540c\u65f6\u67e5\u770b Discovery \u65b9\u6cd5\u548c\u5e2e\u52a9\u5668\u547d\u4ee4\u3002<\/p>\n

gws gmail –help # \u663e\u793a +send, +reply, +reply-all, +forward, +triage, +watch \u2026
gws calendar –help # \u663e\u793a +insert, +agenda \u2026
gws drive –help # \u663e\u793a +upload \u2026<\/p>\n

\u5e2e\u52a9\u5668\u547d\u4ee4\u5b8c\u6574\u5217\u8868\uff1a<\/p>\n

\u670d\u52a1
\u547d\u4ee4
\u63cf\u8ff0<\/p>\n

gmail
+send
\u53d1\u9001\u90ae\u4ef6<\/p>\n

gmail
+reply
\u56de\u590d\u6d88\u606f\uff08\u81ea\u52a8\u5904\u7406\u7ebf\u7a0b\uff09<\/p>\n

gmail
+reply-all
\u56de\u590d\u5168\u90e8<\/p>\n

gmail
+forward
\u8f6c\u53d1\u6d88\u606f<\/p>\n

gmail
+triage
\u663e\u793a\u672a\u8bfb\u6536\u4ef6\u7bb1\u6458\u8981\uff08\u53d1\u4ef6\u4eba\u3001\u4e3b\u9898\u3001\u65e5\u671f\uff09<\/p>\n

gmail
+watch
\u76d1\u542c\u65b0\u90ae\u4ef6\u5e76\u4ee5 NDJSON \u6d41\u5f0f\u8f93\u51fa<\/p>\n

sheets
+append
\u5411\u7535\u5b50\u8868\u683c\u8ffd\u52a0\u884c<\/p>\n

sheets
+read
\u8bfb\u53d6\u7535\u5b50\u8868\u683c\u4e2d\u7684\u503c<\/p>\n

docs
+write
\u5411\u6587\u6863\u8ffd\u52a0\u6587\u672c<\/p>\n

chat
+send
\u5411\u7a7a\u95f4\u53d1\u9001\u6d88\u606f<\/p>\n

drive
+upload
\u4e0a\u4f20\u6587\u4ef6\uff08\u81ea\u52a8\u5143\u6570\u636e\uff09<\/p>\n

calendar
+insert
\u521b\u5efa\u65b0\u4e8b\u4ef6<\/p>\n

calendar
+agenda
\u663e\u793a\u5373\u5c06\u5230\u6765\u7684\u4e8b\u4ef6\uff08\u4f7f\u7528 Google \u8d26\u53f7\u65f6\u533a\uff1b\u53ef\u901a\u8fc7 –timezone \u8986\u76d6\uff09<\/p>\n

script
+push
\u7528\u672c\u5730\u6587\u4ef6\u66ff\u6362 Apps Script \u9879\u76ee\u4e2d\u7684\u6240\u6709\u6587\u4ef6<\/p>\n

workflow
+standup-report
\u4eca\u65e5\u4f1a\u8bae + \u5f85\u529e\u4e8b\u9879\uff0c\u4f5c\u4e3a\u7ad9\u7acb\u4f1a\u8bae\u6458\u8981<\/p>\n

workflow
+meeting-prep
\u4e3a\u4e0b\u4e00\u6b21\u4f1a\u8bae\u505a\u51c6\u5907\uff1a\u8bae\u7a0b\u3001\u53c2\u4e0e\u8005\u53ca\u5173\u8054\u6587\u6863<\/p>\n

workflow
+email-to-task
\u5c06 Gmail \u6d88\u606f\u8f6c\u6362\u4e3a Google Tasks \u6761\u76ee<\/p>\n

workflow
+weekly-digest
\u5468\u62a5\uff1a\u672c\u5468\u4f1a\u8bae + \u672a\u8bfb\u90ae\u4ef6\u6570\u91cf<\/p>\n

workflow
+file-announce
\u5728 Chat \u7a7a\u95f4\u4e2d\u5ba3\u5e03 Drive \u6587\u4ef6<\/p>\n

events
+subscribe
\u8ba2\u9605 Workspace \u4e8b\u4ef6\u5e76\u4ee5 NDJSON \u6d41\u5f0f\u8f93\u51fa<\/p>\n

events
+renew
\u7eed\u8ba2\/\u91cd\u65b0\u6fc0\u6d3b Workspace Events \u8ba2\u9605<\/p>\n

modelarmor
+sanitize-prompt
\u901a\u8fc7 Model Armor \u6a21\u677f\u51c0\u5316\u7528\u6237\u63d0\u793a<\/p>\n

modelarmor
+sanitize-response
\u901a\u8fc7 Model Armor \u6a21\u677f\u51c0\u5316\u6a21\u578b\u54cd\u5e94<\/p>\n

modelarmor
+create-template
\u521b\u5efa\u65b0\u7684 Model Armor \u6a21\u677f<\/p>\n

\u793a\u4f8b\uff1a<\/p>\n

# \u53d1\u9001\u90ae\u4ef6
gws gmail +send –to alice@example.com –subject "Hello" –body "Hi there"<\/p>\n

# \u56de\u590d\u6d88\u606f
gws gmail +reply –message-id MESSAGE_ID –body "Thanks!"<\/p>\n

# \u8ffd\u52a0\u884c\u5230\u7535\u5b50\u8868\u683c
gws sheets +append –spreadsheet SPREADSHEET_ID –values "Alice,95"<\/p>\n

# \u663e\u793a\u4eca\u65e5\u65e5\u5386\u8bae\u7a0b
gws calendar +agenda<\/p>\n

# \u4e0a\u4f20\u6587\u4ef6\u5230 Drive
gws drive +upload .\/report.pdf –name "Q1 Report"<\/p>\n

# \u65e9\u6668\u7ad9\u7acb\u4f1a\u8bae\u6458\u8981
gws workflow +standup-report<\/p>\n

# \u663e\u793a\u6307\u5b9a\u65f6\u533a\u7684\u4eca\u65e5\u8bae\u7a0b
gws calendar +agenda –today –timezone America\/New_York<\/p>\n

Model Armor\uff08\u54cd\u5e94\u51c0\u5316\uff09<\/p>\n

\u96c6\u6210 Google Cloud Model Armor \uff0c\u5728\u54cd\u5e94\u5230\u8fbe\u4ee3\u7406\u4e4b\u524d\u626b\u63cf API \u54cd\u5e94\u4e2d\u7684\u63d0\u793a\u6ce8\u5165\u3002<\/p>\n

gws gmail users messages get –params '…' \\
–sanitize "projects\/P\/locations\/L\/templates\/T"<\/p>\n

\u53d8\u91cf
\u63cf\u8ff0<\/p>\n

GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE
\u9ed8\u8ba4 Model Armor \u6a21\u677f<\/p>\n

GOOGLE_WORKSPACE_CLI_SANITIZE_MODE
warn \uff08\u9ed8\u8ba4\uff09\u6216 block<\/p>\n

\u73af\u5883\u53d8\u91cf<\/p>\n

\u6240\u6709\u53d8\u91cf\u5747\u4e3a\u53ef\u9009\u3002\u53c2\u89c1 .env.example \u83b7\u53d6\u53ef\u590d\u5236\u6a21\u677f\u3002<\/p>\n

\u53d8\u91cf
\u63cf\u8ff0<\/p>\n

GOOGLE_WORKSPACE_CLI_TOKEN
\u9884\u5148\u83b7\u53d6\u7684 OAuth2 \u8bbf\u95ee\u4ee4\u724c\uff08\u6700\u9ad8\u4f18\u5148\u7ea7\uff09<\/p>\n

GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE
OAuth \u51ed\u636e JSON \u7684\u8def\u5f84\uff08\u7528\u6237\u6216\u670d\u52a1\u8d26\u53f7\uff09<\/p>\n

GOOGLE_WORKSPACE_CLI_CLIENT_ID
OAuth \u5ba2\u6237\u7aef ID\uff08 client_secret.json \u7684\u66ff\u4ee3\uff09<\/p>\n

GOOGLE_WORKSPACE_CLI_CLIENT_SECRET
OAuth \u5ba2\u6237\u7aef\u5bc6\u94a5\uff08\u4e0e CLIENT_ID \u914d\u5bf9\uff09<\/p>\n

GOOGLE_WORKSPACE_CLI_CONFIG_DIR
\u8986\u76d6\u914d\u7f6e\u76ee\u5f55\uff08\u9ed8\u8ba4\uff1a ~\/.config\/gws \uff09<\/p>\n

GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE
\u9ed8\u8ba4 Model Armor \u6a21\u677f<\/p>\n

GOOGLE_WORKSPACE_CLI_SANITIZE_MODE
warn \uff08\u9ed8\u8ba4\uff09\u6216 block<\/p>\n

GOOGLE_WORKSPACE_CLI_LOG
stderr \u7684\u65e5\u5fd7\u7ea7\u522b\uff08\u4f8b\u5982 gws=debug \uff09\u3002\u9ed8\u8ba4\u5173\u95ed\u3002<\/p>\n

GOOGLE_WORKSPACE_CLI_LOG_FILE
JSON \u65e5\u5fd7\u6587\u4ef6\u7684\u76ee\u5f55\uff0c\u6bcf\u65e5\u8f6e\u8f6c\u3002\u9ed8\u8ba4\u5173\u95ed\u3002<\/p>\n

GOOGLE_WORKSPACE_PROJECT_ID
\u7528\u4e8e\u914d\u989d\/\u8ba1\u8d39\u7684 GCP \u9879\u76ee ID \u8986\u76d6\uff0c\u4ee5\u53ca\u5e2e\u52a9\u5668\u547d\u4ee4\u7684\u56de\u9000\u3002<\/p>\n

\u73af\u5883\u53d8\u91cf\u4e5f\u53ef\u4ee5\u8bbe\u7f6e\u5728 .env \u6587\u4ef6\u4e2d\uff08\u901a\u8fc7 dotenvy \u52a0\u8f7d\uff09\u3002<\/p>\n

\u9000\u51fa\u4ee3\u7801<\/p>\n

gws \u4f7f\u7528\u7ed3\u6784\u5316\u9000\u51fa\u4ee3\u7801\uff0c\u811a\u672c\u53ef\u4ee5\u6839\u636e\u5931\u8d25\u7c7b\u578b\u5206\u652f\uff0c\u65e0\u9700\u89e3\u6790\u9519\u8bef\u8f93\u51fa\u3002<\/p>\n

\u4ee3\u7801
\u542b\u4e49
\u793a\u4f8b\u539f\u56e0<\/p>\n

0
\u6210\u529f
\u547d\u4ee4\u6b63\u5e38\u5b8c\u6210<\/p>\n

1
API \u9519\u8bef
Google \u8fd4\u56de 4xx\/5xx \u54cd\u5e94<\/p>\n

2
\u8ba4\u8bc1\u9519\u8bef
\u51ed\u636e\u7f3a\u5931\u3001\u8fc7\u671f\u6216\u65e0\u6548<\/p>\n

3
\u9a8c\u8bc1\u9519\u8bef
\u53c2\u6570\u9519\u8bef\u3001\u672a\u77e5\u670d\u52a1\u3001\u65e0\u6548\u6807\u5fd7<\/p>\n

4
Discovery \u9519\u8bef
\u65e0\u6cd5\u83b7\u53d6 API \u6a21\u5f0f\u6587\u6863<\/p>\n

5
\u5185\u90e8\u9519\u8bef
\u610f\u5916\u5931\u8d25<\/p>\n

gws drive files list –params '{"fileId": "bad"}'
echo $? # 1 \u2014\u2014 API \u9519\u8bef<\/p>\n

gws unknown-service files list
echo $? # 3 \u2014\u2014 \u9a8c\u8bc1\u9519\u8bef\uff08\u672a\u77e5\u670d\u52a1\uff09<\/p>\n

\u67b6\u6784<\/p>\n

gws \u91c7\u7528 \u4e24\u9636\u6bb5\u89e3\u6790 \u7b56\u7565\uff1a<\/p>\n

\u8bfb\u53d6 argv[1] \u8bc6\u522b\u670d\u52a1\uff08\u4f8b\u5982 drive \uff09<\/p>\n

\u83b7\u53d6\u670d\u52a1\u7684 Discovery \u6587\u6863\uff08\u7f13\u5b58 24 \u5c0f\u65f6\uff09<\/p>\n

\u6839\u636e\u6587\u6863\u4e2d\u7684\u8d44\u6e90\u548c\u65b9\u6cd5\u6784\u5efa clap::Command \u6811<\/p>\n

\u91cd\u65b0\u89e3\u6790\u5269\u4f59\u53c2\u6570<\/p>\n

\u8ba4\u8bc1\u3001\u6784\u5efa HTTP \u8bf7\u6c42\u3001\u6267\u884c<\/p>\n

\u6240\u6709\u8f93\u51fa\u2014\u2014\u6210\u529f\u3001\u9519\u8bef\u3001\u4e0b\u8f7d\u5143\u6570\u636e\u2014\u2014\u90fd\u662f\u7ed3\u6784\u5316 JSON\u3002<\/p>\n

\u6545\u969c\u6392\u9664<\/p>\n

\u201c\u8bbf\u95ee\u88ab\u5c4f\u853d\u201d\u6216\u767b\u5f55\u65f6 403 \u9519\u8bef<\/p>\n

\u4f60\u7684 OAuth \u5e94\u7528\u5904\u4e8e \u6d4b\u8bd5\u6a21\u5f0f \uff0c\u4e14\u4f60\u7684\u8d26\u53f7\u672a\u88ab\u5217\u4e3a\u6d4b\u8bd5\u7528\u6237\u3002<\/p>\n

\u89e3\u51b3\u65b9\u6cd5\uff1a \u6253\u5f00 GCP \u9879\u76ee\u4e2d\u7684 OAuth \u540c\u610f\u5c4f\u5e55 \u2192 \u6d4b\u8bd5\u7528\u6237 \u2192 \u6dfb\u52a0\u7528\u6237 \u2192 \u8f93\u5165\u4f60\u7684 Google \u8d26\u53f7\u90ae\u7bb1\u3002\u7136\u540e\u91cd\u8bd5 gws auth login \u3002<\/p>\n

\u201cGoogle \u5c1a\u672a\u9a8c\u8bc1\u6b64\u5e94\u7528\u201d<\/p>\n

\u5f53\u4f60\u7684\u5e94\u7528\u5904\u4e8e\u6d4b\u8bd5\u6a21\u5f0f\u65f6\uff0c\u8fd9\u662f\u9884\u671f\u884c\u4e3a\u3002\u70b9\u51fb \u9ad8\u7ea7 \u2192 \u524d\u5f80 <\u5e94\u7528\u540d>\uff08\u4e0d\u5b89\u5168\uff09 \u7ee7\u7eed\u3002\u4e2a\u4eba\u4f7f\u7528\u662f\u5b89\u5168\u7684\uff1b\u53ea\u6709\u5728\u5411\u5176\u4ed6\u7528\u6237\u53d1\u5e03\u5e94\u7528\u65f6\u624d\u9700\u8981\u9a8c\u8bc1\u3002<\/p>\n

\u4f5c\u7528\u57df\u8fc7\u591a \/ \u540c\u610f\u5c4f\u5e55\u9519\u8bef<\/p>\n

\u672a\u9a8c\u8bc1\uff08\u6d4b\u8bd5\u6a21\u5f0f\uff09\u5e94\u7528\u4ec5\u652f\u6301\u7ea6 25 \u4e2a OAuth \u4f5c\u7528\u57df\u3002 recommended \u4f5c\u7528\u57df\u9884\u8bbe\u5305\u542b\u5927\u91cf\u4f5c\u7528\u57df\uff0c\u4f1a\u8d85\u51fa\u6b64\u9650\u5236\u3002<\/p>\n

\u89e3\u51b3\u65b9\u6cd5\uff1a \u53ea\u9009\u62e9\u4f60\u9700\u8981\u7684\u4f5c\u7528\u57df\uff1a<\/p>\n

gws auth login –scopes drive,gmail,calendar<\/p>\n

gcloud CLI \u672a\u627e\u5230<\/p>\n

gws auth setup \u9700\u8981 gcloud CLI \u6765\u81ea\u52a8\u521b\u5efa\u9879\u76ee\u3002\u4f60\u6709\u4e09\u4e2a\u9009\u9879\uff1a<\/p>\n

\u5b89\u88c5 gcloud \u5e76\u76f4\u63a5\u4f7f\u7528 gcloud \u3002<\/p>\n

\u91cd\u65b0\u8fd0\u884c gws auth setup \uff0c\u5b83\u4f1a\u5c01\u88c5 gcloud \u8c03\u7528\u3002<\/p>\n

\u5b8c\u5168\u8df3\u8fc7 gcloud \u2014\u2014\u5728 Cloud Console \u4e2d\u624b\u52a8\u8bbe\u7f6e OAuth \u51ed\u636e\u3002<\/p>\n

redirect_uri_mismatch<\/p>\n

OAuth \u5ba2\u6237\u7aef\u672a\u521b\u5efa\u4e3a \u684c\u9762\u5e94\u7528 \u7c7b\u578b\u3002\u5728 \u51ed\u636e \u9875\u9762\u4e2d\uff0c\u5220\u9664\u73b0\u6709\u5ba2\u6237\u7aef\uff0c\u521b\u5efa\u4e00\u4e2a\u7c7b\u578b\u4e3a \u684c\u9762\u5e94\u7528 \u7684\u65b0\u5ba2\u6237\u7aef\uff0c\u5e76\u4e0b\u8f7d\u65b0\u7684 JSON\u3002<\/p>\n

API \u672a\u542f\u7528 \u2014\u2014 accessNotConfigured<\/p>\n

\u5982\u679c\u6240\u9700\u7684 Google API \u672a\u5728\u4f60\u7684 GCP \u9879\u76ee\u4e2d\u542f\u7528\uff0c\u4f60\u4f1a\u770b\u5230 403 \u9519\u8bef\uff0c\u539f\u56e0\u4e3a accessNotConfigured \uff1a<\/p>\n

{
"error": {
"code": 403,
"message": "Gmail API has not been used in project 549352339482 …",
"reason": "accessNotConfigured",
"enable_url": "https:\/\/console.developers.google.com\/apis\/api\/gmail.googleapis.com\/overview?project=549352339482"
}
}<\/p>\n

gws \u8fd8\u4f1a\u5728 stderr \u4e2d\u6253\u5370\u4e00\u6761\u53ef\u64cd\u4f5c\u7684\u63d0\u793a\uff1a<\/p>\n

\ud83d\udca1 \u4f60\u7684 GCP \u9879\u76ee\u672a\u542f\u7528\u8be5 API\u3002
\u542f\u7528\u5730\u5740\uff1ahttps:\/\/console.developers.google.com\/apis\/api\/gmail.googleapis.com\/overview?project=549352339482
\u542f\u7528\u540e\uff0c\u7b49\u5f85\u51e0\u79d2\u949f\uff0c\u7136\u540e\u91cd\u8bd5\u4f60\u7684\u547d\u4ee4\u3002<\/p>\n

\u4fee\u590d\u6b65\u9aa4\uff1a<\/p>\n

\u70b9\u51fb enable_url \u94fe\u63a5\uff08\u6216\u4ece JSON \u7684 enable_url \u5b57\u6bb5\u590d\u5236\uff09\u3002<\/p>\n

\u5728 GCP Console \u4e2d\uff0c\u70b9\u51fb \u542f\u7528 \u3002<\/p>\n

\u7b49\u5f85\u7ea6 10 \u79d2\uff0c\u7136\u540e\u91cd\u8bd5\u4f60\u7684 gws \u547d\u4ee4\u3002<\/p>\n

\u4f60\u4e5f\u53ef\u4ee5\u8fd0\u884c gws auth setup \uff0c\u5b83\u4f1a\u81ea\u52a8\u5f15\u5bfc\u4f60\u4e3a\u9879\u76ee\u542f\u7528\u6240\u6709\u5fc5\u9700\u7684 API\u3002<\/p>\n

\u8bb8\u53ef<\/p>\n

Apache-2.0<\/p>\n

\u514d\u8d23\u58f0\u660e<\/p>\n

\u26a0\ufe0f \u8fd9\u4e0d\u662f Google \u5b98\u65b9\u652f\u6301\u7684\u6b63\u5f0f\u4ea7\u54c1\u3002<\/p>\n

\u8bd5\u8bd5\u8fd9\u6837\u505a<\/h2>\n