يحتوي هذا المستند على معلومات المصادقة والتفويض الخاصة بـ Google Workspace Events API. قبل قراءة هذا المستند، احرص على قراءة معلومات المصادقة والتفويض العامة في Google Workspace على الرابط التعرّف على المصادقة والتفويض.
ضبط OAuth 2.0 للتفويض
اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختَر النطاقات لتحديد المعلومات التي يتم عرضها للمستخدمين ومراجعي التطبيقات، وسجِّل تطبيقك لتتمكّن من نشره لاحقًا.
نطاقات Google Workspace Events API
لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات التفويض والإفصاح عنها. نطاق التفويض هو سلسلة معرّف موارد منتظم (URI) لبروتوكول OAuth 2.0 يحتوي على اسم تطبيق 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 |
يتيح هذا الإذن لتطبيقات 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 | حسّاسة |
||
https://www.googleapis.com/auth/chat.users.availability |
الاطّلاع على حالة التوفّر في Chat وتغييرها | حسّاسة |
||
https://www.googleapis.com/auth/chat.users.availability.readonly |
الاطّلاع على حالة التوفّر في Chat | حسّاسة |
||
https://www.googleapis.com/auth/chat.app.all.spaces.readonly |
الاطّلاع على البيانات الوصفية لجميع المساحات والمحادثات في Google Chat ضمن مؤسستك على Google Workspace، حتى إذا لم يكن تطبيق Chat عضوًا. لا يتوافق هذا النطاق إلا مع اشتراكات العملاء. يتطلّب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق باستخدام هذا النطاق. |
محدود | ||
https://www.googleapis.com/auth/chat.app.all.memberships.readonly |
الاطّلاع على جميع المشاركين في مساحات Google Chat والمحادثات ضمن مؤسستك على Google Workspace، حتى إذا لم يكن تطبيق Chat مشاركًا في المساحة أو المحادثة لا يتوافق هذا النطاق إلا مع اشتراكات العملاء. يتطلّب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق باستخدام هذا النطاق. |
محدود | ||
https://www.googleapis.com/auth/chat.app.all.messages.readonly |
الاطّلاع على جميع الرسائل والتفاعلات في مؤسستك على Google Workspace، حتى إذا لم يكن التطبيق في Chat مشاركًا في مساحة أو محادثة لا يتوافق هذا النطاق إلا مع اشتراكات العملاء. يتطلّب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق باستخدام هذا النطاق. |
محدود | ||
https://www.googleapis.com/auth/chat.app.all.users.readstate.readonly |
الاطّلاع على آخر وقت قراءة لجميع المستخدمين في جميع المساحات والمحادثات ضمن مؤسستك على Google Workspace، حتى إذا لم يكن تطبيق 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 APIs الأخرى، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات حول نطاقات 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 Events API مصادقة المستخدم والتطبيق لطلب بعض طرقها. إذا كانت إحدى طرق واجهة برمجة التطبيقات تتيح استخدام نوعَي بيانات الاعتماد، يؤثر نوع بيانات الاعتماد المستخدَم في الطلب في النتيجة التي يتم عرضها. على سبيل المثال، إذا
طلبت طريقة
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 | ||||||||
| بدء مؤتمر أو انتهاؤه |
|
|
||||||
| مشارك ينضم إلى اجتماع أو يغادره |
|
|
||||||
| تم إنشاء تسجيل. |
|
|
||||||
| تم إنشاء نص. |
|
|
||||||