Method: users.spaces.updateSpaceReadState

وضعیت خواندن کاربر را در یک فضا به روز می کند، که برای شناسایی پیام های خوانده شده و خوانده نشده استفاده می شود. برای مثال، به‌روزرسانی وضعیت خواندن فضای کاربر را ببینید.

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

درخواست HTTP

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

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

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

مولفه های
spaceReadState.name

string

نام منبع وضعیت خواندن فضا.

قالب: users/{user}/spaces/{space}/spaceReadState

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

مولفه های
updateMask

string ( FieldMask format)

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

  • lastReadTime

وقتی lastReadTime قبل از زمان ایجاد آخرین پیام باشد، فضا به صورت خوانده نشده در UI ظاهر می شود.

برای علامت‌گذاری فضا به‌عنوان خوانده‌شده، lastReadTime روی هر مقدار دیرتر (بزرگ‌تر) از زمان ایجاد آخرین پیام تنظیم کنید. lastReadTime مجبور می شود با آخرین زمان ایجاد پیام مطابقت داشته باشد. توجه داشته باشید که وضعیت خواندن فاصله فقط بر وضعیت خواندن پیام‌هایی که در مکالمه سطح بالای فضا قابل مشاهده هستند تأثیر می‌گذارد. پاسخ‌های موجود در رشته‌ها تحت تأثیر این مُهر زمانی قرار نمی‌گیرند، و در عوض به وضعیت خواندن رشته متکی هستند.

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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