Method: users.spaces.updateSpaceReadState

עדכון מצב הקריאה של משתמש במרחב משותף, כדי לזהות הודעות שנקראו והודעות שעדיין לא נקראו. דוגמה לכך מופיעה במאמר עדכון סטטוס הקריאה של משתמש במרחב משותף.

נדרש אימות משתמש עם היקף ההרשאה:

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

בקשת HTTP

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

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

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

פרמטרים
spaceReadState.name

string

שם המשאב של מצב הקריאה של המרחב המשותף.

פורמט: users/{user}/spaces/{space}/spaceReadState

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

חובה. נתיבי השדות שרוצים לעדכן. נכון לעכשיו, אלה נתיבי השדות הנתמכים:

  • lastReadTime

אם הערך של lastReadTime נמוך מהשעה שבה נוצרה ההודעה האחרונה, המרחב המשותף יופיע כ'לא נקרא' בממשק המשתמש.

כדי לסמן את המרחב המשותף כנקרא, מגדירים את lastReadTime לערך מאוחר יותר (גדול יותר) מהשעה שבה נוצרה ההודעה האחרונה. הערך של lastReadTime מחויב להתאים לשעת היצירה של ההודעה האחרונה. חשוב לזכור שמצב הקריאה במרחב המשותף משפיע רק על מצב הקריאה של הודעות שגלויות בשיחה ברמה העליונה של המרחב המשותף. תשובות בשרשורים לא מושפעות מחותמת הזמן הזו, אלא מסתמכות על מצב הקריאה של השרשור.

גוף הבקשה

גוף הבקשה מכיל מופע של SpaceReadState.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של SpaceReadState.

היקפי הרשאה

נדרשת הרשאת OAuth ברמת ההיקף הבאה:

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

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