Method: users.spaces.threads.updateThreadReadState

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

به اصالت‌سنجی کاربر با دامنه مجوز نیاز دارد:

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

درخواست HTTP

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

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

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

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

string

نام منبع وضعیت خوانده شدن رشته.

قالب: users/{user}/spaces/{space}/threads/{thread}/threadReadState

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

پارامترها
updateMask

string (FieldMask format)

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

  • lastReadTime

وقتی lastReadTime قبل‌از زمان ایجاد آخرین پیام باشد، رشته در میانای کاربر به‌صورت خوانده‌نشده نشان داده می‌شود.

برای علامت‌گذاری رشته به‌عنوان خوانده‌شده، lastReadTime را روی مُهر زمانی برابر یا بعداز زمان ایجاد آخرین پیام تنظیم کنید. مُهرهای زمان آینده به زمان درخواست فعلی تبدیل می‌شوند. تنظیم مُهر زمان منفی (قبل‌از 1970-01-01T00:00:00Z) خطای INVALID_ARGUMENT را برمی‌گرداند.

متن درخواست

متن درخواست حاوی نمونه‌ای از ThreadReadState است.

بدنه پاسخ

اگر موفقیت‌آمیز باشد، بدنه پاسخ حاوی نمونه‌ای از ThreadReadState است.

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

به گستره OAuth زیر نیاز دارد:

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

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