Method: spaces.patch

يعدّل هذا الطلب مساحة. للاطّلاع على مثال، يُرجى مراجعة مقالة تعديل مساحة.

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

تتوفّر الأنواع التالية من المصادقة:

  • مصادقة التطبيق بموافقة المشرف وأحد نطاقات الأذونات التالية:

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

  • مصادقة المستخدم مع أحد نطاقات الأذونات التالية:

    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (مساحات وضع الاستيراد فقط)
    • تمنح مصادقة المستخدم امتيازات المشرف عندما تتم مصادقة حساب مشرف، وتكون قيمة useAdminAccess هي true، ويتم استخدام نطاقات الأذونات التالية:
      • https://www.googleapis.com/auth/chat.admin.spaces

تخضع مصادقة التطبيق للقيود التالية:

  • لتعديل space.predefined_permission_settings أو space.permission_settings، يجب أن يكون التطبيق هو منشئ المساحة.
  • لا يمكن تعديل space.access_settings.audience في مصادقة التطبيق.

طلب 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: تعدّل وصف المساحة وإرشاداتها. يجب تمرير كل من الوصف والإرشادات في طلب التعديل على شكل SpaceDetails. إذا أردت تعديل أحد الحقلَين فقط، مرِّر القيمة الحالية للحقل الآخر.

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.

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

  • accessSettings.access_permission_settings.discoverSpaceSetting
  • accessSettings.access_permission_settings.joinSpaceSetting

permissionSettings: تتيح تغيير إعدادات الأذونات لمساحة. عند تعديل إعدادات الأذونات، لا يمكنك تحديد سوى أقنعة الحقول permissionSettings، ولا يمكنك تعديل أقنعة الحقول الأخرى في الوقت نفسه. تتضمّن أقنعة الحقول المتوافقة ما يلي:

  • 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

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