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

اختياريّ. معرّف فريد لهذا الطلب. يُنصح باستخدام معرّف فريد عالمي عشوائي. يؤدي تحديد معرّف الطلب إلى جعل الطلب غير قابل للتكرار، ما يضمن أن تؤدي الطلبات المتطابقة المتعددة التي تحمل معرّف الطلب نفسه إلى إنشاء مساحة واحدة فقط. تؤدي الطلبات اللاحقة التي تحمل رقم تعريف الطلب نفسه إلى عرض المساحة الحالية بدون تعديلها، حتى إذا كانت التفاصيل المطلوبة مختلفة عن الحالة الحالية.

لاستخدام هذا الحقل بفعالية، اتّبِع الخطوات التالية:

  • تأكَّد من أنّ الطلبات اللاحقة متطابقة وتستخدم بيانات اعتماد المصادقة نفسها المستخدَمة في الطلب الأصلي.
  • إذا سبق أن تم إنشاء مساحة باستخدام رقم تعريف الطلب المقدَّم، سيعرض الطلب هذه المساحة. يُرجى العِلم أنّ المساحة التي يتم عرضها قد لا تكون مكتملة، إذ تعرض واجهة برمجة التطبيقات المساحة في طلبك مع اسم المورد الذي يحدّده النظام. لاسترداد أحدث البيانات الوصفية للمساحة، استخدِم الدالة spaces.get.
  • سيؤدي إعادة استخدام معرّف طلب حالي مع مستخدم مصادَق عليه مختلف إلى حدوث خطأ.

نص الطلب

يحتوي نص الطلب على مثال 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

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