Trang này giải thích cách các ứng dụng Google Chat có thể xác định hoặc chỉ định người dùng Chat.
Để thực hiện bất kỳ thao tác nào sau đây, ứng dụng Chat phải chỉ định người dùng:
- Tạo một thông báo mà @ đề cập đến một người dùng.
- Mời hoặc thêm người dùng vào không gian hiện có hoặc thêm người dùng vào không gian mới.
- Tìm tin nhắn trực tiếp giữa ứng dụng Chat và một người dùng cụ thể hoặc giữa hai người dùng.
- Xem thông tin chi tiết về gói thành viên của người dùng trong một không gian.
- Gửi tin nhắn riêng tư cho người dùng.
Cách Chat nhận dạng người dùng
API Google Chat tạo ra một tài nguyên User
cho mỗi người sử dụng Chat. Sau đây là hai trường User
quan trọng:
name
là tên tài nguyên cho tài nguyên có định dạngusers/{user}
, trong đó{user}
biểu thị một giá trị nhận dạng duy nhất và ổn định. Bạn có thể dùngusers/app
làm bí danh cho ứng dụng Chat gọi.type
là loại người dùng. Loại này cho Chat biết người dùng là ứng dụng Chat hay người dùng. Đối với các ứng dụng trong Chat, giá trị làBOT
. Đối với con người, giá trị làHUMAN
.
Chỉ định người dùng trong cuộc gọi đến API Google Chat
Để chỉ định một người dùng, hãy sử dụng các giá trị sau cho giá trị {user}
:
Đối với người dùng trong tổ chức Google Workspace, hãy sử dụng một trong các phương pháp sau:
name
của tài nguyênUser
trong API Chat, chẳng hạn nhưusers/123456789
.{person_id}
cho tên của tài nguyênPerson
trong API Mọi người, trong đóresourceName
làpeople/{person_id}
. Ví dụ:users/123456789
trong API Chat đại diện cho cùng một người nhưpeople/123456789
trong API Mọi người.id
cho tài nguyênUser
trong API Thư mục – ví dụ:users/123456789
trong API Chat đại diện cho cùng một người vớiusers/123456789
trong API Thư mục.
Đối với người dùng thuộc một tổ chức Google Workspace bên ngoài hoặc người dùng sử dụng Tài khoản Google, hãy sử dụng email đại diện — ví dụ:
users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com
hoặcusers/EMAIL_USERNAME@gmail.com
.
Xác định người dùng từ một sự kiện tương tác
Mỗi khi một người dùng tương tác với một ứng dụng Chat, Chat sẽ gửi một sự kiện tương tác kèm theo thông tin về hoạt động tương tác đó và người dùng. Ví dụ: khi người dùng đề cập đến một ứng dụng Chat trong tin nhắn, ứng dụng nhắn tin đó sẽ nhận được thông tin về hoạt động tương tác, bao gồm cả nội dung và người gửi tin nhắn. Ứng dụng trong Chat tham chiếu đến người dùng khi truy xuất thông tin về tài nguyên trong Chat.
Để xác định người dùng đã tương tác với ứng dụng trong Chat, hãy lấy giá trị của thuộc tính name
trên tài nguyên User
mà bạn có thể lấy từ Event.user.name
.
Ví dụ về JSON sau đây cho thấy định dạng dự kiến của danh tính người dùng khi tương tác với ứng dụng Chat:
{
...,
"user": {
"name": "users/12345678901234567890",
"displayName": "Sasha",
"avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
"email": "sasha@example.com"
}
}
Tin nhắn là một loại tương tác cụ thể. Để xác định người dùng đã gửi tin nhắn đến ứng dụng trong Chat, hãy lấy giá trị của thuộc tính name
trên tài nguyên User
bằng cách sử dụng một trong các tham số sau:
Chủ đề có liên quan
- Thêm người dùng vào không gian.
- Quản lý thành viên trong không gian.
- đề cập đến một người dùng bằng@ trong tin nhắn.