تعديل مساحة للاطّلاع على مثال، يُرجى الرجوع إلى مقالة تعديل مساحة.
إذا كنت تعدّل الحقل displayName وظهرت لك رسالة الخطأ ALREADY_EXISTS، جرِّب اسمًا معروضًا مختلفًا. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض.
حيث يمثّل {space} المعرّف الذي يحدّده النظام للمساحة. يمكنك الحصول على رقم تعريف المساحة من خلال استدعاء الطريقة spaces.list() أو من عنوان URL الخاص بالمساحة. على سبيل المثال، إذا كان عنوان URL للمساحة هو https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA، سيكون رقم تعريف المساحة هو AAAAAAAAA.
مطلوب. مسارات الحقول المعدَّلة، مفصولة بفواصل في حال وجود عدة مسارات
يمكنك تعديل الحقول التالية لمساحة:
spaceDetails: تعديل وصف المساحة يمكن أن يتضمّن ما يصل إلى 150 حرفًا.
displayName: لا يتيح تعديل الاسم المعروض إلا للمساحات التي يكون فيها الحقل spaceType هو SPACE. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS، جرِّب استخدام قيمة مختلفة. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض.
spaceType: لا يتيح سوى تغيير نوع المساحة من GROUP_CHAT إلى SPACE. أدرِج displayName مع spaceType في قناع التعديل وتأكَّد من أنّ المساحة المحدّدة لها اسم معروض غير فارغ ونوع المساحة SPACE. إنّ تضمين القناع spaceType والنوع SPACE في المساحة المحدّدة عند تعديل الاسم المعروض هو أمر اختياري إذا كانت المساحة الحالية تتضمّن النوع SPACE. محاولة تعديل نوع المساحة بطرق أخرى تؤدي إلى ظهور خطأ في الوسيطة غير صالحة. لا يمكن استخدام spaceType مع useAdminAccess.
spaceHistoryState: تعديل إعدادات سجلّ المساحة من خلال تفعيل السجلّ أو إيقافه للمساحة لا تتوفّر إلا إذا كانت إعدادات السجلّ مفعّلة لمؤسسة Google Workspace. لتعديل حالة سجلّ المساحة، يجب حذف جميع أقنعة الحقول الأخرى في طلبك. لا يمكن استخدام spaceHistoryState مع useAdminAccess.
accessSettings.audience: تعدّل إعدادات الوصول إلى المساحة، أي من يمكنه العثور على المساحة والانضمام إليها ومعاينة الرسائل فيها، وذلك في المساحة المسماة حيث يكون الحقل spaceType هو SPACE. إذا كانت المساحة الحالية تتضمّن جمهورًا مستهدفًا، يمكنك إزالة الجمهور وتقييد الوصول إلى المساحة عن طريق حذف قيمة قناع الحقل هذا. لتعديل إعدادات الوصول إلى مساحة ما، يجب أن يكون المستخدم الذي يصادق على الطلب مدير مساحة، ويجب حذف جميع أقنعة الحقول الأخرى في طلبك. لا يمكنك تعديل هذا الحقل إذا كانت المساحة في وضع الاستيراد. لمزيد من المعلومات، يُرجى الاطّلاع على إتاحة مساحة لمستخدمين محدّدين. لا يمكن استخدام accessSettings.audience مع useAdminAccess.
permissionSettings: تتيح تغيير إعدادات الأذونات لمساحة. عند تعديل إعدادات الأذونات، يمكنك تحديد أقنعة الحقول permissionSettings فقط، ولا يمكنك تعديل أقنعة الحقول الأخرى في الوقت نفسه. لا يمكن استخدام permissionSettings مع useAdminAccess. تشمل أقنعة الحقول المتوافقة ما يلي:
permissionSettings.manageMembersAndGroups
permissionSettings.modifySpaceDetails
permissionSettings.toggleHistory
permissionSettings.useAtMentionAll
permissionSettings.manageApps
permissionSettings.manageWebhooks
permissionSettings.replyMessages
useAdminAccess
boolean
اختيارية: عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم.
تاريخ التعديل الأخير: 2025-07-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Updates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings."],["Requires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges."],["Supports partial updates using the `updateMask` query parameter to specify the fields to be modified."],["Provides options for using administrator privileges with the `useAdminAccess` query parameter, but some fields and functionalities are not supported in this mode."],["Uses the PATCH HTTP method and gRPC Transcoding syntax for the request URL."]]],["This content describes how to update a space within Google Workspace Chat via the API. Key actions include sending a `PATCH` request to `https://chat.googleapis.com/v1/{space.name=spaces/*}`, specifying the space's name in the path. The `updateMask` query parameter defines which fields to update, including space details, display name, type, history state, access and permissions. `useAdminAccess` allow to update the space with administrator permissions. Authentication requires specific OAuth scopes. The request and response body use the `Space` object.\n"]]
