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}

معلمات طلب البحث

المعلمات
updateMask

string (FieldMask format)

مطلوبة. مسارات الحقول المعدَّلة، مفصولة بفواصل إذا كانت هناك عدة مسارات.

يمكنك تعديل الحقول التالية للمساحة:

  • spaceDetails

  • displayName: لا يمكن تعديل الاسم المعروض إلا للمساحات التي يكون فيها الحقل spaceType SPACE. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS، جرِّب قيمة مختلفة. قد تستخدم مساحة حالية في مؤسسة Google Workspace هذا الاسم المعروض.

  • spaceType: لا يمكن تغيير نوع المساحة من النوع GROUP_CHAT إلى SPACE إلا. يُرجى تضمين displayName مع spaceType في قناع التحديث والتأكّد من أنّ المساحة المحدّدة لها اسم معروض غير فارغ ونوع المساحة SPACE. إنّ تضمين القناع spaceType والنوع SPACE في المساحة المحدّدة عند تعديل الاسم المعروض هو إجراء اختياري إذا كانت المساحة الحالية من النوع SPACE. تؤدي محاولة تعديل نوع المساحة بطرق أخرى إلى ظهور خطأ وسيطة غير صالح. لا يملك spaceType الإذن بالوصول الإداري.

  • spaceHistoryState: لتعديل إعدادات سجلّ المساحات عن طريق تفعيل السجلّ أو إيقافه للمساحة. لا يتوفّر هذا الخيار إلا إذا كانت إعدادات السجلّ مفعَّلة لمؤسسة Google Workspace. لتعديل حالة سجلّ المساحات، عليك حذف جميع أقنعة الحقول الأخرى في طلبك. لا يملك spaceHistoryState الإذن بالوصول الإداري.

  • accessSettings.audience: يعدِّل إعدادات الوصول للمستخدمين الذين يمكنهم اكتشاف المساحة والانضمام إلى المساحة ومعاينة الرسائل في المساحة المُعنوَنة حيث يكون الحقل spaceType SPACE. إذا كانت المساحة الحالية تضم جمهورًا مستهدفًا، يمكنك إزالة الجمهور وتقييد الوصول إلى المساحة من خلال حذف قيمة لقناع الحقل هذا. لتعديل إعدادات الوصول إلى مساحة معيّنة، يجب أن يكون المستخدم الذي يتولى المصادقة هو مدير مساحة وأن يحذف جميع أقنعة الحقول الأخرى في طلبك. لا يمكنك تعديل هذا الحقل إذا كانت المساحة في وضع الاستيراد. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة جعل مساحة قابلة للاكتشاف من مستخدمين محدّدين. لا يملك accessSettings.audience الإذن بالوصول الإداري.

  • معاينة المطوّر: تتيح تغيير إعدادات الأذونات الخاصة بالمساحة. تتضمّن مسارات الحقول المتاحة ما يلي: permissionSettings.manage_members_and_groups وpermissionSettings.modify_space_details وpermissionSettings.toggle_history وpermissionSettings.use_at_mention_all وpermissionSettings.manage_apps وpermissionSettings.manage_webhooks وpermissionSettings.reply_messages (تحذير: لا يمكن استخدام هذه المسارات مع جميع المسارات الأخرى التي لا تسمح بإعدادات الأذونات). لا يملك permissionSettings الإذن بالوصول الإداري.
useAdminAccess

boolean

عند true، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم.

يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات".

يتطلب نطاق OAuth 2.0 chat.admin.spaces.

بعض قيم FieldMask غير متاحة عند استخدام إذن وصول إداري. لمعرفة التفاصيل، يُرجى الاطّلاع على وصف "updateMask".

نص الطلب

يحتوي نص الطلب على مثال Space.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Space.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

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