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