Method: users.spaces.getSpaceReadState

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

נדרש אימות משתמש עם אחד מהיקפי ההרשאה הבאים:

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

בקשת HTTP

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

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

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

פרמטרים
name

string

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

התכונה תומכת רק בקבלת סטטוס הקריאה של המשתמש הקורא.

כדי להפנות למשתמש הקורא, מגדירים את אחת מהאפשרויות הבאות:

  • הכינוי me. לדוגמה, users/me/spaces/{space}/spaceReadState.

  • כתובת האימייל שלהם ב-Workspace. לדוגמה, users/[email protected]/spaces/{space}/spaceReadState.

  • מזהה המשתמש שלהם. לדוגמה, users/123456789/spaces/{space}/spaceReadState.

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

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