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

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