المصادقة والترخيص هما آليتان تُستخدمان للتحقق من الهوية والوصول إلى الموارد، على التوالي. يوضّح هذا المستند آلية عمل المصادقة والتفويض لتطبيقات Chat وطلبات البيانات من واجهة برمجة التطبيقات Chat API.
نظرة عامة على العملية
يوضّح المخطّط البياني التالي الخطوات العالية المستوى للمصادقة والتفويض في Google Chat:
إعداد مشروع على Google Cloud وتفعيل Chat API وضبط تطبيق Chat: أثناء عملية التطوير، يمكنك إنشاء مشروع على Google Cloud. في مشروع Google Cloud، يمكنك تفعيل Chat API وضبط تطبيق Chat وإعداد المصادقة. لمزيد من المعلومات، يُرجى الاطّلاع على التطوير على Google Workspace وإنشاء تطبيق Chat.
استدعاء Chat API: عندما يستدعي تطبيقك Chat API، يرسل بيانات اعتماد المصادقة إلى Chat API. إذا كان تطبيقك يصادق باستخدام حساب خدمة، يتم إرسال بيانات الاعتماد كجزء من رمز تطبيقك. إذا كان تطبيقك يتطلب استدعاء Chat API باستخدام مصادقة المستخدم التي لم يتم منحها بعد، فإنه يطالب المستخدم بتسجيل الدخول.
طلب الموارد: يطلب تطبيقك الوصول إلى البيانات باستخدام النطاقات التي تحدّدها أثناء إعداد المصادقة.
طلب الموافقة: إذا كان تطبيقك يصادق كمستخدم، ستعرض Google شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth ليتمكّن المستخدم من تحديد ما إذا كان سيمنح تطبيقك إذن الوصول إلى البيانات المطلوبة. لا تتطلّب المصادقة باستخدام حساب خدمة موافقة المستخدم.
إرسال طلب موافقة للموارد: إذا وافق المستخدم على نطاقات التفويض، يجمع تطبيقك بيانات الاعتماد والنطاقات التي وافق عليها المستخدم في طلب واحد. يتم إرسال الطلب إلى خادم تفويض Google للحصول على رمز دخول.
تعرض Google رمز دخول: يحتوي رمز الدخول على قائمة بالنطاقات التي تم منحها. إذا كانت قائمة النطاقات التي تم عرضها أكثر تقييدًا من النطاقات المطلوبة، سيوقف تطبيقك أي ميزات يقيّدها الرمز المميّز.
الوصول إلى الموارد المطلوبة: يستخدم تطبيقك رمز الدخول من Google لاستدعاء Chat API والوصول إلى موارد Chat API.
الحصول على رمز مميّز لإعادة التحميل (اختياري): إذا كان تطبيقك بحاجة إلى الوصول إلى Google Chat API بعد انتهاء صلاحية رمز دخول واحد، يمكنه الحصول على رمز مميّز لإعادة التحميل. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام بروتوكول OAuth 2.0 للوصول إلى Google APIs.
طلب المزيد من الموارد: إذا كان تطبيقك يحتاج إلى المزيد من أذونات الوصول، سيطلب من المستخدم منحه نطاقات جديدة، ما يؤدي إلى طلب جديد للحصول على رمز مميّز للوصول (الخطوات من 3 إلى 6).
عندما تتطلّب تطبيقات Chat المصادقة
يمكن لتطبيقات Chat إرسال رسائل ردًا على تفاعل المستخدم أو بشكل غير متزامن. ويمكنها أيضًا إكمال المهام نيابةً عن المستخدم، مثل إنشاء مساحة Chat أو الحصول على قائمة بالمستخدمين في مساحة Chat.
لا تتطلّب تطبيقات Chat المصادقة للردّ على تفاعل المستخدم، إلا إذا استدعى تطبيق Chat واجهة برمجة تطبيقات Chat أو واجهة برمجة تطبيقات أخرى من Google أثناء معالجة الردّ.
لإرسال رسائل غير متزامنة أو تنفيذ مهام نيابةً عن مستخدم، تُرسِل تطبيقات Chat طلبات RESTful إلى واجهة برمجة تطبيقات Chat، والتي تتطلّب المصادقة والتفويض.
لا تتطلّب الردود على تفاعلات المستخدمين المصادقة
لا تحتاج تطبيقات Google Chat إلى المصادقة كمستخدم أو تطبيق Chat لتلقّي تفاعلات المستخدمين والردّ عليها بشكل متزامن.
تتلقّى تطبيقات Google Chat كائنات أحداث عندما يتفاعل المستخدم مع تطبيق Chat أو يستدعيه، بما في ذلك ما يلي:
- يرسل مستخدم رسالة إلى تطبيق Chat.
- يشير مستخدم إلى تطبيق Chat باستخدام @.
- يستدعي المستخدم أحد أوامر تطبيق Chat.
يوضّح المخطّط البياني التالي تسلسل الطلب والاستجابة بين مستخدم Chat وتطبيق Chat:
- يرسل المستخدم رسالة إلى تطبيق Chat في Google Chat.
- يعيد Google Chat توجيه الرسالة إلى التطبيق.
- يتلقّى التطبيق الرسالة ويعالجها ويعرض ردًا على Google Chat.
- يعرض Google Chat الردّ للمستخدم أو في مساحة.
يتكرر هذا التسلسل لكل تفاعل من مستخدم تطبيق Chat.
تتطلّب الرسائل غير المتزامنة المصادقة
تحدث الرسائل غير المتزامنة عندما يرسل تطبيق Chat طلبًا إلى واجهة برمجة تطبيقات Chat، ما يتطلّب المصادقة والتفويض.
من خلال طلب Chat API، يمكن لتطبيقات Chat نشر الرسائل في Google Chat أو إكمال المهام والوصول إلى البيانات نيابةً عن المستخدم. على سبيل المثال، بعد رصد انقطاع في الخدمة في الخادم، يمكن لتطبيق Chat طلب واجهة برمجة تطبيقات Chat من أجل:
- أنشئ مساحة Chat مخصّصة للتحقيق في انقطاع الخدمة وإصلاحه.
- أضِف مستخدمين إلى مساحة Chat.
- انشر رسالة في مساحة Chat لتقديم تفاصيل حول انقطاع الخدمة.
يوضّح المخطّط البياني التالي تسلسل رسائل غير متزامن بين تطبيق Chat ومساحة Chat:
- ينشئ تطبيق Chat رسالة من خلال استدعاء
Chat API باستخدام
spaces.messages.createmethod، ويتضمّن بيانات اعتماد المستخدم في طلب HTTP. - يصادق Google Chat على تطبيق Chat باستخدام حساب الخدمة أو بيانات اعتماد المستخدم.
- يعرض Google Chat رسالة التطبيق في مساحة Chat محدّدة.
نطاقات Chat API
اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختَر النطاقات لتحديد المعلومات التي تظهر للمستخدمين ومراجعي التطبيقات، وسجِّل تطبيقك لتتمكّن من نشره لاحقًا.
لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات التفويض والإفصاح عنها. نطاق التفويض هو سلسلة معرّف موارد منتظم (URI) لبروتوكول OAuth 2.0 تحتوي على اسم تطبيق Google Workspace ونوع البيانات التي يصل إليها ومستوى الوصول.
النطاقات غير الحسّاسة
| رمز النطاق | الوصف |
|---|---|
https://www.googleapis.com/auth/chat.bot
|
يتيح هذا الإذن لتطبيقات Chat الاطّلاع على المحادثات وإرسال الرسائل. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك إجراء المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق من خلال هذا النطاق. |
النطاقات الحسّاسة
| رمز النطاق | الوصف |
|---|---|
https://www.googleapis.com/auth/chat.spaces
|
إنشاء محادثات ومساحات والاطّلاع على البيانات الوصفية أو تعديلها (بما في ذلك إعدادات السجلّ وإعدادات الوصول) في Chat |
https://www.googleapis.com/auth/chat.spaces.create
|
إنشاء محادثات جديدة في Chat |
https://www.googleapis.com/auth/chat.spaces.readonly
|
الاطّلاع على المحادثات والمساحات في Chat |
https://www.googleapis.com/auth/chat.memberships
|
الاطّلاع على الأعضاء في المحادثات في Chat وإضافتهم وإزالتهم وتعديل معلوماتهم |
https://www.googleapis.com/auth/chat.memberships.app
|
الانضمام إلى المحادثات في Google Chat أو مغادرتها |
https://www.googleapis.com/auth/chat.memberships.readonly
|
الاطّلاع على المشاركين في محادثات Chat |
https://www.googleapis.com/auth/chat.messages.create
|
أنشئ الرسائل وأرسِلها في Chat. |
https://www.googleapis.com/auth/chat.messages.reactions
|
عرض وإضافة وحذف التفاعلات مع الرسائل في Chat |
https://www.googleapis.com/auth/chat.messages.reactions.create
|
إضافة تفاعلات إلى رسالة في Chat |
https://www.googleapis.com/auth/chat.messages.reactions.readonly
|
عرض التفاعلات مع رسالة في 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.admin.spaces.readonly
|
الاطّلاع على المحادثات والمساحات التي يملكها نطاق المشرف في Chat |
https://www.googleapis.com/auth/chat.admin.spaces
|
الاطّلاع على المحادثات والمساحات التي يملكها نطاق المشرف في Chat أو تعديلها |
https://www.googleapis.com/auth/chat.admin.memberships.readonly
|
الاطّلاع على الأعضاء والمدراء في المحادثات التي يملكها نطاق المشرف في Chat |
https://www.googleapis.com/auth/chat.admin.memberships
|
عرض الأعضاء والمدراء في المحادثات التي يملكها نطاق المشرف في Chat وإضافتهم وتعديلهم وإزالتهم |
https://www.googleapis.com/auth/chat.app.spaces
|
إنشاء محادثات ومساحات والاطّلاع على البيانات الوصفية أو تعديلها (بما في ذلك إعدادات السجلّ وإعدادات الوصول) في Chat كتطبيق Chat. يتطلب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك إجراء المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق من خلال هذا النطاق. |
https://www.googleapis.com/auth/chat.app.spaces.readonly
|
الاطّلاع على البيانات الوصفية (بما في ذلك إعدادات السجلّ) في Chat كتطبيق Chat، ويتطلّب ذلك موافقة المشرف لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك إجراء المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق من خلال هذا النطاق. |
https://www.googleapis.com/auth/chat.app.spaces.create
|
إنشاء محادثات ومساحات جديدة في Chat كتطبيق في Chat، ويتطلّب ذلك موافقة المشرف لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك إجراء المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق من خلال هذا النطاق. |
https://www.googleapis.com/auth/chat.app.memberships
|
الاطّلاع على الأعضاء وإضافتهم وإزالتهم وتعديل معلوماتهم في المحادثات والمساحات في Chat كتطبيق في Chat. يتطلّب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك إجراء المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق من خلال هذا النطاق. |
https://www.googleapis.com/auth/chat.app.memberships.readonly
|
الاطّلاع على الأعضاء في المحادثات والمساحات في Chat كتطبيق في Chat يتطلّب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك إجراء المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق من خلال هذا النطاق. |
https://www.googleapis.com/auth/chat.customemojis
|
عرض رموز الإيموجي المخصّصة وإنشاؤها وحذفها في Chat |
https://www.googleapis.com/auth/chat.customemojis.readonly
|
الاطّلاع على الإيموجي المخصّص في Chat |
https://www.googleapis.com/auth/chat.users.spacesettings
|
عرض إعدادات مساحة مستخدم Chat وتعديلها |
https://www.googleapis.com/auth/chat.users.sections
|
عرض الأقسام وإنشاؤها وتعديلها وحذفها في Chat، ونقل عناصر الأقسام وإدراجها في Chat |
https://www.googleapis.com/auth/chat.users.sections.readonly
|
عرض الأقسام وعناصرها في Chat |
النطاقات المحظورة
| رمز النطاق | الوصف |
|---|---|
https://www.googleapis.com/auth/chat.delete
|
حذف المحادثات والمساحات وإزالة إمكانية الوصول إلى الملفات المرتبطة بها في Chat |
https://www.googleapis.com/auth/chat.import
|
استيراد المساحات والرسائل والاشتراكات إلى Chat لمزيد من المعلومات، يُرجى الاطّلاع على المقالة تفويض تطبيقات 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.admin.delete
|
حذف المحادثات والمساحات التي يملكها نطاق المشرف وإزالة إمكانية الوصول إلى الملفات المرتبطة بها في Chat |
https://www.googleapis.com/auth/chat.app.delete
|
حذف المحادثات والمساحات وإزالة إمكانية الوصول إلى الملفات المرتبطة بها في Chat كتطبيق Chat يتطلب ذلك موافقة المشرف. لا يتيح هذا النطاق سوى مصادقة التطبيق باستخدام حسابات الخدمة. لا يمكنك إجراء المصادقة باستخدام بيانات اعتماد المستخدم أو باستخدام التفويض على مستوى النطاق من خلال هذا النطاق. |
يشير النطاق في الجداول السابقة إلى حساسيته، وفقًا للتعريفات التالية:
غير حساسة: توفّر هذه النطاقات أصغر مجال للوصول إلى التفويض وتتطلّب فقط التحقّق من التطبيقات الأساسي. للحصول على معلومات حول هذا الشرط، يُرجى الاطّلاع على خطوات الاستعداد لعملية التحقّق.
حسّاسة: تتيح هذه النطاقات لتطبيقك الوصول إلى بيانات مستخدم معيّن على Google بعد الحصول على إذن من المستخدم. ويتطلّب منك إجراء عملية إضافية للتحقّق من التطبيقات. لمزيد من المعلومات حول هذا الشرط، يُرجى الاطّلاع على خطوات التطبيقات التي تطلب نطاقات حساسة.
النطاقات المحدودة: تتيح هذه النطاقات الوصول على نطاق واسع إلى بيانات مستخدمي Google، وتتطلّب منك إكمال عملية إثبات الهوية للنطاق المحدود. للحصول على معلومات حول هذا الشرط، يُرجى الاطّلاع على خدمات Google API: سياسة بيانات المستخدمين والمتطلبات الإضافية لنطاقات معيّنة لواجهة برمجة التطبيقات. يمكنك أيضًا الاطّلاع على خطوات التطبيقات التي تطلب نطاقات محدودة.
إذا كان تطبيقك يتطلّب الوصول إلى أيّ من واجهات Google APIs الأخرى، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات حول نطاقات Google API، يُرجى الاطّلاع على مقالة استخدام بروتوكول OAuth 2.0 للوصول إلى Google APIs.
لمزيد من المعلومات حول نطاقات واجهات برمجة التطبيقات في Google Workspace، يُرجى الاطّلاع على مقالة ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختيار النطاقات.
أنواع المصادقة المطلوبة
هناك طريقتان يمكن من خلالهما لتطبيقات Chat المصادقة والتفويض باستخدام Chat API:
- مصادقة المستخدم
- مصادقة المستخدم تتيح لتطبيق Chat الوصول إلى بيانات المستخدم وإكمال الإجراءات نيابةً عن المستخدم. تحدّد نطاقات OAuth البيانات والإجراءات المصرّح بها. ما لم يكن تطبيق Chat مثبَّتًا من قِبل المشرف أو تم منحه تفويضًا على مستوى النطاق، في المرة الأولى التي ينفّذ فيها تطبيق Chat إجراءً نيابةً عن المستخدم، يجب أن يفوّض المستخدم تطبيق Chat باستخدام شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- مصادقة التطبيق
تتيح مصادقة التطبيق لتطبيق Chat استخدام بيانات اعتماد حساب الخدمة والوصول إلى البيانات وإكمال الإجراءات بصفته تطبيقًا. بما أنّ تطبيق Chat يستخدم بيانات الاعتماد الخاصة به للوصول إلى الموارد والعمل معها، لا يحتاج المستخدمون النهائيون إلى الموافقة على طلبات البيانات من واجهة برمجة التطبيقات في تطبيق Chat، ولا يمكنك إضافة نطاقات تفويض OAuth التي تتيح تفويض التطبيق إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
يتيح نوعان من نطاقات تفويض OAuth مصادقة التطبيقات:
https://www.googleapis.com/auth/chat.bot: يمكن لتطبيق Chat استدعاء طرق Google Chat API التي تتيح نطاق التفويض هذا لإنشاء الموارد التي يمكنه الوصول إليها أو تعديلها أو الحصول عليها أو إدراجها أو حذفها، مثل الرسائل في المساحات التي يضيف المستخدمون النهائيون تطبيق Chat إليها. يمكن لتطبيق Chat منح نفسه نطاق التفويض هذا، ولا يلزم الحصول على تفويض من المشرف أو المستخدم النهائي.https://www.googleapis.com/auth/chat.app.*: يتطلّب استخدام هذه النطاقات موافقة المشرف لمرة واحدة. للحصول على موافقة المشرف، عليك إعداد حساب الخدمة الخاص بالتطبيق في Chat للحصول على موافقة المشرف من خلال إنشاء عميل OAuth متوافق مع Google Workspace Marketplace وضبط التطبيق في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace. تسمح هذه النطاقات لتطبيق Chat باستدعاء طرق محدّدة في Google Chat API. على سبيل المثال، يتيحchat.app.spaces.createللتطبيقات إنشاء مساحات Chat.
إذا كانت إحدى الطرق تتيح مصادقة المستخدم أو التطبيق، ستعرض Chat API نتائج مختلفة استنادًا إلى نوع المصادقة الذي تستخدمه:
- باستخدام مصادقة التطبيق، لا تعرض الطرق سوى الموارد التي يمكن تطبيق Chat الوصول إليها.
- عند استخدام مصادقة المستخدم، لا تعرض الطرق سوى الموارد التي يمكن للمستخدم الوصول إليها.
على سبيل المثال، يؤدي استدعاء الطريقة spaces.list() باستخدام تفويض التطبيق إلى عرض قائمة المساحات التي يكون تطبيق Chat عضوًا فيها.
يؤدي استدعاء spaces.list() مع
تفويض المستخدم إلى عرض قائمة المساحات التي يكون المستخدم عضوًا فيها. من الناحية العملية، يمكنك استخدام كلا النوعين من المصادقة عند طلب Chat API، وذلك حسب تصميم تطبيق Chat وميزاته.
لطلبات البيانات غير المتزامنة من واجهة برمجة التطبيقات Chat API
يسرد الجدول التالي طرق Chat API ونطاقات التفويض المتوافقة معها:
| الطريقة | مصادقة المستخدم متاحة | تتوفّر ميزة مصادقة التطبيقات | نطاقات التفويض المتاحة | |
|---|---|---|---|---|
| المساحات | ||||
| إنشاء مساحة |
باستخدام مصادقة المستخدم:
|
|||
| إعداد مساحة | — |
باستخدام مصادقة المستخدم:
|
||
| الحصول على مساحة |
باستخدام مصادقة المستخدم:
|
|||
| إدراج المساحات |
باستخدام مصادقة المستخدم:
|
|||
| البحث في المساحات | — |
باستخدام مصادقة المستخدم من خلال امتيازات المشرف:
|
||
| تعديل مساحة |
باستخدام مصادقة المستخدم:
|
|||
| حذف مساحة |
باستخدام مصادقة المستخدم:
|
|||
| إكمال عملية الاستيراد لمساحة | — |
باستخدام مصادقة المستخدم:
|
||
| العثور على رسالة مباشرة |
باستخدام مصادقة المستخدم:
|
|||
| الأعضاء | ||||
| إنشاء عضو |
باستخدام مصادقة المستخدم:
|
|||
| الحصول على عضو |
باستخدام مصادقة المستخدم:
|
|||
| أعضاء القائمة |
باستخدام مصادقة المستخدم:
|
|||
| حذف عضو |
باستخدام مصادقة المستخدم:
|
|||
| تعديل عضو |
باستخدام مصادقة المستخدم:
|
|||
| الرسائل | ||||
| إنشاء رسالة |
باستخدام مصادقة المستخدم:
|
|||
| تلقّي رسالة |
باستخدام مصادقة المستخدم:
|
|||
| إدراج الرسائل |
باستخدام مصادقة المستخدم:
|
|||
| البحث في الرسائل | — |
باستخدام مصادقة المستخدم:
|
||
| تعديل رسالة |
باستخدام مصادقة المستخدم:
|
|||
| حذف رسالة |
باستخدام مصادقة المستخدم:
|
|||
| تثبيت رسالة | — |
باستخدام مصادقة المستخدم:
|
||
| إزالة تثبيت رسالة | — |
باستخدام مصادقة المستخدم:
|
||
| عرض الرسائل المثبَّتة | — |
باستخدام مصادقة المستخدم:
|
||
| تعديل البطاقات في رسالة | — |
باستخدام مصادقة التطبيق:
|
||
| التفاعلات | ||||
| إنشاء تفاعل | — |
باستخدام مصادقة المستخدم:
|
||
| عرض قائمة بالتفاعلات | — |
باستخدام مصادقة المستخدم:
|
||
| حذف تفاعل | — |
باستخدام مصادقة المستخدم:
|
||
| رموز إيموجي مخصصة | ||||
| إنشاء إيموجي مخصّص | — |
باستخدام مصادقة المستخدم:
|
||
| حذف إيموجي مخصّص | — |
باستخدام مصادقة المستخدم:
|
||
| الحصول على إيموجي مخصّص | — |
باستخدام مصادقة المستخدم:
|
||
| عرض قائمة بالإيموجي المخصّصة | — |
باستخدام مصادقة المستخدم:
|
||
| الوسائط والمرفقات | ||||
| تحميل الوسائط كمرفق ملف | — |
باستخدام مصادقة المستخدم:
|
||
| تنزيل الوسائط |
باستخدام مصادقة المستخدم:
|
|||
| الحصول على مرفق رسالة | — |
باستخدام مصادقة التطبيق:
|
||
| حالات قراءة المستخدمين | ||||
| الحصول على حالة قراءة مساحة مستخدم | — |
باستخدام مصادقة المستخدم:
|
||
| تعديل حالة قراءة مساحة مستخدم | — |
باستخدام مصادقة المستخدم:
|
||
| الحصول على حالة قراءة سلسلة محادثات لمستخدم | — |
باستخدام مصادقة المستخدم:
|
||
| تعديل حالة قراءة سلسلة محادثات لمستخدم | — |
باستخدام مصادقة المستخدم:
|
||
| إعدادات مساحة المستخدم | ||||
| الحصول على إعدادات إشعارات مساحة مستخدم | — |
باستخدام مصادقة المستخدم:
|
||
| تعديل إعدادات إشعارات المساحة لمستخدم | — |
باستخدام مصادقة المستخدم:
|
||
| أحداث المساحات | ||||
| الحصول على أحداث المساحة | — |
عند استخدام مصادقة المستخدم،
يجب استخدام نطاق استنادًا إلى
نوع الحدث:
|
||
| إدراج أحداث المساحة | — |
عند استخدام مصادقة المستخدم،
يجب استخدام نطاق لكل
نوع حدث مضمَّن في الطلب:
|
||
| الأقسام | ||||
| إنشاء قسم | — |
باستخدام مصادقة المستخدم:
|
||
| حذف قسم | — |
باستخدام مصادقة المستخدم:
|
||
| أقسام القائمة | — |
باستخدام مصادقة المستخدم:
|
||
| تعديل قسم | — |
باستخدام مصادقة المستخدم:
|
||
| تحديد موضع قسم | — |
باستخدام مصادقة المستخدم:
|
||
| Section Items | ||||
| نقل عنصر في قسم | — |
باستخدام مصادقة المستخدم:
|
||
| List section items | — |
باستخدام مصادقة المستخدم:
|
||
بالنسبة إلى أحداث التفاعل مع تطبيق Chat
يسرد الجدول التالي الطرق الشائعة التي يتفاعل بها المستخدمون مع تطبيقات Chat وما إذا كانت المصادقة مطلوبة أو متوافقة:
| السيناريو | لا يلزم إجراء مصادقة | مصادقة المستخدم متاحة | تتوفّر ميزة مصادقة التطبيقات | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| تلقّي رسائل من: |
|
|||||||||||||||
| الرد على الرسائل: |
|
|||||||||||||||
| إرسال رسائل جديدة: |
|
|||||||||||||||
المواضيع ذات الصلة
- للحصول على نظرة عامة حول المصادقة والتفويض في Google Workspace، يُرجى الاطّلاع على التعرّف على المصادقة والتفويض.
- للحصول على نظرة عامة حول المصادقة والترخيص في Google Cloud، يُرجى الاطّلاع على نظرة عامة حول المصادقة.
- لمزيد من المعلومات حول حسابات الخدمة، يُرجى الاطّلاع على حسابات الخدمة.
- لمزيد من المعلومات حول كيفية استخدام Google APIs لبروتوكول OAuth 2.0، يُرجى الاطّلاع على المقالة استخدام بروتوكول OAuth 2.0 للوصول إلى Google APIs.
- إعداد المصادقة والتفويض باستخدام بيانات اعتماد المستخدم أو حساب خدمة
- لإدارة أذونات OAuth الدقيقة، يُرجى الاطّلاع على المقالة إدارة أذونات OAuth الدقيقة لتطبيقات Google Chat.