Method: spaces.members.create

يؤدي هذا الخيار إلى إنشاء عضوية بشرية أو عضوية في تطبيق الاتصال، علمًا بأنّه لا يمكن إنشاء عضويات في التطبيقات الأخرى. مثلاً، راجِع دعوة مستخدم أو تطبيق Google Chat إلى مساحة أو إضافتهما. عند إنشاء عضوية، في حال إيقاف سياسة القبول التلقائي للعضو المحدّد، ستتم دعوته، ويجب أن يقبل دعوة المساحة قبل الانضمام. بخلاف ذلك، يؤدي إنشاء عضوية إلى إضافة العضو مباشرةً إلى المساحة المحددة. يتطلب مصادقة المستخدم.

لتحديد العضو المطلوب إضافته، اضبط السمة membership.member.name للعضو البشري أو العضو في التطبيق.

  • لإضافة تطبيق الاتصال إلى مساحة أو رسالة مباشرة بين مستخدمَين، استخدِم "users/app". تتعذَّر إضافة تطبيقات أخرى إلى المساحة.

  • لإضافة مستخدم، يجب استخدام users/{user}، حيث يمكن أن يكون {user} عنوان البريد الإلكتروني للمستخدم. بالنسبة إلى المستخدمين في مؤسسة Workspace نفسها، يمكن أن يكون {user} أيضًا id للمستخدم من People API، أو id للمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للشخص في واجهة برمجة تطبيقات الأشخاص في user@example.com هو 123456789، يمكنك إضافة المستخدم إلى المساحة من خلال ضبط membership.member.name على users/user@example.com أو users/123456789.

طلب HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
parent

string

مطلوبة. اسم المورد للمساحة المراد إنشاء الاشتراك لها.

التنسيق: المسافات/{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

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