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

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

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

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

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

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

Node.js

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

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

หากต้องการค้นหาข้อความส่วนตัวใน 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);
}

main().catch(console.error);

หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ 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);
}

main().catch(console.error);

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

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