Method: users.availability.patch

اطلاعات در دسترس بودن را برای یک کاربر انسانی به‌روزرسانی می‌کند. فقط فیلد customStatus می‌تواند از طریق این متد به‌روزرسانی شود.

این روش فقط در دسترس بودن کاربر احراز هویت شده را به‌روزرسانی می‌کند.

نیاز به احراز هویت کاربر با یکی از حوزه‌های مجوز زیر دارد:

  • https://www.googleapis.com/auth/chat.users.availability

درخواست HTTP

PATCH https://chat.googleapis.com/v1/{availability.name=users/*/availability}

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
availability.name

string

شناسه. نام منبع در دسترس بودن کاربر.

قالب: users/{user}/availability

{user} شناسه‌ی Person در People API یا Admin SDK directory API است. برای مثال، users/123456789 .

آدرس ایمیل کاربر یا me نیز می‌تواند به عنوان نام مستعار برای اشاره به تماس‌گیرنده استفاده شود. برای مثال، users/user@example.com یا users/me .

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

پارامترها
updateMask

string ( FieldMask format)

الزامی. فهرست فیلدهایی که باید به‌روزرسانی شوند. تنها فیلدی که می‌تواند به‌روزرسانی شود، customStatus است.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از Availability است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Availability است.

دامنه‌های مجوز

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

  • https://www.googleapis.com/auth/chat.users.availability

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