تُعد أداة سطر الأوامر (CLI) الخاصة بـ Google Workspace (التي تُستدعى باسم gws) أداة ديناميكية ومفتوحة المصدر لسطر الأوامر تمنح البشر وعملاء الذكاء الاصطناعي وصولاً موحدًا إلى Drive وGmail وCalendar وSheets وDocs وChat وAdmin وكل واجهة برمجة تطبيقات (API) لـ Google Workspace - وهي مبنية مباشرةً من خدمة Discovery Service الحية من Google، بحيث تظل الأوامر محدثة دون الحاجة لتحديثات. قم بتثبيت Google Workspace CLI عالميًا عبر npm، وقم بالمصادقة مرة واحدة باستخدام OAuth، واتصل بعملاء مثل Claude Code أو Cursor بالمهارات المضمنة. لا حاجة إلى تدفقات OAuth المكررة أو حزم SDK منفصلة.
ما هو Google Workspace CLI ولماذا هو مهم؟إليك مشكلة يواجهها كل مطور ومسؤول ومستخدم لعملاء الذكاء الاصطناعي: ترغب في أتمتة خدمات Google Workspace أو الاستعلام عنها (ملفات Drive، إرسال Gmail، إنشاء أحداث التقويم، إضافة إلى Sheets، تحرير Docs، النشر في Chat)، ولكن ينتهي بك الأمر بكتابة نصوص برمجية مخصصة لـ curl، ومكافحة نطاقات OAuth، والتعامل مع ترقيم الصفحات يدويًا، أو تجميع عدة حزم SDK التي تصبح قديمة.
يحدث هذا لأن واجهات برمجة تطبيقات Google Workspace قوية ولكنها مجزأة؛ فكل خدمة لها نقاط نهاية خاصة بها، وتدفقات مصادقة، وميزات غريبة. تجبرك الأدوات التقليدية على الاحتفاظ بكود مكرر يتعطل عند تغيير واجهة برمجة التطبيقات.
Google Workspace CLI يحل هذه المشكلة. تم إصداره في أوائل عام 2026 بواسطة فريق Google (أعلنه Addy Osmani)، وهو أداة سطر أوامر واحدة مدعومة بلغة Rust تكتشف ديناميكيًا كل طريقة لواجهة برمجة تطبيقات Workspace في وقت التشغيل باستخدام خدمة Discovery Service من Google. تحصل على وصول فوري إلى نقاط النهاية الجديدة دون انتظار تحديثات الأداة.
النتيجة: تظل نصوصك البرمجية وعملائك وعملك اليومي في الطرفية دقيقة ومحدثة. يقوم Google Workspace CLI بإخراج JSON نظيف، ويدعم عمليات التشغيل التجريبية (dry-runs)، ومساعدات ترقيم الصفحات، ويتضمن أكثر من 40 اختصارًا سهل الاستخدام (مسبوقة بعلامة +) مثل `gws gmail +send` أو `gws calendar +agenda`.
يأتي Google Workspace CLI أيضًا مزودًا بمهارات عميل جاهزة للتثبيت، بحيث يمكن لأدوات مثل Claude Code أو Cursor أو OpenClaw أو Gemini CLI إدارة مساحة عملك بشكل مستقل — لا توجد تعريفات أدوات مخصصة مطلوبة.
إذا كنت تقوم ببناء أو اختبار تكاملات واجهة برمجة التطبيقات جنبًا إلى جنب مع أتمتة Workspace، فإن Apidog يتعامل مع جانب التحقق. إنه عميل API مجاني لإرسال الطلبات، وفحص الاستجابات، وإدارة البيئات، وتشغيل مجموعات الاختبار. معًا، يمنحك Google Workspace CLI وصولاً مباشرًا إلى بياناتك، ويؤكد Apidog أن كل استدعاء يعمل كما هو متوقع.
تثبيت Google Workspace CLIالمتطلب الوحيد هو Node.js 18 أو أحدث. تحقق من إصدارك باستخدام:
node --versionالتشغيل بدون تثبيتأسرع طريقة لتجربة Google Workspace CLI هي باستخدام npx (يسحب الأحدث في كل مرة):
npx @googleworkspace/cli --help
npx @googleworkspace/cli drive files list --params '{"pageSize":1}'جيد للاختبارات السريعة أو النصوص البرمجية لمرة واحدة.
التثبيت عالميًاللاستخدام المنتظم، قم بالتثبيت عالميًا بحيث يكون الأمر gws متاحًا دائمًا:
npm install -g @googleworkspace/cli
gws --versionيقوم Google Workspace CLI بتجميع ثنائيات مسبقة الإنشاء، لذا يكون بدء التشغيل سريعًا ولا داعي لتجميع Rust محليًا. يمكنك أيضًا الحصول على الثنائيات من GitHub Releases، أو استخدام Homebrew (`brew install googleworkspace/cli`)، أو التشغيل عبر Nix إذا كنت تفضل ذلك.
إعداد Google Workspace CLI لعميل الذكاء الاصطناعي الخاص بك لبرمجة الأكواديتعامل الأمر `gws auth setup` مع إنشاء المشروع، وتمكين واجهة برمجة التطبيقات (API)، والمصادقة الأولية (OAuth) في تدفق موجه واحد. قم بالتشغيل:
gws auth setupيفتح متصفحك، وينشئ مشروع Google Cloud إذا لزم الأمر، ويمكّن واجهات برمجة التطبيقات المطلوبة، ويحفظ بيانات الاعتماد بأمان في سلسلة مفاتيح نظام التشغيل الخاص بك (مشفرة بمعيار AES-256-GCM).
استهداف عميل معين أو تثبيت المهاراتبعد الإعداد، قم بتثبيت مهارات العميل المرفقة:
npx skills add https://github.com/googleworkspace/cliأو قم بتشغيل أدوات التثبيت الخاصة بالعميل (على سبيل المثال، لـ Claude Code أو Cursor). أعد تشغيل العميل الخاص بك حتى يكتشف أوامر Google Workspace CLI تلقائيًا.
إعداد على مستوى المشروع مقابل الإعداد العالميبشكل افتراضي، ينطبق الإعداد عالميًا. للتكوين على مستوى المشروع فقط:
gws auth setup --projectالمصادقةأعد المصادقة أو قم بتبديل الحسابات في أي وقت:
gws auth loginتحقق من المستخدم الحالي والنطاقات:
gws auth whoamiتسجيل الخروج عند الحاجة:
gws auth logoutللاستخدام بدون واجهة رسومية/CI، قم بتصدير بيانات الاعتماد:
gws auth export --unmasked > creds.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.jsonأو أعد استخدام رموز gcloud المميزة: `export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)`.
القياس عن بعد (Telemetry)تعطيل جمع الاستخدام المجهول:
export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1استخدام الأوامر الأساسية في Google Workspace CLI (Drive، Gmail، Calendar، Sheets، Docs، Chat)يكتشف Google Workspace CLI الأوامر ديناميكيًا - لا توجد قائمة ثابتة. قم بتشغيل `gws --help` لرؤية الخدمات المتاحة.
ملفات ومجلدات Driveقائمة الملفات الحديثة:
gws drive files list --params '{"pageSize":10, "q":"name contains report"}'التحميل باستخدام المساعد:
gws drive +upload ./budget.xlsx --name "2026 Budget"Gmailإرسال بريد إلكتروني:
gws gmail +send --to colleague@example.com --subject "Update" --body "See attached." --attach ./file.pdfالرد أو فرز البريد الوارد:
gws gmail +reply --message-id <ID> --body "Thanks!"
gws gmail +triageالتقويمإنشاء حدث:
gws calendar +insert --summary "Sprint Planning" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "team@example.com"عرض جدول اليوم:
gws calendar +agenda --todaySheetsإضافة صف:
gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Task X,Done,2026-03-16"Docsإدراج نص:
gws docs +write --documentId <ID> --text "New section added via Google Workspace CLI"Chatنشر رسالة:
gws chat +send --space <SPACE_ID> --text "Deployment complete 🚀"استخدم `--dry-run` على أي أمر لمعاينة استدعاء API بالضبط دون تنفيذه. أضف `--page-all` للترقيم الكامل للصفحات كـ NDJSON.
التكوين المتقدم والخيارات العامة في Google Workspace CLIحفظ الإعدادات باستخدام متغيرات البيئة أو ملف .env:
export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'ضبط المهلات، تنسيق الإخراج (`--json`, `--yaml`)، أو فرض سلسلة مفاتيح تستند إلى الملفات. عرض التكوين:
gws configدمج Google Workspace CLI مع عملاء الذكاء الاصطناعي والموجهاتبمجرد تثبيت المهارات، يستدعي العملاء Google Workspace CLI بشكل أصلي.
نمط "use gws"في الموجهات: "List my recent Drive files using Google Workspace CLI" (سرد ملفات Drive الأخيرة باستخدام Google Workspace CLI) أو "Send a follow-up email via Google Workspace CLI" (إرسال بريد إلكتروني للمتابعة عبر Google Workspace CLI).
قاعدة الاستدعاء التلقائيأضف إلى تعليمات وكيلك (على سبيل المثال، CLAUDE.md أو قواعد Cursor):
"كلما تضمنت المهمة Gmail أو Drive أو Calendar أو Sheets أو Docs أو Chat، استخدم أوامر Google Workspace CLI تلقائيًا قبل الرد. قم بحل الخدمة والطريقة أولاً."
تعيد الوكلاء مسارات الملفات أو نتائج JSON، مع الحفاظ على السياق بسيطًا.
قم بإقرانه مع Apidog للحصول على ثقة كاملة في واجهة برمجة التطبيقاتGoogle Workspace CLI يجعل واجهات برمجة تطبيقات Workspace قابلة للوصول فورًا، ولكن عند تصحيح الأخطاء في الحمولة، أو النطاقات، أو الاستجابات، تحتاج إلى رؤية واضحة.
Apidog هو عميل API مجاني يتيح لك إرسال الطلبات، وفحص الاستجابات الأولية، وإعداد البيئات باستخدام رموز OAuth المميزة، وأتمتة التأكيدات.
سير العمل الحقيقي:
- يقترح الوكيل إضافة إلى جدول بيانات → اختبر الحمولة الدقيقة لـ `Sheets.values.append` في Apidog أولاً.
- استكشاف أخطاء نطاقات إرسال Gmail وإصلاحها → قم ببناء وتشغيل الطلب بصريًا.
- تخزين مفاتيح حساب الخدمة أو رموز المستخدم المميزة كمتغيرات → قم بتبديل الحسابات والتحقق من السلوك.
يوفر Google Workspace CLI + Apidog وصولاً مباشرًا إلى البيانات بالإضافة إلى اختبار API موثوق ومتكرر.
الأسئلة الشائعةهل يرسل Google Workspace CLI بياناتي خارجيًا؟لا يتم إجراء أي مكالمات مباشرة إلى واجهات برمجة تطبيقات Google. لا يغادر المحتوى الخاص بك حسابك على Google أبدًا.
ما هي الخدمات التي يدعمها Google Workspace CLI؟كل واجهة برمجة تطبيقات لـ Workspace يتم اكتشافها ديناميكيًا: Drive وGmail وCalendar وSheets وDocs وChat وAdmin وScript والمزيد.
ما مدى حداثة الأوامر؟يستعلم Google Workspace CLI عن خدمة Discovery Service الحية - تظهر الطرق الجديدة تلقائيًا.
هل يتطلب مفتاح API؟يستخدم Google OAuth القياسي أو حسابات الخدمة - لا يوجد مفتاح منفصل بخلاف بيانات اعتماد المصادقة.
ما هي العملاء والمحررين الذين يدعمهم Google Workspace CLI؟Claude Code، Cursor، OpenClaw، Gemini CLI، إضافات VS Code - أي أداة متوافقة مع MCP أو Agent Skills.
ما الفرق بين الأوامر الخام والمساعدات ذات علامة +؟الخام = طرق Discovery الدقيقة (على سبيل المثال، `drive.files.list`). المساعدات ذات علامة + = اختصارات للمهام الشائعة (على سبيل المثال، `+upload`, `+send`).
هل يمكنني استخدام Google Workspace CLI بدون عميل ذكاء اصطناعي؟نعم، إنه مثالي للنصوص البرمجية والأتمتة أو الاستخدام اليومي للطرفية.
موارد إضافية
- مستودع Google Workspace CLI على GitHub ← https://github.com/googleworkspace/cli
- الملف التمهيدي (README) والوثائق الكاملة ← https://github.com/googleworkspace/cli/blob/main/README.md
- مجلد مهارات العميل ← https://github.com/googleworkspace/cli/tree/main/skills
- مرجع Google Workspace API ← https://developers.google.com/workspace
- لوحة تحكم الحصص ← https://console.cloud.google.com/apis/api
- عميل API المجاني Apidog ← https://apidog.com