المرجع: مساحة
مساحة في 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. هذا الحقل هو الناتج فقط، إلا عند استخدامه في مساحات وضع الاستيراد. بالنسبة إلى مساحات وضع الاستيراد، يجب ضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء المساحة فيه في المصدر للحفاظ على وقت الإنشاء الأصلي. تتم تعبئة هذا الحقل في الإخراج فقط عندما تكون قيمة |
lastActiveTime |
النتائج فقط. الطابع الزمني لآخر رسالة في المساحة |
adminInstalled |
النتائج فقط. بالنسبة إلى مساحات الرسائل المباشرة التي تتضمّن تطبيق Chat، سواء أنشأها مشرف Google Workspace أم لا يمكن للمشرفين تثبيت رسالة مباشرة وإعدادها باستخدام تطبيق في Chat نيابةً عن المستخدمين في مؤسستهم. لإتاحة التثبيت من خلال المشرف، يجب أن يتضمّن تطبيق Chat ميزة الرسائل المباشرة. |
membershipCount |
النتائج فقط. يشير هذا المقياس إلى عدد العضويات في القناة مجمّعة حسب نوع العضوية. تتم تعبئة هذا الحقل عند ضبط |
accessSettings |
اختياريّ. تُحدِّد إعدادات الوصول إلى المساحة. لا تتم تعبئة هذا الحقل إلا عندما تكون قيمة |
spaceUri |
النتائج فقط. معرّف الموارد المنتظم (URI) الخاص بالمستخدم للوصول إلى المساحة |
حقل الربط space_permission_settings يمثّل هذا الإعداد إعدادات الأذونات للمساحة. لا تتم تعبئة هذا الحقل إلا عندما تكون قيمة space_type هي SPACE . يمكن أن يكون space_permission_settings واحدًا فقط مما يلي: |
|
predefinedPermissionSettings |
اختياريّ. الإدخال فقط. إعدادات أذونات المساحة إدخال لإنشاء مساحة، يتم إنشاء مساحة تعاون في حال عدم ضبط هذا الحقل. بعد إنشاء المساحة، تتم تعبئة الإعدادات في الحقل |
permissionSettings |
اختياريّ. إعدادات الأذونات الدقيقة التي يمكن ضبطها لتعديل المساحة حقل إدخال لتعديل المساحة في الحالات الأخرى، يتم عرض الناتج فقط. لإنشاء مساحة، استخدِم |
النوع
متوقّفة نهائيًا: استخدِم 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 للمؤسسة مدة الاحتفاظ بالرسائل وسلاسل المحادثات. |
MembershipCount
تمثيل JSON |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
الحقول | |
---|---|
joinedDirectHumanUserCount |
عدد المستخدمين الذين انضموا مباشرةً إلى المساحة، ولا يتم احتساب عدد المستخدمين الذين انضموا من خلال العضوية في مجموعة |
joinedGroupCount |
عدد جميع المجموعات التي انضمت مباشرةً إلى المساحة |
AccessSettings
يمثل هذا الإعداد إعدادات الوصول للمساحة.
تمثيل JSON |
---|
{
"accessState": enum ( |
الحقول | |
---|---|
accessState |
النتائج فقط. يشير إلى حالة الوصول إلى المساحة. |
audience |
اختياريّ. اسم المورد للجمهور المستهدف الذي يمكنه الاطّلاع على المساحة والانضمام إليها ومعاينة الرسائل في المساحة. في حال ترك هذه السياسة بدون ضبط، يمكن فقط للمستخدمين أو "مجموعات Google" الذين تمت دعوتهم أو تمت إضافتهم إلى المساحة بشكل فردي الوصول إليها. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إنشاء مساحة قابلة للاكتشاف من الجمهور المستهدف. تنسيق الملف: لاستخدام الجمهور المستهدف التلقائي لمؤسسة Google Workspace، اضبط القيمة على |
AccessState
يمثل حالة الوصول إلى المساحة.
عمليات التعداد | |
---|---|
ACCESS_STATE_UNSPECIFIED |
حالة الوصول غير معروفة أو غير متاحة في واجهة برمجة التطبيقات هذه. |
PRIVATE |
يمكن فقط للمستخدمين أو "مجموعات Google" التي أضافها مستخدمون آخرون أو أرسلوا دعوة إليها بشكل فردي أو مشرفي Google Workspace اكتشاف المساحة والوصول إليها. |
DISCOVERABLE |
منح مدير المساحة جمهورًا مستهدفًا الإذن بالوصول إلى المساحة. يمكن أيضًا للمستخدمين أو "مجموعات Google" الذين تمت إضافتهم أو دعوتهم بشكل فردي إلى المساحة اكتشاف المساحة والوصول إليها. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة جعل مساحة قابلة للاكتشاف من مستخدمين محدّدين. |
PredefinedPermissionSettings
إعدادات أذونات المساحة التي يمكنك تحديدها عند إنشاء مساحة مُعنوَنة ويمكن إضافة المزيد من الإعدادات في المستقبل. للحصول على تفاصيل عن إعدادات الأذونات للمساحات المُعنونة، يُرجى الاطّلاع على مقالة مزيد من المعلومات عن المساحات.
عمليات التعداد | |
---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
غير محدد يُرجى عدم استخدامها. |
COLLABORATION_SPACE |
إعداد لجعل المساحة عبارة عن مساحة تعاونية حيث يمكن لجميع الأعضاء نشر الرسائل |
ANNOUNCEMENT_SPACE |
إعداد لجعل المساحة مساحة إعلانية حيث يمكن فقط لمدراء المساحة نشر الرسائل |
PermissionSettings
إعدادات الأذونات لمساحة مُعنوَنة لضبط إعدادات الأذونات عند إنشاء مساحة، حدِّد الحقل PredefinedPermissionSettings
في طلبك.
تمثيل JSON |
---|
{ "manageMembersAndGroups": { object ( |
الحقول | |
---|---|
manageMembersAndGroups |
إعداد لإدارة الأعضاء والمجموعات في المساحة. |
modifySpaceDetails |
إعداد لتعديل اسم المساحة وصورتها الرمزية ووصفها وإرشاداتها |
toggleHistory |
إعداد للتبديل بين تفعيل سجلّ المساحات وإيقافه. |
useAtMentionAll |
إعداد استخدام @الكل في مساحة |
manageApps |
إعداد لإدارة التطبيقات في مساحة |
manageWebhooks |
إعداد لإدارة الردود التلقائية على الويب في مساحة |
postMessages |
النتائج فقط. خيار لنشر الرسائل في مساحة |
replyMessages |
إعداد للرد على الرسائل في مساحة |
PermissionSetting
يمثّل هذا الإعداد إعدادًا لإذن المساحة.
تمثيل JSON |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
الحقول | |
---|---|
managersAllowed |
ما إذا كان مدراء المساحات لديهم هذا الإذن |
membersAllowed |
ما إذا كان الأعضاء غير الإداريين لديهم هذا الإذن أم لا. |
الطُرق |
|
---|---|
|
تُكمل عملية الاستيراد للمساحة المحدَّدة وتجعلها مرئية للمستخدمين. |
|
يتم إنشاء مساحة بدون أعضاء. |
|
حذف مساحة مُعنوَنة |
|
لعرض الرسالة المباشرة الحالية مع المستخدم المحدّد. |
|
لعرض تفاصيل حول مساحة |
|
يسرد المساحات التي ينتمي إليها المتصل. |
|
يتم تعديل مساحة. |
|
|
|
يتم إنشاء مساحة وإضافة مستخدمين محدّدين إليها. |