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

لمزيد من المعلومات، راجِع دليل التفويض.