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)

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

مسارات الحقول المتوافقة حاليًا:

  • displayName (تتيح فقط تغيير الاسم المعروض لمساحة من النوع SPACE، أو عند تضمين القناع spaceType أيضًا لتغيير نوع مساحة GROUP_CHAT إلى SPACE. تؤدي محاولة تعديل الاسم المعروض لمساحة GROUP_CHAT أو DIRECT_MESSAGE إلى حدوث خطأ في الوسيطة غير صالح. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS عند تحديث displayName، جرِّب استخدام displayName آخر. مساحة حالية ضمن مؤسسة Google Workspace يمكن أن تستخدم هذا الاسم المعروض).

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

  • spaceDetails

  • spaceHistoryState (تتيح تفعيل السجلّ أو إيقافه للمساحة في حال تسمح المؤسسة للمستخدمين بتغيير إعداد السجلّ. تحذير: حصرية مع جميع مسارات الحقول الأخرى). لا يملك spaceHistoryState الإذن بالوصول الإداري.

  • معاينة المطوّر: accessSettings.audience (تتيح تغيير إعدادات الوصول الخاصة بالمساحة. إذا لم يتم تحديد أي جمهور في إعداد الوصول، سيتم تعديل إعداد الوصول إلى المساحة إلى "محدود". تحذير: حصرية مع جميع مسارات الحقول الأخرى). لا يملك 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

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