يحتوي هذا المستند على معلومات حول المصادقة والتفويض الخاصة بواجهة برمجة التطبيقات Google Workspace Events API. قبل قراءة هذا المستند، احرص على قراءة معلومات المصادقة والتفويض العامة في Google Workspace على مزيد من المعلومات عن المصادقة والتفويض.
ضبط بروتوكول OAuth 2.0 للحصول على إذن
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختيار النطاقات لتحديد المعلومات التي يتم عرضها للمستخدمين ومراجعي التطبيقات، وتسجيل تطبيقك كي تتمكّن من نشره لاحقًا
نطاقات Google Workspace Events API
لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات الأذونات والإفصاح عنها. نطاق التفويض هو سلسلة URI لبروتوكول OAuth 2.0 تتضمّن اسم تطبيق Workspace في Google Workspace ونوع البيانات التي يمكنه الوصول إليها ومستوى الوصول. النطاقات هي طلبات تطبيقك للعمل مع بيانات Google Workspace، بما في ذلك البيانات في حساب Google للمستخدمين.
عند تثبيت تطبيقك، يُطلب من المستخدم التحقّق من صحة النطاقات المستخدَمة في التطبيق. وبشكل عام، عليك اختيار النطاق الأكثر تركيزًا وتجنُّب طلب نطاقات لا يحتاجها تطبيقك. يمنح المستخدمون إذن الوصول إلى النطاقات المحدودة والموضّحة بوضوح بشكل أسهل.
تستخدم Google Workspace Events API نطاقات من تطبيقات Google Workspace التي تتيح الاشتراكات. إذا كان تطبيقك يستخدم النطاقات المطلوبة للاشتراك، لن تحتاج إلى إضافة نطاقات لاستخدام Google Workspace Events API. إذا أضفت نطاقات، اختَر النطاق الأقل حساسية الذي يتيح لتطبيقك العمل. لمزيد من التفاصيل حول فئات النطاق، يُرجى الاطّلاع على فئات النطاق.
يسرد الجدول التالي النطاقات المتوافقة مع Google Workspace Events API:
| رمز النطاق | الوصف | الاستخدام | ||
|---|---|---|---|---|
| Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
تسمح تطبيقات Lets Chat بعرض المحادثات وإرسال الرسائل. يمنح هذا النطاق إذن الوصول إلى جميع الميزات المتاحة لتطبيقات Chat. | غير حساسة | ||
https://www.googleapis.com/auth/chat.memberships |
الاطّلاع على المشاركين في محادثات في Chat وإضافتهم وإزالتهم | حسّاسة |
||
https://www.googleapis.com/auth/chat.memberships.readonly |
الاطّلاع على المشاركين في محادثات Chat | حسّاسة |
||
https://www.googleapis.com/auth/chat.app.memberships |
الاطّلاع على الأعضاء وإضافتهم وإزالتهم وتعديل معلوماتهم في المحادثات والمساحات في Chat كتطبيق Chat يتطلّب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام تفويض على مستوى النطاق باستخدام هذا النطاق. |
حسّاسة |
||
https://www.googleapis.com/auth/chat.app.memberships.readonly |
الاطّلاع على المشاركين من المحادثات والمساحات في Google Chat كتطبيق Chat يتطلّب موافقة المشرف. يتيح هذا النطاق مصادقة التطبيق باستخدام حسابات الخدمة فقط. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام تفويض على مستوى النطاق باستخدام هذا النطاق. |
حسّاسة |
||
https://www.googleapis.com/auth/chat.spaces |
إنشاء محادثات ومساحات وعرض البيانات الوصفية أو تعديلها (بما في ذلك إعدادات السجلّ) في Chat | حسّاس | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
الاطّلاع على المحادثات والمساحات في Chat | حسّاسة |
||
https://www.googleapis.com/auth/chat.app.spaces |
إنشاء محادثات ومساحات وعرض البيانات الوصفية أو تعديلها (بما في ذلك إعدادات السجلّ) في Chat كتطبيق Chat يتطلّب موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام تفويض على مستوى النطاق باستخدام هذا النطاق. |
حسّاسة |
||
https://www.googleapis.com/auth/chat.app.spaces.readonly |
عرض البيانات الوصفية (بما في ذلك إعدادات السجلّ) في Google Chat كتطبيق Chat يتطلّب ذلك موافقة المشرف. يتيح هذا النطاق مصادقة التطبيق باستخدام حسابات الخدمة فقط. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام تفويض على مستوى النطاق باستخدام هذا النطاق. |
حسّاسة |
||
https://www.googleapis.com/auth/chat.messages.reactions |
عرض التفاعلات مع الرسائل في Chat وإضافتها وحذفها | حسّاسة |
||
https://www.googleapis.com/auth/chat.messages.reactions.readonly |
عرض التفاعلات مع رسالة في Chat | حسّاسة |
||
https://www.googleapis.com/auth/chat.messages |
عرض وإنشاء وإرسال وتعديل وحذف الرسائل، وإضافة وعرض وحذف التفاعلات مع الرسائل | محدود | ||
https://www.googleapis.com/auth/chat.messages.readonly |
عرض الرسائل والتفاعلات في Chat | مقيَّدة |
||
https://www.googleapis.com/auth/chat.app.messages.readonly |
عرض الرسائل والتفاعلات في Chat كتطبيق Chat يتطلّب ذلك موافقة المشرف. يتيح هذا النطاق مصادقة التطبيق باستخدام حسابات الخدمة فقط. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام تفويض على مستوى النطاق باستخدام هذا النطاق. |
مقيَّدة |
||
https://www.googleapis.com/auth/chat.users.readstate |
عرض حالة القراءة لدى المستخدم وتعديلها في Chat ( معاينة المطور) | حسّاسة |
||
https://www.googleapis.com/auth/chat.users.readstate.readonly |
عرض حالة القراءة لدى المستخدم في Chat ( معاينة المطور) | حسّاسة |
||
| Google Drive | ||||
https://www.googleapis.com/auth/drive.file |
إنشاء ملفات جديدة على Drive أو تعديل الملفات الحالية التي تفتحها باستخدام تطبيق أو التي يشاركها المستخدم مع تطبيق أثناء استخدام Google Picker API أو أداة اختيار الملفات في التطبيق | غير حساسة | ||
https://www.googleapis.com/auth/drive |
عرض جميع ملفاتك في Drive وإدارتها | محدود | ||
https://www.googleapis.com/auth/drive.readonly |
عرض جميع ملفات Drive وتنزيلها | محدود | ||
https://www.googleapis.com/auth/drive.metadata |
عرض البيانات الوصفية للملفات وإدارتها في Drive | محدود | ||
https://www.googleapis.com/auth/drive.metadata.readonly |
عرض البيانات الوصفية للملفات في Drive | محدود | ||
| Google Meet | ||||
https://www.googleapis.com/auth/meetings.space.created |
السماح للتطبيقات بإنشاء البيانات الوصفية وتعديلها وقراءتها حول مساحات الاجتماع التي أنشأها تطبيقك | حسّاسة |
||
https://www.googleapis.com/auth/meetings.space.readonly |
السماح للتطبيقات بقراءة البيانات الوصفية حول أي مساحة اجتماع يمكن للمستخدم الوصول إليها | حسّاسة |
||
يشير عمود "الاستخدام" في الجدول السابق إلى حساسية كل نطاق:
غير حسّاسة: توفّر هذه النطاقات أصغر نطاق من أذونات الوصول، ولا تتطلّب سوى التحقّق من التطبيقات الأساسي. للحصول على معلومات حول هذا الشرط، يُرجى الاطّلاع على متطلبات إثبات الأهلية.
حسّاسة: تتيح هذه النطاقات الوصول إلى بيانات مستخدمي Google المحدّدة التي يمنح المستخدم الإذن لتطبيقك بالوصول إليها، ويتطلّب ذلك إجراء عملية التحقق من التطبيقات الإضافية. للحصول على معلومات حول هذا الشرط، يُرجى الاطّلاع على متطلبات النطاق الحسّاس والمقيّد.
مقيّدة: توفّر هذه النطاقات إذن وصول واسعًا إلى بيانات المستخدم على Google، وتتطلّب منك إكمال عملية إثبات ملكية النطاق المقيّد. للحصول على معلومات حول هذا الشرط، يُرجى الاطّلاع على خدمات Google API: سياسة بيانات المستخدمين والمتطلبات الإضافية لنطاقات واجهات برمجة التطبيقات المحدّدة. إذا كنت تخزّن بيانات النطاق المحدود على خوادم (أو تنقلها)، عليك اجتياز تقييم أمان.
إذا كان تطبيقك يتطلّب الوصول إلى أي واجهات برمجة تطبيقات أخرى من Google، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات عن نطاقات Google API، يُرجى الاطّلاع على استخدام بروتوكول OAuth 2.0 للدخول إلى واجهات Google APIs.
لمزيد من المعلومات حول نطاقات OAuth 2.0 المحدّدة، يُرجى الاطّلاع على نطاقات OAuth 2.0 لـ Google APIs.
التحقّق من OAuth
قد يتطلّب استخدام نطاقات OAuth معيّنة أن يمر تطبيقك بعملية التحقّق الموضّحة في مركز مساعدة التحقّق من تطبيقات OAuth. اطّلِع على الأسئلة الشائعة حول تطبيقات OAuth لتحديد الحالات التي يجب فيها التحقّق من تطبيقك ونوع التحقّق المطلوب. يُرجى الاطّلاع أيضًا على بنود خدمة Drive.
أنواع المصادقة المطلوبة
يوضّح هذا القسم أنواع المصادقة المطلوبة أو المتاحة، ويقدّم النطاقات المتاحة لكل طريقة من طرق واجهة برمجة التطبيقات Google Workspace Events API.
بالنسبة إلى الاشتراكات في أحداث Chat، تتيح "واجهة برمجة تطبيقات أحداث Google Workspace" مصادقة المستخدم والتطبيق لاستدعاء بعض طرقها. إذا كانت إحدى طرق واجهة برمجة التطبيقات تتيح استخدام كلا نوعَي بيانات الاعتماد، سيؤثّر نوع بيانات الاعتماد المستخدَمة في الطلب في النتيجة التي يتم عرضها. على سبيل المثال، إذا طلبت بيانات من الطريقة subscriptions.list مع مصادقة المستخدم، ستعرض واجهة برمجة التطبيقات قائمة بالاشتراكات التي يمكن للمستخدم الذي تمّت المصادقة عليه الوصول إليها. في حال استخدام مصادقة التطبيق، تعرض واجهة برمجة التطبيقات قائمة بالاشتراكات التي يمكن للتطبيق الوصول إليها. لمزيد من المعلومات عن أنواع المصادقة في Chat، يُرجى الاطّلاع على مقالة مصادقة وتفويض التطبيقات في Chat وطلبات Chat API.
يعرض الجدول التالي النطاقات وأنواع المصادقة المطلوبة أو المتوافقة مع كل طريقة من طرق Google Workspace Events API:
| الطريقة | المصادقة مطلوبة أو متاحة | تتوفّر مصادقة التطبيقات (تطبيقات Chat فقط) | نطاقات الأذونات المتاحة | |
|---|---|---|---|---|
| إنشاء اشتراك | — |
عند مصادقة المستخدم، يجب توفُّر نطاق متوافق لكل نوع حدث:
إصدار تجريبي للمطوّرين: مع مصادقة التطبيق وموافقة المشرف (تطبيقات Google Chat فقط)، يتطلّب نطاقًا متوافقًا لكل نوع حدث:
|
||
| الحصول على اشتراك |
مع مصادقة المستخدم، تتطلّب هذه الطريقة نطاقًا يتيح نوع حدث واحدًا على الأقل للاشتراك.
باستخدام مصادقة التطبيق (تطبيقات Chat فقط):
|
|||
| الاشتراكات في القوائم |
مع مصادقة المستخدم، تتطلّب هذه الطريقة نطاقًا يتيح نوع حدث واحدًا على الأقل للاشتراك.
باستخدام مصادقة التطبيق (تطبيقات Chat فقط):
|
|||
| تعديل اشتراك | — |
عند مصادقة المستخدم، يجب توفُّر نطاق متوافق لكل نوع حدث:
إصدار تجريبي للمطوّرين: مع مصادقة التطبيق وموافقة المشرف (تطبيقات Google Chat فقط)، يتطلّب نطاقًا متوافقًا لكل نوع من الأحداث:
|
||
| إعادة تفعيل اشتراك | — |
عند مصادقة المستخدم، يجب توفُّر نطاق متوافق لكل نوع حدث:
مع مصادقة التطبيق وموافقة المشرف (تطبيقات Chat فقط)، يتطلّب ذلك نطاقًا متوافقًا لكل نوع حدث:
|
||
| حذف اشتراك |
مع مصادقة المستخدم، تتطلّب هذه الطريقة نطاقًا يتيح نوع حدث واحدًا على الأقل للاشتراك.
باستخدام مصادقة التطبيق (تطبيقات Chat فقط):
|
|||
نطاقات حسب نوع الحدث
عند استدعاء Google Workspace Events API باستخدام مصادقة المستخدم، يجب تحديد نطاق واحد أو أكثر يتوافق مع أنواع الأحداث الخاصة بالاشتراك.
يعرض الجدول التالي نطاقات التفويض المتاحة لكل نوع حدث:
| الأحداث | أنواع الأحداث | نطاقات الأذونات المتاحة | ||||||
|---|---|---|---|---|---|---|---|---|
| Chat | ||||||||
| يتم نشر رسالة أو تعديلها. |
|
باستخدام مصادقة المستخدم:
|
||||||
| تمت إضافة تفاعل أو حذفه، أو تم تغيير تفاعلات متعددة. |
|
|
||||||
| تم إنشاء عضوية أو تعديلها أو إزالتها، أو تم تغيير عضويات متعددة. |
|
باستخدام مصادقة المستخدم:
|
||||||
| تم تعديل مساحة أو حذفها. |
|
باستخدام مصادقة المستخدم:
|
||||||
| يتم تعديل حالة قراءة المساحة أو حالة قراءة سلسلة المحادثات الخاصة بالمستخدم. ( معاينة المطور) |
|
باستخدام مصادقة المستخدم:
|
||||||
| Drive | ||||||||
| تم إنشاء ملف أو تغييره أو نقله أو حذفه أو إعادة تسميته أو نقله إلى المهملات أو إزالته من المهملات. |
|
|
||||||
| تم إنشاء اقتراح وصول أو تمت الاستجابة إليه في ملف. |
|
|
||||||
| تم إلغاء موافقة أو إكمالها أو إنشاؤها أو إعادة ضبطها أو تغيير المراجعين أو ردّهم على ملف. |
|
|
||||||
| تم إنشاء تعليق أو حذفه أو تعديله أو إعادة فتحه أو حلّه في ملف. |
|
|
||||||
| يتم إنشاء رد أو حذفه أو تعديله في ملف. |
|
|
||||||
| يتم إنشاء إذن أو حذفه أو تعديله على ملف. |
|
|
||||||
| Meet | ||||||||
| يبدأ مؤتمر أو ينتهي. |
|
|
||||||
| ينضم مشارك إلى مؤتمر أو يغادره. |
|
|
||||||
| تم إنشاء تسجيل. |
|
|
||||||
| تم إنشاء نسخة نصية. |
|
|
||||||