ค้นหาพื้นที่ข้อความส่วนตัว (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 ที่แอปเป็นสมาชิกอยู่) การตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ผู้ใช้จะแสดง 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 ที่ระบุ