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)

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

مسیرهای فیلد پشتیبانی شده در حال حاضر:

  • displayName (فقط از تغییر نام نمایشی یک فاصله با نوع SPACE پشتیبانی می کند، یا زمانی که ماسک spaceType را نیز برای تغییر نوع فضای GROUP_CHAT به SPACE درج می کند. تلاش برای به روز رسانی نام نمایشی یک فضای GROUP_CHAT یا DIRECT_MESSAGE منجر به یک آرگومان نامعتبر می شود. خطا اگر هنگام به‌روزرسانی displayName ، پیام خطای ALREADY_EXISTS دریافت کردید displayName ممکن است یک فضای موجود در سازمان Google Workspace از این نام نمایشی استفاده کند.

  • spaceType (فقط از تغییر نوع فضای GROUP_CHAT به SPACE پشتیبانی می‌کند. displayName همراه با spaceType در ماسک به‌روزرسانی قرار دهید و اطمینان حاصل کنید که فضای مشخص شده دارای یک نام نمایشی غیرخالی و نوع فضای SPACE است. از جمله spaceType mask و نوع SPACE در قسمت فضای مشخص شده هنگام به روز رسانی نام نمایشی اختیاری است اگر فضای موجود از قبل دارای نوع SPACE باشد. spaceType با دسترسی ادمین پشتیبانی نمی شود.

  • spaceDetails

  • spaceHistoryState (در صورتی که سازمان به کاربران اجازه دهد تنظیمات تاریخچه خود را تغییر دهند، از روشن یا خاموش کردن تاریخچه برای فضا پشتیبانی می کند. اخطار: با همه مسیرهای فیلد دیگر منحصر به فرد است.) spaceHistoryState با دسترسی سرپرست پشتیبانی نمی شود.

  • پیش‌نمایش برنامه‌نویس: accessSettings.audience (از تغییر تنظیمات دسترسی یک فضا پشتیبانی می‌کند. اگر هیچ مخاطبی در تنظیمات دسترسی مشخص نشده باشد، تنظیمات دسترسی فضا به محدود به‌روزرسانی می‌شود. اخطار: با همه مسیرهای فیلد دیگر انحصاری متقابل است.) 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

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