Định cấu hình API Google Chat

Mỗi ứng dụng Google Chat mà bạn tạo đều yêu cầu ứng dụng riêng Dự án trên Google Cloud đã bật và định cấu hình API Chat. Trang này hướng dẫn bạn cách định cấu hình API Chat.

Điều kiện tiên quyết

Chọn tên hiển thị, hình đại diện và nội dung mô tả cho ứng dụng Chat

Để gọi API Chat, bạn phải thiết lập Ứng dụng Google Chat với những thông tin sau:

Trường Mô tả Định dạng
Tên ứng dụng Tên hiển thị của ứng dụng Chat. Tối đa 25 ký tự bao gồm chữ và số
URL hình đại diện Hình ảnh xuất hiện dưới dạng hình ảnh của ứng dụng Chat hình đại diện. URL HTTPS trỏ đến hình ảnh đồ hoạ vuông (PNG hoặc JPEG). Kích thước đề xuất là từ 256 x 256 pixel trở lên.
Mô tả Một đoạn mô tả ngắn gọn mục đích của Ứng dụng Chat. Tối đa 40 ký tự bao gồm chữ và số

Tên, hình đại diện và nội dung mô tả của ứng dụng Chat hiển thị cho người dùng trong giao diện người dùng Chat. Đối với một số API Chat ghi yêu cầu, Chat sử dụng thông tin này để phân bổ những thao tác mà ứng dụng Chat thực hiện trong Chat.

Ví dụ: nếu bạn gọi phương thức spaces.create(), Chat bao gồm tên của ứng dụng Chat trong nội dung mô tả về người đã tạo không gian, như trong hình sau:

Ứng dụng Google Chat tạo không gian cho người dùng.
Hình 1. Thông báo ghi công mà Chat hiển thị khi phương thức spaces.create() được dùng để tạo một thay mặt cho người dùng.

Để tương tác với các ứng dụng trong Chat, người dùng cũng có thể xem hoặc sử dụng theo các cách sau:

  • Gọi ứng dụng Chat bằng cách đề cập đến tên ứng dụng bằng @.
  • Tìm và bắt đầu tin nhắn trực tiếp bằng ứng dụng Chat. Trong trình đơn Ứng dụng, tin nhắn trực tiếp sẽ hiển thị Tên và hình đại diện của ứng dụng Chat.
  • Trên thanh soạn tin nhắn, người dùng có thể duyệt xem các ứng dụng trong Chat và xem tên, hình đại diện và nội dung mô tả của họ.

Định cấu hình ứng dụng Chat trong bảng điều khiển Google Cloud

Khi bạn có thông tin chi tiết về ứng dụng Chat, hãy mở Dự án trên đám mây và định cấu hình API Chat:

  1. Trong bảng điều khiển Google Cloud, hãy truy cập vào trang API Chat rồi nhấp vào Trang Cấu hình:

    Chuyển đến trang Cấu hình API Chat

  2. Trong Thông tin ứng dụng, điền Tên ứng dụng, URL hình đại diện, và Mô tả.

  3. Trong mục Tính năng tương tác, hãy nhấp vào nút bật/tắt Bật các tính năng tương tác sang vị trí tắt để tắt các tính năng tương tác cho Ứng dụng Chat. Bạn có thể thiết lập tài khoản này sau. Để tìm hiểu về định cấu hình và xây dựng các tính năng tương tác, xem Nhận và trả lời hoạt động tương tác của người dùng.

  4. Không bắt buộc: Trong Logs (Nhật ký), hãy chọn hộp đánh dấu Log lỗi to Logging (Ghi nhật ký vào nhật ký) để sử dụng tính năng Ghi nhật ký Google Cloud. Để biết thêm thông tin, hãy xem Truy vấn nhật ký lỗi của các ứng dụng trong Chat.

  5. Nhấp vào Lưu.

Cấp cho người khác quyền định cấu hình ứng dụng trong Chat

Bạn có thể cấp quyền truy cập cho những người dùng cụ thể chuyển đến trang cấu hình của ứng dụng Chat. Sử dụng Quyền quản lý danh tính và quyền truy cập (IAM) Chủ sở hữu ứng dụng Chat và Người xem ứng dụng Chat vai trò. Người dùng có các vai trò này không thể chuyển đến ứng dụng trong Chat bằng cách sử dụng API & trang tổng quan của Google Services, nhưng có thể truy cập vào trang cấu hình bằng cách chuyển đến bảng điều khiển Google Cloud Dự án trên đám mây của ứng dụng Chat lưu trữ như sau:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Trong đó PROJECT_ID là mã dự án của Dự án trên Google Cloud lưu trữ ứng dụng Chat.