Xác định và chỉ định người dùng Google Chat

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:

Cách Chat xác định người dùng

API Google Chat tạo một tài nguyên User cho mỗi người 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ạng là users/{user}, trong đó {user} biểu thị một giá trị nhận dạng duy nhất và ổn định. Bạn có thể sử dụng users/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 liệu người dùng là một ứng dụng Chat hay một người. Đối với ứng dụng Chat, giá trị là BOT. Đối với người dùng, giá trị này là HUMAN.

Chỉ định người dùng trong lệnh gọi đến API Google Chat

Để chỉ định 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ên User trong API Chat, chẳng hạn như users/123456789.
    • {person_id} cho tên của một tài nguyên Person trong API People, trong đó resourceName là people/{person_id}. Ví dụ: users/123456789 trong API Chat đại diện cho cùng một người với people/123456789 trong API People.
    • id cho tài nguyên User trong Directory API – ví dụ: users/123456789 trong Chat API đại diện cho cùng một người với users/123456789 trong Directory API.

  • Đối với người dùng trong 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 bí danh email, ví dụ: users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com hoặc users/EMAIL_USERNAME@gmail.com.

Xác định người dùng từ một sự kiện tương tác

Mỗi khi người dùng tương tác với ứng dụng Chat, Chat sẽ gửi một sự kiện tương tác có thông tin về lượt 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 Chat sẽ nhận được thông tin về lượt tương tác, bao gồm cả nội dung tin nhắn và người gửi. Ứng dụng Chat tham chiếu người dùng khi truy xuất thông tin về tài nguyên của Chat.

Để xác định người dùng đã tương tác với ứng dụng 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ụ JSON sau đây cho thấy định dạng dự kiến của danh tính người dùng trong một lượt 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 một ứng dụng 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 cách sau: