Method: spaces.members.create

تُنشئ هذه الطريقة عضوية لتطبيق الاتصال في 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

string

مطلوب. تمثّل هذه السمة الاسم الكامل للمساحة التي سيتم إنشاء العضوية فيها.

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

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

المعلمات
useAdminAccess

boolean

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

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

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

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

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