تنشئ هذه الطريقة مساحة. يمكن استخدامها لإنشاء مساحة مُسمّاة أو محادثة جماعية في Import mode
. للاطّلاع على مثال، راجِع إنشاء مساحة.
يتوافق مع الأنواع التالية من المصادقة:
مصادقة التطبيق من خلال موافقة المشرف وأحد نطاقات التفويض التالية:
https://www.googleapis.com/auth/chat.app.spaces.create
https://www.googleapis.com/auth/chat.app.spaces
مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.import
(مساحات وضع الاستيراد فقط)
عند إجراء المصادقة كتطبيق، يجب ضبط الحقل space.customer
في الطلب.
عند المصادقة كتطبيق، تتم إضافة تطبيق Chat كعضو في المساحة. ومع ذلك، على عكس المصادقة البشرية، لا تتم إضافة تطبيق Chat كمدير للمساحة. بشكلٍ تلقائي، يمكن لجميع أعضاء المساحة إزالة تطبيق Chat منها. للسماح لمدراء المساحة فقط بإزالة التطبيق من مساحة، اضبط space.permission_settings.manage_apps
على managersAllowed
.
يعتمد الاشتراك في المساحة عند إنشائها على ما إذا تم إنشاؤها في Import mode
:
- وضع الاستيراد: لا يتم إنشاء أي أعضاء.
- جميع الأوضاع الأخرى: تتم إضافة المستخدم الذي يجري المكالمة كعضو. وهي:
- التطبيق نفسه عند استخدام ميزة "مصادقة التطبيق"
- المستخدم البشري عند استخدام مصادقة المستخدم
إذا تلقّيت رسالة الخطأ ALREADY_EXISTS
عند إنشاء مساحة، جرِّب استخدام displayName
مختلف. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض.
طلب HTTP
POST https://chat.googleapis.com/v1/spaces
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات طلب البحث
المعلمات | |
---|---|
requestId |
اختيارية: معرّف فريد لهذا الطلب. يُنصح باستخدام معرّف فريد عالمي (UUID) عشوائي. يؤدي تحديد معرّف طلب حالي إلى عرض المساحة التي تم إنشاؤها باستخدام هذا المعرّف بدلاً من إنشاء مساحة جديدة. يؤدي تحديد معرّف طلب حالي من تطبيق Chat نفسه مع مستخدم مختلف تمت مصادقته إلى عرض خطأ. |
نص الطلب
يحتوي نص الطلب على مثال Space
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال تم إنشاؤه حديثًا Space
.
نطاقات الأذونات
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.app.spaces.create
https://www.googleapis.com/auth/chat.app.spaces
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.