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

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

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

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

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

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

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

חיפוש צ'אט אישי

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

• באימות אפליקציה, מציינים את היקף ההרשאה chat.bot. באימות משתמש, מציינים את היקף ההרשאה chat.spaces.readonly או chat.spaces.
• קוראים ל-method‏ 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 של המשתמש.

ממשק ה-API של Chat מחזיר מופע של 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 של המשתמש.

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

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

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