Tìm không gian cho tin nhắn trực tiếp (DM)

Hướng dẫn này giải thích cách sử dụng phương thức findDirectMessage() trên tài nguyên Space của API Google Chat để biết thông tin chi tiết về không gian tin nhắn trực tiếp (DM).

Tài nguyên Space đại diện cho một nơi mà mọi người và ứng dụng Chat có thể gửi tin nhắn, chia sẻ tệp và cộng tác. Có một số loại không gian:

  • Tin nhắn trực tiếp (DM) là các cuộc trò chuyện giữa hai người dùng hoặc một người dùng và một ứng dụng trong Chat.
  • Cuộc trò chuyện nhóm là cuộc trò chuyện giữa 3 người dùng trở lên và ứng dụng Chat.
  • Không gian được đặt tên là những không gian ổn định, nơi mọi người gửi tin nhắn, chia sẻ tệp và cộng tác.

Việc xác thực bằng tính năng xác thực ứng dụng cho phép ứng dụng Chat nhận được tin nhắn trực tiếp mà ứng dụng Chat có quyền truy cập trong Google Chat (ví dụ: Tin nhắn trực tiếp mà ứng dụng này là thành viên). Thao tác xác thực bằng quy trình xác thực người dùng sẽ trả về những tin nhắn trực tiếp mà người dùng đã xác thực có quyền truy cập.

Điều kiện tiên quyết

Node.js

Tìm tin nhắn trực tiếp

Để tìm tin nhắn trực tiếp trong Google Chat, hãy truyền những thông tin sau vào yêu cầu của bạn:

  • Với tính năng xác thực ứng dụng, hãy chỉ định phạm vi uỷ quyền chat.bot. Với tính năng xác thực người dùng, hãy chỉ định phạm vi uỷ quyền chat.spaces.readonly hoặc chat.spaces.
  • Gọi phương thức FindDirectMessage(), truyền name của người dùng khác trong tin nhắn trực tiếp để trả về. Với tính năng xác thực người dùng, phương thức này sẽ trả về một tin nhắn trực tiếp giữa người dùng gọi và người dùng được chỉ định. Với tính năng xác thực ứng dụng, phương thức này sẽ trả về một tin nhắn trực tiếp giữa ứng dụng gọi và người dùng được chỉ định.
  • Để thêm người dùng là con người làm thành viên không gian, hãy chỉ định users/{user}, trong đó {user} là {person_id} cho person từ API People hoặc mã nhận dạng của user trong API Directory. Ví dụ: nếu người dùng API People resourceName là people/123456789, bạn có thể thêm người dùng đó vào không gian bằng cách thêm gói thành viên có users/123456789 làm member.name.

Tìm tin nhắn trực tiếp bằng quy trình xác thực người dùng

Sau đây là cách tìm tin nhắn trực tiếp có quy trình xác thực người dùng:

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

Để chạy mẫu này, hãy thay thế USER_NAME bằng mã nhận dạng trong trường name của người dùng.

Chat API trả về một thực thể của Space nêu chi tiết về tin nhắn trực tiếp đã chỉ định.

Tìm tin nhắn trực tiếp có xác thực ứng dụng

Sau đây là cách tìm tin nhắn trực tiếp bằng tính năng xác thực ứng dụng:

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

Để chạy mẫu này, hãy thay thế USER_NAME bằng mã nhận dạng trong trường name của người dùng.

Chat API trả về một thực thể của Space nêu chi tiết về tin nhắn trực tiếp đã chỉ định.