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 باشد، فضای مشخص شده هنگام به‌روزرسانی نام نمایشی اختیاری است. تلاش برای به‌روزرسانی نوع فاصله به روش‌های دیگر منجر به خطای آرگومان نامعتبر می‌شود.

  • spaceDetails

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

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

درخواست بدن

بدنه درخواست حاوی نمونه ای از Space است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Space است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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

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