Trang này giải thích cách tạo ứng dụng Chat bằng Pub/Sub. Loại cấu trúc này cho ứng dụng Chat sẽ hữu ích nếu tổ chức của bạn có tường lửa có thể ngăn Chat gửi tin nhắn đến ứng dụng Chat hoặc nếu ứng dụng Chat sử dụng API Sự kiện của Google Workspace. Tuy nhiên, cấu trúc này có các 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ư trên thẻ.
- Không thể cập nhật từng thẻ bằng 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 Chat được tạo bằng Pub/Sub:
Trong sơ đồ trước, người dùng tương tác với ứng dụng Chat Pub/Sub có luồng thông tin sau:
Người dùng gửi tin nhắn trong Chat đến một ứng dụng Chat, trong tin nhắn trực tiếp hoặc trong một không gian Chat, hoặc một sự kiện xảy ra trong một không gian Chat mà ứng dụng Chat có một lượt đăng ký đang hoạt động.
Chat sẽ gửi tin nhắn đến một chủ đề Pub/Sub.
Máy chủ ứng dụng, là một hệ thống trên đám mây hoặc tại chỗ chứa logic ứng dụng Chat, đăng ký chủ đề Pub/Sub để nhận thông báo thông qua tường lửa.
Nếu muốn, ứ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 dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Một dự á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 bài viết 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 dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Một dự á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 bài viết 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 dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Một dự á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 bài viết 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 đã khởi chạy. Để khởi chạy 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 API Google Chat và API Pub/Sub.
Thiết lập Pub/Sub
Tạo 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 quyền cho Chat để phát hành lên 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 đang hoạt động.
Tạo gói thuê bao kéo cho chủ đề.
Chỉ định Vai trò người đăng ký Pub/Sub cho gói thuê bao cho 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 xác thực tài khoản dịch vụ:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
Trong CLI, hãy cung cấp mã dự án trên Google Cloud:
export PROJECT_ID=PROJECT_ID
Trong CLI, hãy cung cấp mã nhận dạng của gói thuê bao Pub/Sub mà bạn đã tạo trước đó:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
Trong thư mục đang hoạt động, hãy tạo một tệp có tên
pom.xml
.Trong tệp
pom.xml
, hãy dán mã sau:Trong thư mục đang hoạt động, 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ênMain.java
.Trong
Main.java
, hãy dán mã sau:
Python
Trong CLI, hãy cung cấp thông tin xác thực tài khoản dịch vụ:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
Trong CLI, hãy cung cấp mã dự án trên Google Cloud:
export PROJECT_ID=PROJECT_ID
Trong CLI, hãy cung cấp mã nhận dạng của gói thuê bao Pub/Sub mà bạn đã tạo trước đó:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
Trong thư mục đang hoạt động, hãy tạo một tệp có tên
requirements.txt
.Trong tệp
requirements.txt
, hãy dán mã sau:Trong thư mục đang hoạt động, hãy tạo một tệp có tên
app.py
.Trong
app.py
, hãy dán mã sau:
Node.js
Trong CLI, hãy cung cấp thông tin xác thực tài khoản dịch vụ:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
Trong CLI, hãy cung cấp mã dự án trên Google Cloud:
export PROJECT_ID=PROJECT_ID
Trong CLI, hãy cung cấp mã nhận dạng của gói thuê bao Pub/Sub mà bạn đã tạo trước đó:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
Trong thư mục đang hoạt động, hãy tạo một tệp có tên
package.json
.Trong tệp
package.json
, hãy dán mã sau:Trong thư mục đang hoạt động, hãy tạo một tệp có tên
index.js
.Trong
index.js
, hãy dán mã sau:
Phát hành ứ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 > API Google Chat > Cấu hình.
Định cấu hình ứng dụng Chat cho Pub/Sub:
- Trong App name (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 Description (Nội dung mô tả), hãy nhập
Quickstart app
. - Trong phần Chức năng, hãy chọn Nhận tin nhắn 1:1 và 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 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 App name (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 CLI, hãy chuyển sang thư mục đang hoạt động 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 nghe các thông báo được phát hành 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 tin nhắn trực tiếp bằng ứng dụng Chat và gửi 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ử đáng tin cậy.
- Nhấp vào Cuộc trò chuyện mới.
- Trong trường Thêm 1 người trở lên, 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ấn phímenter
.
Để 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 ứ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ị thông báo lỗi nào, nhưng ứng dụng Chat hoặc thẻ 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 hiển thị trong giao diện người dùng Chat, nhưng bạn có thể xem 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 và khắc phục lỗi Google Chat.
Dọn dẹp
Để tránh bị tính phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được sử dụng trong hướng dẫn này, bạn nên xoá dự án trên Google Cloud.
- Trong Google Cloud Console, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào biểu tượng Trình đơn > IAM và quản trị > 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 Shut down (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 nội dung sau: