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}

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
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

מידע נוסף זמין במדריך ההרשאות.