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.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.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.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.