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 وفي "المساحات".

تتطلّب هذه الوظيفة 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

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