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

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

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

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

Node.js

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

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

  • מציינים את היקף ההרשאה chat.users.readstate או chat.users.readstate.readonly.
  • קוראים ל-method‏ GetSpaceReadState(), מעבירים את name של מצב הקריאה של המרחב כדי לקבל את המאפיינים הבאים: מזהה משתמש או כינוי ותווית של מרחב. אחזור סטטוס הקריאה של המרחב המשותף תומך רק באחזור סטטוס הקריאה של המשתמש הקורא. אפשר לציין את סטטוס הקריאה באמצעות אחת מהאפשרויות הבאות:
    • הכינוי 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.