المهارات gws-shared
📦

gws-shared

آمن

掌握 Google Workspace CLI 指令

此技能提供 gws CLI 工具的完整參考文件。它幫助您進行身份驗證、使用全域旗標,並遵循 Google Workspace 操作的正確 CLI 語法。

يدعم: Claude Codex Code(CC)
🥉 74 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "gws-shared". How do I authenticate with gws?

النتيجة المتوقعة:

You can authenticate with gws using two methods: 1) Browser-based OAuth with 'gws auth login' for interactive sessions, or 2) Service account by setting the GOOGLE_APPLICATION_CREDENTIALS environment variable to point to your key.json file.

استخدام "gws-shared". Show me the global flags available in gws

النتيجة المتوقعة:

gws supports these global flags: --format (output as json/table/yaml/csv), --dry-run (validate without API calls), and --sanitize (screen responses through Model Armor for content safety).

استخدام "gws-shared". How do I handle shell special characters in gws commands?

النتيجة المتوقعة:

For zsh, use double quotes when ranges contain '!' (e.g., --range "Sheet1!A1:D10"). For JSON parameters, wrap in single quotes to preserve inner double quotes (e.g., --params '{"pageSize": 5}').

التدقيق الأمني

آمن
v1 • 4/20/2026

All static analysis findings are false positives from markdown documentation code blocks. The skill contains only reference documentation for the gws CLI tool with no executable code or actual security risks.

1
الملفات التي تم فحصها
83
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

CLI 快速參考

在使用命令列處理 Google Workspace API 時,查閱 gws CLI 語法、旗標和身份驗證方法。

身份驗證設定指南

了解如何使用瀏覽器型 OAuth 或服務帳戶憑證向 gws 進行身份驗證,以實現自動化工作流程。

最佳實踐參考

存取安全規則和 shell 技巧,確保在生產環境中安全且正確地使用 gws CLI 工具。

جرّب هذه الموجهات

基本身份驗證說明
How do I authenticate with the gws CLI using a service account?
指令語法查詢
Show me the gws CLI syntax for listing Google Drive files with JSON output format
分頁和輸出
How do I use gws to fetch all Gmail messages with automatic pagination and save as CSV?
使用模擬執行安全操作
What is the recommended way to test a destructive gws command before executing it?

أفضل الممارسات

  • 在執行破壞性操作前,務必先使用 --dry-run 旗標驗證
  • 對於程式化處理偏好使用 --format json,對於人類可讀的輸出則使用 --format table
  • 在處理個人識別資訊或需要安全審查的內容時使用 --sanitize 旗標

تجنب

  • 不要在命令輸出中直接顯示密碼或 API 金鑰,請使用安全的憑證管理
  • 避免在 zsh 中對工作表範圍使用單引號,因為 '!' 字元會觸發歷史擴展
  • 除非在有適當安全措施的自動化腳本中,否則不要在未確認的情況下執行寫入或刪除命令

الأسئلة المتكررة

我需要單獨安裝 gws 二進位檔案嗎?
是的,此技能需要您的系統上已安裝 gws 二進位檔案並在 PATH 中可用。有關安裝選項,請參閱專案 README。
--params 和 --json 旗標有什麼區別?
使用 --params 處理 URL/查詢參數,使用 --json 處理請求主體資料。兩者都接受以單引號包圍的 JSON 格式字串,以保留內部的雙引號。
如何使用 gws 處理大型結果集?
使用 --page-all 旗標進行自動分頁並輸出 NDJSON。使用 --page-limit 控制分頁以設定最大頁數,使用 --page-delay 在請求之間新增延遲。
我可以不進行 API 呼叫就測試命令嗎?
是的,使用 --dry-run 旗標可以在本機驗證命令結構和參數,而不需執行實際的 API 呼叫。這對於測試破壞性操作至關重要。
為什麼我的工作表範圍命令在 zsh 中會失敗?
Zsh 會將 '!' 字元(如 'Sheet1!A1' 範圍中的)解釋為歷史擴展。請改用雙引號而非單引號:--range "Sheet1!A1:D10"。
如何回報錯誤或請求功能?
請先在 github.com/googleworkspace/cli/issues 搜尋現有問題。如果沒有找到相符的內容,請開啟新問題並提供詳細資訊,而非建立重複的項目。

تفاصيل المطور

المؤلف

googleworkspace

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md