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 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ên User trong API Chat, chẳng hạn như users/123456789.
    • {person_id} cho tên của Tài nguyên Person 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ạng people/123456789 trong API Mọi người.
    • id cho tài nguyên User 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ạng users/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ặc users/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: