קבלת פרטים על מצב הקריאה למרחב המשותף של המשתמש

במדריך הזה מוסבר איך להשתמש בשיטה get() במשאב SpaceReadState של Google Chat API כדי לקבל פרטים על מצב הקריאה של משתמש במרחב משותף. במאמר איך בודקים את סטטוס הקריאה של הודעה בשרשור מוסבר איך לבדוק את סטטוס הקריאה של הודעה בשרשור.

משאב SpaceReadState הוא משאב יחיד שמייצג פרטים על ההודעה האחרונה שקורא משתמש מסוים במרחב משותף ב-Google Chat.

דרישות מוקדמות

Node.js

אחזור סטטוס הקריאה של המשתמש הקורא במרחב המשותף

כדי לקבל פרטים על סטטוס הקריאה של משתמש במרחב משותף, צריך לכלול בבקשה את הפרטים הבאים:

  • מציינים את היקף ההרשאה chat.users.readstate או chat.users.readstate.readonly.
  • קוראים ל-method‏ GetSpaceReadState(), מעבירים את name של מצב הקריאה של המרחב כדי לקבל את ה-get שכולל מזהה משתמש או כינוי ומזהה מרחב משותף. אחזור סטטוס הקריאה של המרחב המשותף תומך רק באחזור סטטוס הקריאה של המשתמש הקורא. אפשר לציין את סטטוס הקריאה באמצעות אחת מהאפשרויות הבאות:
    • הכינוי me. לדוגמה, users/me/spaces/SPACE/spaceReadState.
    • כתובת האימייל של המשתמש שמתקשר ב-Workspace. לדוגמה, users/user@example.com/spaces/SPACE/spaceReadState.
    • מזהה המשתמש של המשתמש הקורא. לדוגמה, users/USER/spaces/SPACE/spaceReadState.

בדוגמה הבאה מוצג סטטוס הקריאה של המרחב המשותף של המשתמש המתקשר:

Node.js

chat/client-libraries/cloud/get-space-read-state-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate.readonly'];

// This sample shows how to get the space read state for the calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState'
  };

  // Make the request
  const response = await chatClient.getSpaceReadState(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

כדי להריץ את הדוגמה הזו, מחליפים את SPACE_NAME במזהה מהמזהה name של המרחב המשותף. אפשר לקבל את המזהה על ידי קריאה ל-method‏ ListSpaces() או מכתובת ה-URL של המרחב המשותף.

‏Google Chat API מקבל את סטטוס הקריאה של המרחב המשותף שצוין ומחזיר מופע של SpaceReadState.