Trang này giải thích cách tạo một ứng dụng Chat bằng Pub/Sub. Loại cấu trúc này cho ứng dụng Chat rất hữu ích nếu tổ chức của bạn có tường lửa. Tường lửa có thể ngăn Chat gửi tin nhắn đến ứng dụng Chat của bạn hoặc nếu ứng dụng Chat sử dụng Google Workspace Events API. Tuy nhiên, cấu trúc này có những hạn chế sau đây do các ứng dụng Chat này chỉ có thể gửi và nhận tin nhắn không đồng bộ:
- Không thể sử dụng hộp thoại trong tin nhắn. Thay vào đó, hãy sử dụng thông báo dạng thẻ.
- Không thể cập nhật các thẻ riêng lẻ bằng một phản hồi đồng bộ. Thay vào đó, hãy cập nhật toàn bộ thông báo bằng cách gọi phương thức
patch
.
Sơ đồ sau đây cho thấy cấu trúc của một ứng dụng trò chuyện được xây dựng bằng Pub/Sub:
Trong sơ đồ trước đó, một người dùng tương tác với ứng dụng Pub/Sub Chat có luồng thông tin như sau:
Người dùng gửi tin nhắn trong Chat cho một ứng dụng Chat, có thể là trong tin nhắn trực tiếp hoặc trong một phòng Chat, hoặc một sự kiện xảy ra trong một phòng Chat mà ứng dụng Chat có gói thuê bao đang hoạt động.
Chat gửi tin nhắn đến một chủ đề Pub/Sub.
Máy chủ ứng dụng (là hệ thống trên đám mây hoặc tại chỗ có chứa logic của ứng dụng Chat) đăng ký chủ đề Pub/Sub để nhận thông báo qua tường lửa.
Ngoài ra, ứng dụng Chat có thể gọi Chat API để đăng tin nhắn không đồng bộ hoặc thực hiện các thao tác khác.
Điều kiện tiên quyết
Java
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
- Một dự án trên Google Cloud đã bật tính năng thanh toán. Để kiểm tra xem một dự án hiện có đã bật tính năng thanh toán hay chưa, hãy xem phần Xác minh trạng thái thanh toán của dự án. Để tạo dự án và thiết lập thông tin thanh toán, hãy xem phần Tạo dự án trên Google Cloud.
- Java 11 trở lên
- Công cụ quản lý gói Maven
Python
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
- Một dự án trên Google Cloud đã bật tính năng thanh toán. Để kiểm tra xem một dự án hiện có đã bật tính năng thanh toán hay chưa, hãy xem phần Xác minh trạng thái thanh toán của dự án. Để tạo dự án và thiết lập thông tin thanh toán, hãy xem phần Tạo dự án trên Google Cloud.
- Python 3.6 trở lên
- Công cụ quản lý gói pip
Node.js
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
- Một dự án trên Google Cloud đã bật tính năng thanh toán. Để kiểm tra xem một dự án hiện có đã bật tính năng thanh toán hay chưa, hãy xem phần Xác minh trạng thái thanh toán của dự án. Để tạo dự án và thiết lập thông tin thanh toán, hãy xem phần Tạo dự án trên Google Cloud.
- Node.js 14 trở lên
- Công cụ quản lý gói npm
-
Một dự án Node.js đã được khởi tạo. Để khởi tạo một dự án mới, hãy tạo và chuyển sang một thư mục mới, sau đó chạy lệnh sau trong giao diện dòng lệnh:
npm init
Thiết lập môi trường
Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.Trong Google Cloud Console, hãy bật Google Chat API và Pub/Sub API.
Thiết lập Pub/Sub
Tạo một chủ đề Pub/Sub mà API Chat có thể gửi tin nhắn đến. Bạn nên sử dụng một chủ đề duy nhất cho mỗi ứng dụng Chat.
Cấp cho Chat quyền xuất bản vào chủ đề bằng cách chỉ định vai trò Nhà xuất bản Pub/Sub cho tài khoản dịch vụ sau:
chat-api-push@system.gserviceaccount.com
Tạo tài khoản dịch vụ cho ứng dụng Chat để uỷ quyền bằng Pub/Sub và Chat, đồng thời lưu tệp khoá riêng tư vào thư mục làm việc của bạn.
Tạo một gói thuê bao kéo cho chủ đề.
Chỉ định Vai trò người đăng ký Pub/Sub cho gói thuê bao đối với tài khoản dịch vụ mà bạn đã tạo trước đó.
Viết tập lệnh
Java
Trong CLI, hãy cung cấp thông tin đăng nhập của tài khoản dịch vụ:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
Trong giao diện dòng lệnh (CLI), hãy cung cấp mã dự án trên Google Cloud:
export PROJECT_ID=PROJECT_ID
Trong một CLI, hãy cung cấp mã nhận dạng gói thuê bao cho gói thuê bao Pub/Sub mà bạn đã tạo trước đó:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
Trong thư mục làm việc, hãy tạo một tệp có tên là
pom.xml
.Trong tệp
pom.xml
, hãy dán mã sau:Trong thư mục làm việc, hãy tạo cấu trúc thư mục
src/main/java
.Trong thư mục
src/main/java
, hãy tạo một tệp có tên làMain.java
.Trong
Main.java
, hãy dán mã sau:
Python
Trong CLI, hãy cung cấp thông tin đăng nhập của tài khoản dịch vụ:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
Trong giao diện dòng lệnh (CLI), hãy cung cấp mã dự án trên Google Cloud:
export PROJECT_ID=PROJECT_ID
Trong một CLI, hãy cung cấp mã nhận dạng gói thuê bao cho gói thuê bao Pub/Sub mà bạn đã tạo trước đó:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
Trong thư mục làm việc, hãy tạo một tệp có tên là
requirements.txt
.Trong tệp
requirements.txt
, hãy dán mã sau:Trong thư mục làm việc, hãy tạo một tệp có tên là
app.py
.Trong
app.py
, hãy dán mã sau:
Node.js
Trong CLI, hãy cung cấp thông tin đăng nhập của tài khoản dịch vụ:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
Trong giao diện dòng lệnh (CLI), hãy cung cấp mã dự án trên Google Cloud:
export PROJECT_ID=PROJECT_ID
Trong một CLI, hãy cung cấp mã nhận dạng gói thuê bao cho gói thuê bao Pub/Sub mà bạn đã tạo trước đó:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
Trong thư mục làm việc, hãy tạo một tệp có tên là
package.json
.Trong tệp
package.json
, hãy dán mã sau:Trong thư mục làm việc, hãy tạo một tệp có tên là
index.js
.Trong
index.js
, hãy dán mã sau:
Xuất bản ứng dụng lên Chat
Trong Google Cloud Console, hãy chuyển đến Trình đơn > API và dịch vụ > API và dịch vụ đã bật > Google Chat API > Cấu hình.
Định cấu hình ứng dụng Chat cho Pub/Sub:
- Trong Tên ứng dụng, hãy nhập
Quickstart App
. - Trong URL hình đại diện, hãy nhập
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - Trong phần Nội dung mô tả, hãy nhập
Quickstart app
. - Trong phần Chức năng, hãy chọn Tham gia không gian và cuộc trò chuyện nhóm.
- Trong phần Cài đặt kết nối, hãy chọn Cloud Pub/Sub rồi dán tên của chủ đề Pub/Sub mà bạn đã tạo trước đó.
- Trong phần Chế độ hiển thị, hãy chọn Chỉ cung cấp ứng dụng Google Chat này cho một số người và nhóm cụ thể trong miền của bạn rồi nhập địa chỉ email của bạn.
- Trong mục Nhật ký, hãy chọn Ghi lỗi vào Nhật ký.
- Trong Tên ứng dụng, hãy nhập
Nhấp vào Lưu.
Ứng dụng đã sẵn sàng nhận và trả lời tin nhắn trên Chat.
Chạy tập lệnh
Trong một CLI, hãy chuyển sang thư mục làm việc của bạn và chạy tập lệnh:
Java
mvn compile exec:java -Dexec.mainClass=Main
Python
python -m venv env
source env/bin/activate
pip install -r requirements.txt -U
python app.py
Node.js
npm install
npm start
Khi bạn chạy mã, ứng dụng sẽ bắt đầu lắng nghe các thông báo được xuất bản cho chủ đề Pub/Sub.
Kiểm thử ứng dụng Chat
Để kiểm thử ứng dụng Chat, hãy mở một không gian nhắn tin trực tiếp bằng ứng dụng Chat rồi gửi một tin nhắn:
Mở Google Chat bằng tài khoản Google Workspace mà bạn đã cung cấp khi thêm chính mình làm người kiểm thử tin cậy.
- Nhấp vào biểu tượng Cuộc trò chuyện mới.
- Trong trường Thêm một hoặc nhiều người, hãy nhập tên của ứng dụng Chat.
Chọn ứng dụng Chat trong kết quả. Một tin nhắn trực tiếp sẽ mở ra.
- Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập
Hello
rồi nhấnenter
.
Để thêm người kiểm thử đáng tin cậy và tìm hiểu thêm về cách kiểm thử các tính năng tương tác, hãy xem bài viết Kiểm thử các tính năng tương tác cho ứng dụng Google Chat.
Khắc phục sự cố
Khi một ứng dụng Google Chat hoặc thẻ trả về lỗi, giao diện Chat sẽ hiển thị thông báo "Đã xảy ra lỗi". hoặc "Không thể xử lý yêu cầu của bạn". Đôi khi, giao diện người dùng Chat không hiển thị bất kỳ thông báo lỗi nào, nhưng ứng dụng hoặc thẻ Chat lại tạo ra kết quả không mong muốn; ví dụ: thông báo thẻ có thể không xuất hiện.
Mặc dù thông báo lỗi có thể không xuất hiện trong giao diện người dùng Chat, nhưng bạn có thể sử dụng thông báo lỗi mô tả và dữ liệu nhật ký để khắc phục lỗi khi bật tính năng ghi nhật ký lỗi cho ứng dụng Chat. Để được trợ giúp xem, gỡ lỗi và khắc phục lỗi, hãy xem bài viết Khắc phục lỗi trong Google Chat.
Dọn dẹp
Để tránh phát sinh phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được dùng trong hướng dẫn này, bạn nên xoá dự án trên Cloud.
- Trong Google Cloud Console, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào Trình đơn > IAM và Quản trị viên > Quản lý tài nguyên.
- Trong danh sách dự án, hãy chọn dự án bạn muốn xoá rồi nhấp vào biểu tượng Xoá .
- Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.
Chủ đề có liên quan
Để thêm các tính năng khác vào ứng dụng Chat, hãy xem phần sau: