Method: users.spaces.updateSpaceReadState

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

נדרש אימות משתמש.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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

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