איך מחפשים צ'אטים אישיים (DM)

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

Spaceמשאב מייצג מקום שבו אנשים ואפליקציות ל-Chat יכולים לשלוח הודעות, לשתף קבצים ולשתף פעולה. יש כמה סוגים של מרחבים:

• צ'אטים ישירים הם שיחות בין שני משתמשים או בין משתמש לבין אפליקציית Chat.
• צ'אטים קבוצתיים הם שיחות בין שלושה משתמשים או יותר לבין אפליקציות ל-Chat.
• מרחבים משותפים עם שם הם מקומות קבועים שבהם אנשים יכולים לשלוח הודעות, לשתף קבצים ולעבוד יחד.

כשמשתמש עם הרשאות אדמין ב-Google Workspace מתקין אפליקציית Chat לכל הארגון שלו ב-Google Workspace, מערכת Google Chat יוצרת צ'אט ישיר בין אפליקציית Chat המותקנת לבין כל משתמש בארגון.

אימות באמצעות אימות אפליקציות מאפשר לאפליקציית Chat לקבל צ'אטים ישירים שאפליקציית Chat יכולה לגשת אליהם ב-Google Chat (לדוגמה, צ'אטים ישירים שהיא חברה בהם). אימות באמצעות אימות משתמשים מחזיר הודעות בצ'אט ישיר שהמשתמש המאומת יכול לגשת אליהן.

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

איך מחפשים צ'אטים ישירים

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

• באימות אפליקציות, צריך לציין את chat.bot היקף ההרשאה. באימות משתמשים, מציינים את היקף ההרשאה chat.spaces.readonly או chat.spaces.
• מתקשרים לשיטה FindDirectMessage(), ומעבירים את name של המשתמש השני בהודעה הישירה כדי להחזיר את ההודעה. עם אימות משתמש, השיטה הזו מחזירה הודעה ישירה בין המשתמש שקורא לשיטה לבין המשתמש שצוין. באמצעות אימות אפליקציות, השיטה הזו מחזירה הודעה ישירה בין האפליקציה הקוראת לבין המשתמש שצוין.
• כדי להוסיף משתמש אנושי כחבר במרחב, מציינים את users/{user}, כאשר {user} הוא {person_id} של person מ-People API, או המזהה של user ב-Directory API. לדוגמה, אם האדם ב-People API‏ resourceName הוא people/123456789, אפשר להוסיף את המשתמש למרחב על ידי הוספת חברות עם users/123456789 בתור member.name.

חיפוש צ'אט ישיר עם אימות משתמש

כך מוצאים צ'אט ישיר עם אימות משתמש:

import {createClientWithUserCredentials} from './authentication-utils.js';

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

// This sample shows how to find a Direct Message space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME'
  };

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

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

main().catch(console.error);

כדי להריץ את הדוגמה הזו, מחליפים את USER_NAME במזהה מהשדה name של המשתמש.

ממשק Chat API מחזיר מופע של Space עם פרטים על הצ'אט הישיר שצוין.

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

כך מוצאים צ'אט ישיר עם אימות אפליקציה:

import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to find a Direct Message space with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME'
  };

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

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

main().catch(console.error);

כדי להריץ את הדוגמה הזו, מחליפים את USER_NAME במזהה מהשדה name של המשתמש.

ממשק Chat API מחזיר מופע של Space עם פרטים על הצ'אט הישיר שצוין.

נושאים קשורים

• איך יוצרים מרחבים
• איך יוצרים מרחבים
• איך מקבלים פרטים על מרחב
• רשימת מרחבים.
• עדכון מרחב.
• מחיקת מרחבים