Method: spaces.members.create

إنشاء اشتراك بشري أو عضوية في التطبيق لتطبيق المكالمات. لا يمكن إنشاء عضويات في التطبيقات الأخرى. مثلاً، راجِع دعوة مستخدم أو تطبيق 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

string

مطلوبة. اسم مورد المساحة المطلوب إنشاء العضوية فيها.

التنسيق: Spaces/{space}

معلمات طلب البحث

المعلمات
useAdminAccess

boolean

عند true، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم.

يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات".

يتطلب نطاق OAuth 2.0 chat.admin.memberships.

لا تتوفّر إمكانية إنشاء اشتراكات في التطبيقات أو إنشاء اشتراكات للمستخدمين خارج مؤسسة المشرف في 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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.