يحتوي هذا المستند على تفويض خاص بواجهة برمجة التطبيقات لـ 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:
| رمز النطاق | الوصف | الاستخدام | ||
|---|---|---|---|---|
| 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.reaction ثانية |
عرض وإضافة وحذف التفاعلات مع الرسائل في 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 |
عرض الرسائل والتفاعلات في Google 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، يمكنك الاطّلاع على استخدام OAuth 2.0 من أجل الوصول إلى Google APIs
لمزيد من المعلومات عن نطاقات OAuth 2.0 المحدّدة، يمكنك الاطّلاع على نطاقات OAuth 2.0 لـ Google APIs:
التحقّق من OAuth
قد يتطلب استخدام نطاقات OAuth معينة متابعة تطبيقك من خلال بروتوكول التحقّق من OAuth . الاطّلاع على التحقق من واجهة برمجة تطبيقات OAuth الأسئلة الشائعة لتحديد الوقت الذي يجب أن يخضع التطبيق فيه لعملية التحقق ونوع مطلوبة. يمكنك الاطّلاع أيضًا على بنود خدمة Google Drive الإضافية الخدمة:
أنواع المصادقة المطلوبة
يوضح هذا القسم أنواع المصادقة المطلوبة أو المتاحة وتوفر النطاقات المتوافقة لكل طريقة من واجهة برمجة التطبيقات لفعاليات Google Workspace
بالنسبة إلى اشتراكات أحداث 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 Events API باستخدام مصادقة المستخدم، يمكنك إجراء ما يلي: نطاق واحد أو أكثر يتوافق مع أنواع أحداث اشتراكك.
يعرض الجدول التالي نطاقات التفويض المتاحة لكل نوع الحدث:
| الأحداث | أنواع الأحداث | نطاقات التفويض المتوافقة | ||||||
|---|---|---|---|---|---|---|---|---|
| Google Chat | ||||||||
| تم نشر رسالة أو تعديلها. |
|
|
||||||
| تتم إضافة تفاعل أو حذفه، أو تغيير تفاعلات متعددة. |
|
|
||||||
| الاشتراك إنشاء أو تحديثها أو إزالتها أو تعدّد العضويات التغييرات. |
|
|
||||||
| تم تعديل مساحة أو حذفها. |
|
|
||||||
| Google Meet | ||||||||
| يبدأ مؤتمر أو ينتهي. |
|
|
||||||
| ينضم مشارك إلى مكالمة فيديو أو يغادرها. |
|
|
||||||
| تم إنشاء تسجيل. |
|
|
||||||
| تم إنشاء نص. |
|
|
||||||