نطاقات OAuth وأذونات خطوات مسار Workspace Studio

عند إنشاء مسارات مبرمَجة وتشغيلها في Google Workspace Studio، يتم تضمين ميزات الأمان وخصوصية البيانات تلقائيًا. يستخدم Workspace Studio نموذج هوية يمنح الحد الأدنى من الامتيازات، ما يعني أنّ المسارات الآلية تنفّذ المهام في الخلفية باستخدام الحد الأدنى من الأذونات المطلوبة لتنفيذ كل إجراء فردي، بدلاً من الحصول على إذن وصول واسع وغير مقيّد إلى حساب المستخدم بالكامل على Google.

لضبط عملية التشغيل الآلي بأمان والاطّلاع على كيفية الوصول إلى بيانات مؤسستك، استخدِم هذا الدليل لتحديد الأذونات المطلوبة لكل خطوة في المسار. توفّر هذه الصفحة ربطًا لكل نوع من خطوات المسار ونطاقات التفويض المفتوح (OAuth) المطلوبة.

تأثير نطاقات OAuth في استخدامك لـ Studio

عند استخدام Workspace Studio، تؤثر نطاقات OAuth في كيفية إنشاء مسارات العمل وتنفيذها وإدارتها بالطرق التالية:

  • التفويض لمرة واحدة: في المرة الأولى التي تضيف فيها خطوة تتفاعل مع إحدى خدمات Google (مثل Gmail أو Google Drive)، سيظهر لك طلب من Google لتأكيد تسجيل الدخول. يؤدي ذلك إلى منح الإذن للنطاق المحدّد لتلك الخطوة حتى يتمكّن المسار من العمل بشكل مستقل في الخلفية.
  • التنفيذ غير المتزامن في الخلفية: بعد تفعيل سير العمل، يتم تنفيذه بشكل غير متزامن على بنية Google الأساسية. ينفّذ المسار المهام (مثل جدولة حدث في "تقويم Google" أو كتابة مسودة) باستخدام النطاقات المحدّدة التي وافقت عليها فقط، حتى عندما لا تكون مسجّلاً الدخول بشكل نشط.
  • إشراف مركزي للمشرفين: بصفتك مشرفًا، يمكنك الاطّلاع على جميع عمليات سير العمل النشطة في مؤسستك باستخدام إعدادات إدارة إمكانية وصول الوكلاء في "وحدة تحكّم المشرف". يمكنك إيقاف مسارات محدّدة مؤقتًا أو استهداف نطاقات OAuth فردية وحظرها (مثل إزالة إذن الوصول إلى Drive مع إبقاء Gmail نشطًا) للحفاظ على أمان بيانات مؤسستك. مزيد من المعلومات

تحديد المشاكل في الأذونات غير الكافية وحلّها

إذا لم يتم تشغيل سير عمل وظهرت رسالة الخطأ "أذونات غير كافية" أو "حدث خطأ" في "سجلّ الأنشطة"، يُرجى التحقّق مما يلي:

  • إعادة تفويض سير العمل: افتح سير العمل في "أداة الإنشاء"، وانقر على حفظ التغييرات، واتّبِع أي طلبات في مربّع التفويض لإعادة تحميل رموز OAuth المميزة منتهية الصلاحية أو المفقودة.
  • عمليات حظر "الوصول الواعي بالسياق" (CAA): إذا كانت مؤسستك تفرض سياسات صارمة على الأجهزة أو عناوين IP، قد يتم أحيانًا حظر عمليات تنفيذ التدفقات في الخلفية. تأكَّد من إعفاء معرّف عميل Workspace Studio الأساسي من قيود "الوصول الواعي بالسياق".

خطوات المسار ونطاقات OAuth المطلوبة

يوضّح هذا الجدول الخطوات العادية في Workspace Studio ونطاقات OAuth التي تتطلّبها كل خطوة لتنفيذها وراء الكواليس.

اسم الخطوة الإعدادات والنطاق
خطوات الذكاء الاصطناعي في Studio
أساسيات AIP (اسأل Gemini، اسأل Gem، أنشئ مع Gemini، Deep Research، تلخيص الرسائل الإلكترونية غير المقروءة، استخراج، اتخاذ قرار، تلخيص) https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/cloud_search.query
عامة وأدوات مساعدة
وفقًا لجدول زمني غير متاحة
إرسال الويب هوك N/A - External 3P
التحقّق مما إذا لا ينطبق - منطق داخلي
فلترة قائمة لا ينطبق - منطق داخلي
Gmail
عند استلام رسالة إلكترونية https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger 
إرسال إشعار إلى بريدي الإلكتروني https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
إرسال رسالة إلكترونية https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
كتابة مسودة رسالة إلكترونية https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
إعادة توجيه رسالة إلكترونية https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
صياغة ردّ https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
الردّ على رسالة إلكترونية https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
إضافة تصنيفات أو إزالتها https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
وضع علامة "مقروءة" أو "غير مقروءة" https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
تمييز بنجمة أو إلغاء التمييز بنجمة https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
الأرشفة (أو الحذف) https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Google Chat
عند انضمام مستخدم إلى مساحة https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
عند تلقّي رسالة محادثة https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
عند الإشارة إليّ https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
عند إضافة تفاعل باستخدام إيموجي https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
إعلامي في Chat https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
إرسال مساحة Chat https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
الإرسال إلى مستخدمين آخرين https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
الردّ على رسالة https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
جداول بيانات Google
عند تغيير ورقة البيانات https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly
إضافة صف https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
تعديل الصفوف https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
محو الصفوف https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
الحصول على محتوى ورقة البيانات https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
مستندات Google
إنشاء مستند Google https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
الإضافة إلى مستند https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
"تقويم Google" و"مهام Google"
استنادًا إلى اجتماع https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly 
إنشاء مهمة https://www.googleapis.com/auth/tasks
إنشاء حدث https://www.googleapis.com/auth/calendar.events
إضافة مدعوين https://www.googleapis.com/auth/calendar.events
Google Drive
عند إضافة عنصر إلى مجلد https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly
عند تعديل ملف https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
عند تعديل ملف في مجلد https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly
نقل الملف https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
نسخ الملف https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
حفظ المرفقات https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
إنشاء مجلد https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Google Meet
عندما تكون ملاحظات الاجتماع https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/meetings.space.readonly
نماذج Google
عند تلقّي ردّ على نموذج ‫https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/drive.readonly (فقط لملفات "منع فقدان البيانات" المتوافقة مع "نماذج Google")
NotebookLM
إضافة مصدر إلى NotebookLM https://www.googleapis.com/auth/drive.readonly
طرح سؤال على NotebookLM https://www.googleapis.com/auth/drive.readonly