Method: spaces.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعديل مساحة للاطّلاع على مثال، يُرجى الرجوع إلى مقالة تعديل مساحة.
إذا كنت تعدّل الحقل displayName وظهرت لك رسالة الخطأ ALREADY_EXISTS، جرِّب اسمًا معروضًا مختلفًا. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض.
يتوافق مع الأنواع التالية من المصادقة:
تنطبق القيود التالية على مصادقة التطبيق:
- لتعديل
space.predefined_permission_settings أو space.permission_settings، يجب أن يكون التطبيق هو من أنشأ المساحة.
- لا يمكن تعديل
space.access_settings.audience عند المصادقة باستخدام التطبيق.
طلب HTTP
PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
| المعلمات |
space.name |
string
المعرّف اسم المورد الخاص بالمساحة التنسيق: spaces/{space} حيث يمثّل {space} المعرّف الذي يحدّده النظام للمساحة. يمكنك الحصول على رقم تعريف المساحة من خلال استدعاء الطريقة spaces.list() أو من عنوان URL الخاص بالمساحة. على سبيل المثال، إذا كان عنوان URL للمساحة هو https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA، سيكون رقم تعريف المساحة هو AAAAAAAAA.
|
مَعلمات طلب البحث
| المعلمات |
updateMask |
string (FieldMask format)
مطلوب. مسارات الحقول المعدَّلة، مفصولة بفواصل في حال وجود عدة مسارات يمكنك تعديل الحقول التالية لمساحة: 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.manageMembersAndGroupspermissionSettings.modifySpaceDetailspermissionSettings.toggleHistorypermissionSettings.useAtMentionAllpermissionSettings.manageAppspermissionSettings.manageWebhookspermissionSettings.replyMessages
|
useAdminAccess |
boolean
اختيارية: عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم الذي يجري المكالمة مشرفًا في Google Workspace لديه امتياز إدارة المحادثات ومحادثات المساحات. يتطلّب ذلك chat.admin.spaces نطاق OAuth 2.0. لا تتوفّر بعض قيم FieldMask باستخدام إذن الوصول كمشرف. للحصول على التفاصيل، يُرجى الاطّلاع على وصف updateMask.
|
نص الطلب
يحتوي نص الطلب على مثال Space.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Space.
نطاقات الأذونات
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.admin.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaces
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eUpdates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges.\u003c/p\u003e\n"],["\u003cp\u003eSupports partial updates using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter to specify the fields to be modified.\u003c/p\u003e\n"],["\u003cp\u003eProvides options for using administrator privileges with the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter, but some fields and functionalities are not supported in this mode.\u003c/p\u003e\n"],["\u003cp\u003eUses the PATCH HTTP method and gRPC Transcoding syntax for the request URL.\u003c/p\u003e\n"]]],["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"],null,[]]
