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

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

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

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

Node.js

איך בודקים את מצב הקריאה של השרשור של המשתמש שמתקשר

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

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

בדוגמה הבאה רואים את מצב הקריאה של השרשור של המשתמש שמתקשר:

Node.js

chat/client-libraries/cloud/get-thread-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 thread read state for a space and 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 and THREAD_NAME here
    name: 'users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState'
  };

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

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

main().catch(console.error);

כדי להריץ את הדוגמה הזו, מחליפים את הפרטים הבאים:

  • SPACE_NAME: המזהה של המרחב המשותף name. אפשר לקבל את המזהה על ידי קריאה ל-method‏ ListSpaces() או מכתובת ה-URL של המרחב המשותף.
  • THREAD_NAME: המזהה מ-name של השרשור. אפשר לקבל את המזהה מגוף התשובה שמוחזר אחרי יצירת אסינכרונית עם ה-API של Chat, או שם מותאם אישית שהוקצה להודעה בזמן היצירה.

Google Chat API מקבל את מצב הקריאה בשרשור שצוין ומחזיר מופע של ThreadReadState