المرجع: مساحة
مساحة في Google Chat المساحات هي محادثات بين مستخدمَين أو أكثر أو رسائل بين مستخدمَين أو تطبيق في Chat.
تمثيل JSON |
---|
{ "name": string, "type": enum ( |
الحقول | |
---|---|
name |
اسم المورد للمساحة تنسيق الملف: |
type |
النتائج فقط. مهملة: يمكنك استخدام |
spaceType |
نوع المساحة. تكون هذه السمة مطلوبة عند إنشاء مساحة أو تعديل نوعها. المخرجات للاستخدامات الأخرى فقط. |
singleUserBotDm |
اختياريّ. ما إذا كانت المساحة رسالة مباشرة بين تطبيق Chat ومستخدم واحد |
threaded |
النتائج فقط. مهملة: يمكنك استخدام |
displayName |
الاسم المعروض للمساحة تكون هذه السمة مطلوبة عند إنشاء مساحة. إذا ظهرت لك رسالة الخطأ بالنسبة إلى الرسائل المباشرة، قد يكون هذا الحقل فارغًا. إمكانية استخدام ما يصل إلى 128 حرفًا |
externalUserAllowed |
غير قابل للتغيير. ما إذا كانت هذه المساحة تسمح لأي مستخدم Google Chat كعضو يجب إدخاله عند إنشاء مساحة في مؤسسة Google Workspace. احذف هذا الحقل عند إنشاء مسافات في الحالات التالية:
بالنسبة إلى المساحات الحالية، يكون هذا الحقل ناتجًا فقط. |
spaceThreadingState |
النتائج فقط. حالة سلاسل المحادثات في "مساحة Chat" |
spaceDetails |
تفاصيل عن المساحة، بما في ذلك الوصف والقواعد |
spaceHistoryState |
حالة سجلّ الرسائل للرسائل وسلاسل المحادثات في هذه المساحة |
importMode |
اختياريّ. ما إذا تم إنشاء هذه المساحة في " |
createTime |
اختياريّ. غير قابل للتغيير. وقت إنشائها في المساحات التي تم إنشاؤها في Chat هذا الحقل مخصّص للمخرجات فقط، إلا عند استخدامه في مساحات وضع الاستيراد. بالنسبة إلى مساحات وضع الاستيراد، يجب ضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء المساحة فيه في المصدر من أجل الحفاظ على وقت الإنشاء الأصلي. وتتم تعبئة هذا الحقل في النتيجة فقط عندما تكون قيمة السمة |
adminInstalled |
النتائج فقط. بالنسبة إلى مساحات الرسائل المباشرة التي تتضمن تطبيق Chat، سواء تم إنشاء المساحة من قِبل مشرف Google Workspace يمكن للمشرفين تثبيت رسالة مباشرة وإعدادها باستخدام تطبيق في Chat نيابةً عن المستخدمين في مؤسستهم. لإتاحة إمكانية التثبيت من المشرف، يجب أن يوفّر تطبيق Chat ميزة المراسلة المباشرة. |
accessSettings |
اختياريّ. يحدِّد إعداد الوصول إلى المساحة. تتم تعبئة هذا الحقل فقط عندما تكون قيمة |
spaceUri |
النتائج فقط. معرّف الموارد المنتظم (URI) للمساحة |
النوع
مهملة: يمكنك استخدام SpaceType
بدلاً منها.
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
محجوز. |
ROOM |
المحادثات بين شخصين أو أكثر |
DM |
رسالة مباشرة بين مستخدم وتطبيق في Chat، حيث تكون جميع الرسائل مسطحة يُرجى العلم أنّ هذا لا يشمل الرسائل المباشرة بين شخصين. |
SpaceType
نوع المساحة. تكون مطلوبة عند إنشاء مساحة أو تعديلها. المخرجات للاستخدامات الأخرى فقط.
عمليات التعداد | |
---|---|
SPACE_TYPE_UNSPECIFIED |
محجوز. |
SPACE |
مكان يمكن للأشخاص إرسال الرسائل ومشاركة الملفات والتعاون. يمكن أن تتضمّن SPACE تطبيقات Chat. |
GROUP_CHAT |
محادثات جماعية بين 3 أشخاص أو أكثر يمكن أن تتضمّن GROUP_CHAT تطبيقات Chat. |
DIRECT_MESSAGE |
رسائل بين شخصَين أو بين شخصَين أو تطبيق في Chat |
SpaceThreadingState
تُحدِّد هذه السياسة نوع حالة سلسلة المحادثات في "مساحة Chat".
عمليات التعداد | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
محجوز. |
THREADED_MESSAGES |
المساحات المُعنونة التي تتيح سلاسل الرسائل وعندما يردّ المستخدمون على رسالة، يمكنهم الردّ في سلسلة محادثات، ما يجعل الردّ ضمن سياق الرسالة الأصلية. |
GROUPED_MESSAGES |
المساحات المُسمّاة التي يتم تنظيم المحادثة فيها حسب الموضوع يتم تجميع المواضيع وردودها معًا. |
UNTHREADED_MESSAGES |
رسائل مباشرة بين شخصين ومحادثات جماعية بين 3 مستخدمين أو أكثر |
SpaceDetails
تفاصيل عن المساحة، بما في ذلك الوصف والقواعد
تمثيل JSON |
---|
{ "description": string, "guidelines": string } |
الحقول | |
---|---|
description |
اختياريّ. وصف للمساحة على سبيل المثال، يمكنك وصف موضوع المناقشة الخاص بالمساحة أو الغرض الوظيفي أو المشاركين فيها. إمكانية استخدام ما يصل إلى 150 حرفًا. |
guidelines |
اختياريّ. قواعد المساحة والتوقعات والآداب. إمكانية استخدام ما يصل إلى 5,000 حرف |
HistoryState
حالة السجلّ للرسائل والمساحات تحدِّد هذه السياسة مدة الاحتفاظ بالرسائل وسلاسل المحادثات بعد الإنشاء.
عمليات التعداد | |
---|---|
HISTORY_STATE_UNSPECIFIED |
القيمة التلقائية. يُرجى عدم الاستخدام. |
HISTORY_OFF |
السجلّ غير مفعّل. يتم الاحتفاظ بالرسائل وسلاسل المحادثات لمدة 24 ساعة. |
HISTORY_ON |
السجلّ مفعّل. تحدِّد قواعد الاحتفاظ بالبيانات في Vault الخاصة بالمؤسسة مدة الاحتفاظ بالرسائل وسلاسل المحادثات. |
AccessSettings
يمثّل إعدادات الوصول إلى المساحة.
تمثيل JSON |
---|
{
"accessState": enum ( |
الحقول | |
---|---|
accessState |
النتائج فقط. يشير إلى حالة الوصول إلى المساحة. |
audience |
اختياريّ. اسم المورد للجمهور المستهدف الذي يمكنه الوصول إلى المساحة. اضبط هذا الحقل على رقم تعريف جمهور مستهدف صالح لجعل المساحة قابلة للاكتشاف أو استخدِم العنوان البديل للبريد الإلكتروني |
AccessState
يمثّل حالة الوصول إلى المساحة.
عمليات التعداد | |
---|---|
ACCESS_STATE_UNSPECIFIED |
حالة الوصول غير معروفة أو غير مدعومة في واجهة برمجة التطبيقات هذه. |
PRIVATE |
تكون المساحة قابلة للاكتشاف من خلال الأعضاء أو المجموعات الذين تمت إضافتهم أو دعوتهم. |
DISCOVERABLE |
يمكن للجمهور المستهدف المحدَّد اكتشاف المساحة، بالإضافة إلى الأعضاء أو المجموعات الذين تمت إضافتهم أو دعوتهم. |
الطُرق |
|
---|---|
|
تكمل عملية الاستيراد للمساحة المحددة وتجعلها مرئية للمستخدمين. |
|
تنشئ مساحة اسمها. |
|
لحذف مساحة مُعينة |
|
تعرض الرسالة المباشرة الحالية للمستخدم المحدّد. |
|
لعرض تفاصيل حول مساحة |
|
يسرد المساحات التي ينتمي إليها المتصل. |
|
لتعديل مساحة |
|
ينشئ مساحة ويضيف مستخدمين محددين إليها. |