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 một người dùng:
- Tạo thông báo @ đề 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.
- Lấy 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.
- Đăng ký người dùng bằng API Sự kiện của Google Workspace để nhận các sự kiện về các thay đổi đối với gói thành viên của họ.
Cách Chat xác định người dùng
API Google Chat tạo ra một
Tài nguyên User
cho từng người sử dụng Chat. Sau đây là hai
Trường User
:
name
là tên tài nguyên của tài nguyên, có định dạng làusers/{user}
trong đó{user}
đại diện cho giá trị nhận dạng duy nhất và ổn định.users/app
có thể được dùng làm bí danh của ứng dụng gọi điện trong Chat.type
là loại người dùng. Loại này cho Chat biết liệu người dùng là một ứng dụng Chat hoặc một người. Để Ứng dụng nhắn tin, giá trị làBOT
. Đối với con người, giá trị làHUMAN
.
Chỉ định một người dùng trong lệnh 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 của bạn, 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 dưới dạngpeople/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 dưới dạngusers/123456789
trong API Thư mục.
Đối với người dùng trong tổ chức Google Workspace bên ngoài hoặc người dùng người dùng Tài khoản Google, hãy 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 thông qua một sự kiện tương tác
Mỗi khi người dùng tương tác với một ứng dụng Chat, Chat sẽ gửi sự kiện tương tác có thông tin về tương tác và người dùng. Ví dụ: khi một người dùng đề cập đến ứng dụng Chat trong một tin nhắn, Ứng dụng Chat nhận thông tin về lượt tương tác đó, bao gồm nội dung tin nhắn và người gửi. Ứng dụng trong Chat nhắc đến người dùng khi truy xuất thông tin về các tài nguyên của Chat.
Cách xác định người dùng đã tương tác với ứng dụng Chat:
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ụ JSON sau đây cho thấy định dạng dự kiến của danh tính người dùng trong một hoạt động 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
gửi tin nhắn đến một ứng dụng Chat,
lấy giá trị của thuộc tính name
trên
Tài nguyên User
, sử dụng một trong hai
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 người dùng bằng@ trong tin nhắn.