Method: spaces.findDirectMessage

Trả về tin nhắn trực tiếp hiện có với người dùng đã chỉ định. Nếu không tìm thấy không gian tin nhắn trực tiếp, hãy trả về lỗi 404 NOT_FOUND. Để biết ví dụ, hãy xem phần Tìm tin nhắn trực tiếp.

Với quy trình xác thực ứng dụng, trả về không gian tin nhắn trực tiếp giữa người dùng được chỉ định và ứng dụng Chat đang gọi.

Với quy trình xác thực người dùng, trả về không gian tin nhắn trực tiếp giữa người dùng được chỉ định và người dùng đã xác thực.

Hỗ trợ các loại xác thực sau:

  • Xác thực ứng dụng bằng phạm vi uỷ quyền:

    • https://www.googleapis.com/auth/chat.bot

  • Xác thực người dùng bằng một trong các phạm vi uỷ quyền sau:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces

Yêu cầu HTTP

GET https://chat.googleapis.com/v1/spaces:findDirectMessage

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
name

string

Bắt buộc. Tên tài nguyên của người dùng để tìm tin nhắn trực tiếp.

Định dạng: users/{user}, trong đó {user} là id cho người trong API People hoặc id cho người dùng trong API Directory. Ví dụ: nếu mã hồ sơ API People là 123456789, bạn có thể tìm thấy tin nhắn trực tiếp với người đó bằng cách sử dụng users/123456789 làm name. Khi xác thực là người dùng, bạn có thể sử dụng email làm bí danh cho {user}. Ví dụ: users/example@gmail.com, trong đó example@gmail.com là email của người dùng Google Chat.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Space.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.