Method: spaces.create

تنشئ هذه الطريقة مساحة. يمكن استخدامها لإنشاء مساحة مُسمّاة أو محادثة جماعية في 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

string

اختيارية: معرّف فريد لهذا الطلب. يُنصح باستخدام معرّف فريد عالمي (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

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