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. وتؤدي محاولة تعديل نوع المساحة بطرق أخرى إلى حدوث خطأ غير صالح في الوسيطة).

  • spaceDetails

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

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

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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