REST Resource: spaces

{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,
  "customer": string,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}

string

المعرّف اسم المورد للمساحة.

التنسيق: spaces/{space}

حيث يمثّل {space} المعرّف الذي عيّنه النظام للمساحة. يمكنك الحصول على رقم تعريف المساحة من خلال استدعاء الطريقة spaces.list() أو من عنوان URL للمساحة. على سبيل المثال، إذا كان عنوان URL للمساحة هو https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA، يكون رقم تعريف المساحة هو AAAAAAAAA.

enum (Type)

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام spaceType بدلاً منها. نوع المساحة

enum (SpaceType)

اختيارية: نوع المساحة مطلوب عند إنشاء مساحة أو تعديل نوع المساحة. النتائج فقط للاستخدامات الأخرى.

boolean

اختيارية: ما إذا كانت المساحة عبارة عن رسالة مباشرة بين تطبيق Chat ومستخدم واحد

boolean

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام spaceThreadingState بدلاً منها. ما إذا كانت الرسائل مُدرَجة في سلسلة محادثات في هذه المساحة

string

اختيارية: الاسم المعروض للمساحة مطلوب عند إنشاء مساحة بقيمة spaceType تبلغ SPACE. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS عند إنشاء مساحة أو تعديل displayName، جرِّب displayName مختلفًا. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض.

بالنسبة إلى الرسائل المباشرة، قد يكون هذا الحقل فارغًا.

يمكن أن يتضمّن ما يصل إلى 128 حرفًا.

boolean

اختيارية: غير قابل للتغيير ما إذا كانت هذه المساحة تسمح لأي مستخدم في Google Chat بأن يكون عضوًا فيها الإدخال عند إنشاء مساحة في مؤسسة على Google Workspace انسَبِق هذا الحقل عند إنشاء المساحات في الحالات التالية:

• يستخدم المستخدم الذي تمّت مصادقة هويته حساب مستهلك (حساب مستخدم غير مُدار). تسمح المساحة التي أنشأها حساب مستهلك تلقائيًا لأي مستخدم في Google Chat بالانضمام إليها.

بالنسبة إلى المساحات الحالية، يكون هذا الحقل مخصّصًا للعرض فقط.

enum (SpaceThreadingState)

النتائج فقط. حالة سلسلة المحادثات في مساحة Chat

object (SpaceDetails)

اختيارية: تفاصيل عن المساحة، بما في ذلك الوصف والقواعد

enum (HistoryState)

اختيارية: حالة سجلّ الرسائل للرسائل وسلاسل المحادثات في هذه المساحة

boolean

اختيارية: ما إذا تم إنشاء هذه المساحة في Import Mode كجزء من عملية نقل البيانات إلى Google Workspace أثناء استيراد المساحات، لا تكون مرئية للمستخدمين إلى أن تكتمل عملية الاستيراد.

يتطلب إنشاء مساحة في Import Mode مصادقة المستخدم.

string (Timestamp format)

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

بالنسبة إلى المساحات في وضع الاستيراد، اضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء المساحة به في المصدر من أجل الحفاظ على وقت الإنشاء الأصلي.

لا تتم تعبئة هذا الحقل في الإخراج إلا عندما يكون spaceType هو GROUP_CHAT أو SPACE.

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر رسالة في المساحة

boolean

النتائج فقط. بالنسبة إلى مساحات الرسائل المباشرة التي تتضمّن تطبيق Chat، سواء أنشأها مشرف Google Workspace أم لا يمكن للمشرفين تثبيت رسالة مباشرة وإعدادها باستخدام تطبيق Chat نيابةً عن المستخدمين في مؤسستهم.

لتفعيل ميزة "التثبيت من خلال المشرف"، يجب أن يتضمّن تطبيق Chat ميزة المراسلة المباشرة.

object (MembershipCount)

النتائج فقط. عدد العضويات التي تم الانضمام إليها مجمّعة حسب نوع العضو تتم تعبئة هذه السمة عندما يكون spaceType هو SPACE أو DIRECT_MESSAGE أو GROUP_CHAT.

object (AccessSettings)

اختيارية: تُحدِّد إعداد الوصول إلى المساحة. لا تتم تعبئة هذا الحقل إلا عندما يكون spaceType هو SPACE.

string

النتائج فقط. معرّف الموارد المتسلسل (URI) للمستخدم للوصول إلى المساحة

string

اختيارية: غير قابل للتغيير رقم تعريف العميل لنطاق المساحة. لا يكون مطلوبًا إلا عند إنشاء مساحة باستخدام مصادقة التطبيق ويكون SpaceType هو SPACE، وإلا يجب عدم ضبطه.

بالتنسيق customers/{customer}، حيث يكون customer هو id من [مورد عملاء حزمة تطوير البرامج (SDK) للمشرف]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). يمكن للتطبيقات الخاصة أيضًا استخدام الاسم المعرِّف customers/my_customer لإنشاء المساحة في مؤسسة Google Workspace نفسها التي ينتمي إليها التطبيق.

لا تتم تعبئة هذا الحقل للرسائل المباشرة.

enum (PredefinedPermissionSettings)

اختيارية: الإدخال فقط إعدادات أذونات المساحة المحدّدة مسبقًا، لا يتم إدخالها إلا عند إنشاء مساحة. في حال عدم ضبط الحقل، يتم إنشاء مساحة تعاون. بعد إنشاء المساحة، تتم تعبئة الإعدادات في الحقل PermissionSettings.

object (PermissionSettings)

اختيارية: إعدادات أذونات المساحة للمساحات الحالية إدخال لتعديل إعدادات أذونات المساحة الدقيقة، حيث يتم استبدال إعدادات الأذونات الحالية يسرد الإخراج إعدادات الأذونات الحالية.