Mỗi ứng dụng Google Chat mà bạn tạo đều yêu cầu một dự án Google Cloud riêng, trong đó Chat API được bật và định cấu hình. Trang này cho bạn biết cách định cấu hình Chat API.
Điều kiện tiên quyết
- Tài khoản Google Workspace dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Tạo dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật API Google Chat.
Chọn tên hiển thị, hình đại diện và nội dung mô tả cho ứng dụng Chat
Khi bật Chat API, bạn sẽ định cấu hình thông tin chi tiết về ứng dụng Chat xuất hiện với người dùng trong Chat, bao gồm tên hiển thị, hình đại diện và nội dung mô tả. Những thông tin này chỉ xuất hiện trong ứng dụng Chat. Để phát hành ứng dụng Chat lên Marketplace, bạn cũng phải chỉ định thông tin chi tiết xuất hiện trong trang thông tin trên Marketplace của ứng dụng Chat.
Để gọi API Chat, bạn phải thiết lập ứng dụng Google Chat bằ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ự chữ và số |
| URL hình đại diện | Hình ảnh hiển thị dưới dạng hình đại diện của ứng dụng Chat. | URL HTTPS trỏ đến một hình ảnh đồ hoạ hình vuông (PNG hoặc JPEG). Kích thước đề xuất là 256 x 256 pixel trở lên. |
| Mô tả | Nội dung mô tả ngắn gọn về 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 sẽ được hiển thị cho người dùng trong giao diện người dùng Chat. Đối với một số yêu cầu ghi API Chat, Chat sử dụng thông tin này để phân bổ các hành động 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 sẽ thêm tên của ứng dụng Chat vào phần mô tả về người đã tạo không gian, như trong hình sau:
spaces.create() được dùng để thay mặt người dùng tạo không gian.
Để tương tác với các ứng dụng Chat, người dùng cũng có thể xem hoặc sử dụng thông tin này theo các cách sau:
- Gọi ứng dụng Chat bằng cách @đề cập tên ứng dụng đó.
- Tìm và bắt đầu một 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 thư, người dùng có thể duyệt qua các ứng dụng Chat và xem tên, hình đại diện và nội dung mô tả của ứng dụng.
Định cấu hình ứng dụng Chat trong Google Cloud Console
Khi bạn có thông tin chi tiết về ứng dụng Chat, hãy mở dự án trên Google Cloud và định cấu hình API Chat:
Trong Google Cloud Console, hãy chuyển đến trang Chat API rồi nhấp vào trang Cấu hình:
Trong mục Thông tin ứng dụng, hãy điền vào các trường Tên ứng dụng, URL hình đại diện và Nội dung mô tả.
Trong phần Tính năng tương tác, hãy nhấp vào nút bật/tắt Bật tính năng tương tác để 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ính năng này sau. Để tìm hiểu về cách định cấu hình và xây dựng các tính năng tương tác, hãy xem bài viết Nhận và phản hồi các lượt tương tác của người dùng.
Không bắt buộc: Trong phần Nhật ký, hãy chọn hộp đánh dấu Ghi lỗi vào Logging để sử dụng Google Cloud Logging. Để biết thêm thông tin, hãy xem phần Truy vấn nhật ký lỗi cho ứng dụng Chat.
Nhấp vào Lưu.
Cấp quyền cho người khác định cấu hình Chat API
Bạn có thể cấp quyền truy cập cho một số người dùng vào trang cấu hình ứng dụng Chat bằng cách cấp cho họ vai trò Quản lý quyền truy cập (IAM) của Google Cloud Identity là Chủ sở hữu ứng dụng Chat hoặc Người xem ứng dụng Chat. Người dùng có các vai trò này không thể chuyển đến trang cấu hình ứng dụng Chat bằng cách sử dụng trang tổng quan API và dịch vụ, nhưng có thể truy cập vào trang cấu hình bằng cách chuyển đến Google Cloud Console cho dự án trên Google Cloud lưu trữ ứng dụng Chat 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 Google Cloud lưu trữ ứng dụng Chat.
Chủ đề có liên quan
- Chọn cấu trúc ứng dụng Chat
- Để định cấu hình ứng dụng Chat cho các tính năng tương tác, hãy xem phần Nhận và phản hồi hoạt động tương tác của người dùng