הפונקציה מחזירה פרטים על מצב הקריאה של המשתמש בשרשור, ומשמשת לזיהוי הודעות שנקראו והודעות שלא נקראו. דוגמה לכך מופיעה במאמר איך מקבלים פרטים על מצב הקריאה של משתמש בשרשור.
נדרש אימות משתמש עם אחד מהיקפי ההרשאה הבאים:
https://www.googleapis.com/auth/chat.users.readstate.readonlyhttps://www.googleapis.com/auth/chat.users.readstate
בקשת HTTP
GET https://chat.googleapis.com/v1/{name=users/*/spaces/*/threads/*/threadReadState}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
name |
חובה. שם המשאב של מצב הקריאה של השרשור שרוצים לאחזר. התכונה תומכת רק בקבלת סטטוס הקריאה של המשתמש הקורא. כדי להפנות למשתמש הקורא, מגדירים את אחת מהאפשרויות הבאות:
פורמט: users/{user}/spaces/{space}/threads/{thread}/threadReadState |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של ThreadReadState.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/chat.users.readstatehttps://www.googleapis.com/auth/chat.users.readstate.readonly
מידע נוסף זמין במדריך ההרשאות.