تُنشئ هذه الطريقة عضوية لتطبيق الاتصال في Chat أو لمستخدم أو لمجموعة Google. لا تتوفّر إمكانية إنشاء عضويات لتطبيقات Chat الأخرى. عند إنشاء عضوية، إذا كان العضو المحدّد قد أوقف سياسة القبول التلقائي، ستتم دعوته، وعليه قبول دعوة الفضاء قبل الانضمام إليه. بخلاف ذلك، يؤدي إنشاء اشتراك إلى إضافة العضو مباشرةً إلى المساحة المحدّدة.
يتوافق مع الأنواع التالية من المصادقة:
مصادقة التطبيق من خلال موافقة المشرف ونطاق التفويض:
https://www.googleapis.com/auth/chat.app.memberships
مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
(لإضافة تطبيق الاتصال إلى المساحة)https://www.googleapis.com/auth/chat.import
(مساحات وضع الاستيراد فقط)- تمنح مصادقة المستخدم امتيازات المشرف عند مصادقة حساب مشرف، ويكون
useAdminAccess
هوtrue
، ويتم استخدام نطاق التفويض التالي:https://www.googleapis.com/auth/chat.admin.memberships
لا تتوفّر مصادقة التطبيق لحالات الاستخدام التالية:
- دعوة مستخدمين من خارج مؤسسة Workspace التي تمتلك المساحة
- إضافة "مجموعة Google" إلى مساحة
- إضافة تطبيق Chat إلى مساحة
للاطّلاع على أمثلة على الاستخدام، يُرجى الرجوع إلى:
طلب HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. تمثّل هذه السمة الاسم الكامل للمساحة التي سيتم إنشاء العضوية فيها. التنسيق: spaces/{space} |
مَعلمات طلب البحث
المعلمات | |
---|---|
useAdminAccess |
اختيارية: عند يجب أن يكون المستخدم الذي يجري المكالمة مشرفًا في Google Workspace لديه امتياز إدارة المحادثات ومحادثات المساحات. يتطلّب ذلك لا تتوفّر إمكانية إنشاء عضويات في التطبيقات أو إنشاء عضويات للمستخدمين خارج مؤسسة Google Workspace الخاصة بالمشرف باستخدام إذن الوصول كمشرف. |
نص الطلب
يحتوي نص الطلب على مثال Membership
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال تم إنشاؤه حديثًا Membership
.
نطاقات الأذونات
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.app.memberships
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.