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

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

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

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

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

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

Node.js

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

כדי למצוא צ'אט אישי ב-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.

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

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

Node.js

chat/client-libraries/cloud/find-dm-space-user-cred.js
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 עם פרטי הצ'אט האישי שצוין.

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

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

Node.js

chat/client-libraries/cloud/find-dm-space-app-cred.js
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 עם פרטי הצ'אט האישי שצוין.