ค้นหาพื้นที่ข้อความส่วนตัว (DM)

คู่มือนี้อธิบายวิธีใช้เมธอด findDirectMessage() ในทรัพยากร Space ของ Google Chat API เพื่อดูรายละเอียดเกี่ยวกับพื้นที่ข้อความส่วนตัว (DM)

Spaceทรัพยากร แสดงถึงสถานที่ที่ผู้ใช้และแอป Chat สามารถส่งข้อความ แชร์ไฟล์ และทำงานร่วมกันได้ โดยมีพื้นที่หลายประเภทดังนี้

  • ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คนหรือผู้ใช้กับแอป Chat
  • แชทกลุ่มคือการสนทนาระหว่างผู้ใช้ตั้งแต่ 3 คนขึ้นไปและแอป Chat
  • พื้นที่ทำงานที่มีชื่อคือพื้นที่ถาวรที่ผู้คนใช้ส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน

เมื่อผู้ดูแลระบบ Google Workspace ติดตั้งแอป Chat ให้ทั้ง องค์กร Google Workspace Google Chat จะสร้างข้อความส่วนตัวระหว่างแอป Chat ที่ติดตั้งกับผู้ใช้แต่ละคนในองค์กร

การตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ของแอป จะช่วยให้แอป Chat รับ DM ที่แอป Chat มีสิทธิ์เข้าถึงใน Google Chat (เช่น DM ที่แอปเป็นสมาชิก) ได้ การตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ผู้ใช้จะแสดง ข้อความส่วนตัวที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์มีสิทธิ์เข้าถึง

ข้อกำหนดเบื้องต้น

Node.js

  • บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat

ค้นหาข้อความส่วนตัว

หากต้องการค้นหาข้อความส่วนตัวใน Google Chat ให้ส่งข้อมูลต่อไปนี้ในคำขอ

  • เมื่อใช้การตรวจสอบสิทธิ์แอป ให้ระบุchat.botขอบเขตการให้สิทธิ์ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ระบุchat.spaces.readonlyหรือchat.spacesขอบเขตการให้สิทธิ์
  • เรียกใช้เมธอด FindDirectMessage() โดยส่ง name ของผู้ใช้รายอื่นใน DM เพื่อส่งคืน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ เมธอดนี้จะแสดง DM ระหว่างผู้ใช้ที่เรียกใช้กับผู้ใช้ที่ระบุ เมื่อใช้ การตรวจสอบสิทธิ์แอป วิธีนี้ จะแสดงข้อความส่วนตัวระหว่างแอปที่เรียกใช้กับผู้ใช้ที่ระบุ
  • หากต้องการเพิ่มผู้ใช้ที่เป็นบุคคลจริงเป็นสมาชิกในพื้นที่ทำงาน ให้ระบุ 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);
}

await main();

หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ USER_NAME ด้วยรหัสจากช่อง ผู้ใช้ name

Chat API จะแสดงอินสแตนซ์ของ Space ซึ่งแสดงรายละเอียดของ DM ที่ระบุ

ค้นหาข้อความส่วนตัวที่มีการตรวจสอบสิทธิ์แอป

วิธีค้นหาข้อความส่วนตัวที่มีการตรวจสอบสิทธิ์ของแอปมีดังนี้

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);
}

await main();

หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ USER_NAME ด้วยรหัสจากช่อง ผู้ใช้ name

Chat API จะแสดงอินสแตนซ์ของ Space ซึ่งแสดงรายละเอียดของ DM ที่ระบุ