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

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

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

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

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

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

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

Node.js

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

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

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