Method: spaces.patch
تعديل مساحة على سبيل المثال، اطّلِع على مقالة تعديل مساحة.
إذا كنت بصدد تعديل الحقل displayName وظهرت لك رسالة الخطأ ALREADY_EXISTS، جرِّب اسمًا معروضًا مختلفًا. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض.
تتوافق مع أنواع المصادقة التالية:
طلب 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 وفي "المساحات". يتطلب 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-02-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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"]]
