إنشاء اشتراك بشري أو عضوية في التطبيق لتطبيق المكالمات. لا يمكن إنشاء عضويات في التطبيقات الأخرى. مثلاً، راجِع دعوة مستخدم أو تطبيق Google Chat إلى مساحة أو إضافتهما إلى مساحة. عند إنشاء عضوية، إذا تم إيقاف سياسة القبول التلقائي لدى العضو المحدّد، ستتم دعوته وعليه قبول دعوة المساحة قبل الانضمام. بخلاف ذلك، يؤدي إنشاء عضوية إلى إضافة العضو مباشرةً إلى المساحة المحددة. يتطلب مصادقة المستخدم.
لتحديد العضو الذي تريد إضافته، اضبط السمة membership.member.name
للعضو أو لعضو التطبيق، أو اضبط السمة membership.group_member.name
للعضو في المجموعة.
لإضافة تطبيق الاتصال إلى مساحة أو رسالة مباشرة بين مستخدمَين، استخدِم
users/app
. تتعذّر إضافة تطبيقات أخرى إلى المساحة.لإضافة مستخدم فعلي، استخدِم
users/{user}
، حيث يمكن أن يكون{user}
عنوان البريد الإلكتروني للمستخدم. بالنسبة إلى المستخدمين في مؤسسة Workspace نفسها، يمكن أن تكون السمة{user}
هيid
للمستخدم من People API، أوid
للمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للمستخدم في People API فيuser@example.com
هو123456789
، يمكنك إضافة المستخدم إلى المساحة من خلال ضبطmembership.member.name
علىusers/user@example.com
أوusers/123456789
.لإضافة مجموعة Google أو دعوتها في مساحة مُسَمّاة، يمكنك استخدام
groups/{group}
، حيث يكون{group}
هوid
للمجموعة من Cloud Identity Groups API. مثلاً، يمكنك استخدام Cloud Identity Groups lookup API لاسترداد المعرّف123456789
لعنوان البريد الإلكتروني للمجموعةgroup@example.com
، ثم إضافة المجموعة أو دعوتها إلى مساحة مُعنوَنة من خلال ضبطmembership.group_member.name
علىgroups/123456789
. عنوان البريد الإلكتروني للمجموعة غير متاح ولا يمكن إضافة "مجموعات Google" إلا كأعضاء في المساحات المُعنونة.
طلب HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوبة. اسم مورد المساحة المطلوب إنشاء العضوية فيها. التنسيق: Spaces/{space} |
معلمات طلب البحث
المعلمات | |
---|---|
useAdminAccess |
true ، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم.يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاق OAuth 2.0 لا تتوفّر إمكانية إنشاء اشتراكات في التطبيقات أو إنشاء اشتراكات للمستخدمين خارج مؤسسة المشرف في Google Workspace باستخدام إذن وصول المشرف. |
نص الطلب
يحتوي نص الطلب على مثال Membership
.
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Membership
تم إنشاؤه حديثًا.
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.