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
- Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.
- Tạo một 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
Để 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.](https://developers-dot-devsite-v2-prod.appspot.com/static/workspace/chat/images/auth-user-create-space.png?authuser=19&hl=vi)
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:
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:
Trong Thông tin ứng dụng, điền Tên ứng dụng, URL hình đại diện, và Mô tả.
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.
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.
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 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.
Chủ đề có liên quan
- Chọn một cấu trúc ứng dụng Chat
- Cách định cấu hình ứng dụng Chat cho các tính năng tương tác: xem Nhận và trả lời tương tác của người dùng