اختيار نطاقات Google Workspace Events API

يحتوي هذا المستند على تفويض خاص بواجهة برمجة التطبيقات لـ 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 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 فقط) نطاقات الأذونات المتاحة
إنشاء اشتراك

يتطلب نطاقًا متوافقًا لكل نوع حدث:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
الحصول على اشتراك مع مصادقة المستخدم، تتطلب هذه الطريقة نطاقًا يتوافق مع نوع حدث واحد على الأقل للاشتراك.

عند استخدام مصادقة التطبيقات (تطبيقات Google Chat فقط):

  • chat.bot
قائمة الاشتراكات مع مصادقة المستخدم، تتطلب هذه الطريقة نطاقًا يتوافق مع نوع حدث واحد على الأقل للاشتراك.

عند استخدام مصادقة التطبيقات (تطبيقات Google Chat فقط):

  • chat.bot
تعديل اشتراك

يتطلب نطاقًا متوافقًا لكل نوع حدث:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
إعادة تفعيل اشتراك

يتطلب نطاقًا متوافقًا لكل نوع حدث:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
حذف اشتراك مع مصادقة المستخدم، تتطلب هذه الطريقة نطاقًا يتوافق مع نوع حدث واحد على الأقل للاشتراك.

عند استخدام مصادقة التطبيقات (تطبيقات Google Chat فقط):

  • chat.bot

النطاقات حسب نوع الحدث

عند استدعاء واجهة برمجة التطبيقات Google Workspace Events API باستخدام مصادقة المستخدم، يمكنك إجراء ما يلي: نطاق واحد أو أكثر يتوافق مع أنواع أحداث اشتراكك.

يعرض الجدول التالي نطاقات التفويض المتاحة لكل نوع الحدث:

الأحداث أنواع الأحداث نطاقات التفويض المتوافقة
Google Chat  
تم نشر رسالة أو تعديلها.
  • google.workspace.chat.message.v1.created
  • google.workspace.chat.message.v1.updated
  • chat.messages
  • chat.messages.readonly
تتم إضافة تفاعل أو حذفه، أو تغيير تفاعلات متعددة.
  • google.workspace.chat.reaction.v1.created
  • google.workspace.chat.reaction.v1.deleted
  • google.workspace.chat.reaction.v1.batchChanged
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.messages
  • chat.messages.readonly
الاشتراك إنشاء أو تحديثها أو إزالتها أو تعدّد العضويات التغييرات.
  • google.workspace.chat.membership.v1.created
  • google.workspace.chat.membership.v1.updated
  • google.workspace.chat.membership.v1.deleted
  • google.workspace.chat.membership.v1.batchChanged
  • chat.memberships
  • chat.memberships.readonly
تم تعديل مساحة أو حذفها.
  • google.workspace.chat.space.v1.updated
  • google.workspace.chat.space.v1.deleted
  • chat.spaces
  • chat.spaces.readonly
Google Meet  
يبدأ مؤتمر أو ينتهي.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended
  • meetings.space.created
  • meetings.space.readonly
ينضم مشارك إلى مكالمة فيديو أو يغادرها.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left
  • meetings.space.created
  • meetings.space.readonly
تم إنشاء تسجيل.
  • google.workspace.meet.recording.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly
تم إنشاء نص.
  • google.workspace.meet.transcript.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly