Method: spaces.create

لإنشاء مساحة يمكن استخدامها لإنشاء مساحة مُسمّاة أو محادثة جماعية في Import mode. على سبيل المثال، اطّلِع على إنشاء مساحة.

تتوافق مع أنواع المصادقة التالية:

عند المصادقة كتطبيق، يجب ضبط حقل space.customer في الطلب.

يعتمد اشتراك المساحة عند إنشائها على ما إذا تم إنشاء المساحة في 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

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