Method: spaces.patch

یک فضا را به روز می کند. برای مثال، به‌روزرسانی یک فاصله را ببینید.

اگر فیلد displayName به‌روزرسانی می‌کنید و پیام خطای ALREADY_EXISTS را دریافت می‌کنید، نام نمایشی دیگری را امتحان کنید. ممکن است فضای موجود در سازمان Google Workspace قبلاً از این نام نمایشی استفاده کند.

نیاز به احراز هویت کاربر دارد.

درخواست HTTP

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
space.name

string

نام منبع فضا

قالب: spaces/{space}

پارامترهای پرس و جو

مولفه های
updateMask

string ( FieldMask format)

ضروری. مسیرهای فیلد به روز شده، در صورت وجود چندین با کاما از هم جدا می شوند.

می توانید فیلدهای زیر را برای یک فاصله به روز کنید:

  • spaceDetails

  • displayName : فقط از به روز رسانی نام نمایشی برای فضاهایی که قسمت spaceType SPACE است پشتیبانی می کند. اگر پیام خطای ALREADY_EXISTS را دریافت کردید، مقدار دیگری را امتحان کنید. فضای موجود در سازمان Google Workspace ممکن است از قبل از این نام نمایشی استفاده کند.

  • spaceType : فقط از تغییر نوع فضای GROUP_CHAT به SPACE پشتیبانی می کند. displayName همراه با spaceType در ماسک به‌روزرسانی قرار دهید و اطمینان حاصل کنید که فضای مشخص شده دارای یک نام نمایشی غیرخالی و نوع فضای SPACE باشد. اگر فضای موجود از قبل دارای نوع SPACE باشد، قرار دادن ماسک spaceType و نوع 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.manage_webhooks permissionSettings.use_at_mention_all permissionSettings.manage_apps permissionSettings.reply_messages هشدار: متقابل با تمام مسیرهای فیلد تنظیمات بدون مجوز). permissionSettings با دسترسی ادمین پشتیبانی نمی شود.

useAdminAccess

boolean

وقتی true ، روش با استفاده از امتیازات سرپرست Google Workspace کاربر اجرا می‌شود.

کاربر تماس گیرنده باید یک سرپرست Google Workspace با امتیاز مدیریت چت و مکالمات فضاها باشد.

به محدوده chat.admin.spaces OAuth 2.0 نیاز دارد.

برخی از مقادیر 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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.