Tạo ứng dụng Google Chat bằng Google Apps Script

Trang này giải thích cách tạo một tiện ích bổ sung Google Workspace hoạt động trong Google Chat bằng Google Apps Script.

Lưu ý: Trong Google Chat, tiện ích bổ sung xuất hiện với người dùng dưới dạng ứng dụng Google Chat. Bạn cũng có thể tạo ứng dụng Chat bằng sự kiện tương tác API Google Chat. Để tìm hiểu thêm, hãy xem bài viết Tổng quan về việc mở rộng Google Chat.

Ứng dụng Chat cho phép bạn nhắn tin trực tiếp và phản hồi bằng cách lặp lại tin nhắn của bạn.

Sơ đồ sau đây cho thấy cấu trúc và mẫu nhắn tin:

Trong sơ đồ trước đó, một người dùng tương tác với ứng dụng Chat trong Apps Script có luồng thông tin như sau:

1. Người dùng gửi tin nhắn đến một ứng dụng Chat, trong tin nhắn trực tiếp hoặc trong một phòng Chat.
2. Logic của ứng dụng Chat được triển khai trong Apps Script (nằm trong Google Cloud) sẽ nhận và xử lý tin nhắn.
3. Tuỳ ý, logic của ứng dụng Chat có thể tích hợp với các dịch vụ của Google Workspace, chẳng hạn như Lịch hoặc Trang tính, hoặc các dịch vụ khác của Google, chẳng hạn như Google Maps hoặc YouTube.
4. Logic của ứng dụng Chat gửi phản hồi trở lại dịch vụ ứng dụng Chat trong Chat.
5. Phản hồi được gửi đến người dùng.

Mục tiêu

• Thiết lập môi trường.
• Thiết lập tập lệnh.
• Định cấu hình ứng dụng Chat.
• Kiểm thử ứng dụng Chat.

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

• 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. Để tạo một dự án, hãy xem bài viết Tạo dự án trên Google Cloud.

Thiết lập môi trường

Mở dự án trên đám mây trong Bảng điều khiển Cloud

Nếu chưa mở, hãy mở dự án trên đám mây mà bạn dự định sử dụng cho mẫu này:

1. Trong Bảng điều khiển Google Cloud, hãy chuyển đến trang Chọn một dự án.

   Chọn một dự án trên đám mây

2. Chọn dự án trên Google Cloud mà bạn muốn sử dụng. Hoặc nhấp vào Tạo dự án rồi làm theo hướng dẫn trên màn hình. Nếu tạo một dự án trên Google Cloud, bạn có thể cần bật tính năng thanh toán cho dự án đó.

Bật API Chat

Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án trên Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án trên Google Cloud.

Trong bảng điều khiển Cloud, hãy bật API Google Chat.

Bật API

Định cấu hình màn hình xin phép bằng OAuth

Tất cả các ứng dụng sử dụng OAuth 2.0 đều yêu cầu cấu hình màn hình xin phép. Việc định cấu hình màn hình xin phép bằng OAuth cho ứng dụng sẽ xác định những nội dung hiển thị cho người dùng và người đánh giá ứng dụng, đồng thời đăng ký ứng dụng để bạn có thể phát hành sau này.

1. Trong Bảng điều khiển API của Google, hãy chuyển đến trình đơn Trình đơn > Nền tảng xác thực của Google > Thương hiệu.

   Chuyển đến phần Thương hiệu

2. Nếu đã định cấu hình nền tảng xác thực của Google, bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình xin phép bằng OAuth trong phần Thương hiệu, Đối tượng và Quyền truy cập dữ liệu. Nếu bạn thấy thông báo cho biết Nền tảng xác thực của Google chưa được định cấu hình, hãy nhấp vào Bắt đầu:
1. Trong phần Thông tin ứng dụng, ở mục Tên ứng dụng, hãy nhập tên cho ứng dụng.
2. Trong phần Email hỗ trợ người dùng, hãy chọn một địa chỉ email hỗ trợ để người dùng có thể liên hệ với bạn nếu có thắc mắc về việc họ đồng ý.
3. Nhấp vào Tiếp theo.
4. Trong phần Đối tượng, hãy chọn Nội bộ.
5. Nhấp vào Tiếp theo.
6. Trong phần Thông tin liên hệ, hãy nhập Địa chỉ email để bạn có thể nhận thông báo về mọi thay đổi đối với dự án của mình.
7. Nhấp vào Tiếp theo.
8. Trong phần Hoàn tất, hãy xem lại Chính sách dữ liệu người dùng của các dịch vụ API của Google và nếu đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của các dịch vụ API của Google.
9. Nhấp vào Tiếp tục.
10. Nhấp vào Tạo.
3. Hiện tại, bạn có thể bỏ qua bước thêm phạm vi. Trong tương lai, khi tạo một ứng dụng để sử dụng bên ngoài tổ chức Google Workspace, bạn phải thay đổi Loại người dùng thành Bên ngoài. Sau đó, hãy thêm các phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu. Để tìm hiểu thêm, hãy xem hướng dẫn đầy đủ về cách Định cấu hình màn hình xin phép bằng OAuth.

Thiết lập tập lệnh

Để thiết lập tập lệnh, bạn hãy sử dụng mẫu ứng dụng Chat trên trang Bắt đầu của Apps Script.

Tạo dự án Apps Script

1. Trên trang Bắt đầu của Apps Script, hãy chuyển đến phần Trình khởi tạo tiện ích bổ sung Google Workspace rồi nhấp vào mẫu Ứng dụng Chat:

   Mở mẫu ứng dụng Chat

2. Trong dự án Apps Script mới mở ra, hãy đặt tên cho dự án:

   1. Nhấp vào Dự án không có tiêu đề.

   2. Trong phần Tiêu đề dự án, hãy nhập Add-on Chat app.

   3. Nhấp vào Đổi tên.

Trong tương lai, nếu muốn sử dụng một số API của Google hoặc phát hành ứng dụng, bạn phải liên kết dự án trên đám mây với dự án Apps Script. Đối với hướng dẫn này, bạn không cần làm như vậy. Để tìm hiểu thêm, hãy xem hướng dẫn về dự án trên Google Cloud.

Tạo bản triển khai kiểm thử

Bạn cần có mã nhận dạng bản triển khai cho dự án Apps Script này để có thể sử dụng trong bước tiếp theo.

Để lấy mã nhận dạng bản triển khai chính, hãy làm như sau:

1. Trong dự án Apps Script của ứng dụng Chat, hãy nhấp vào Triển khai > Bản triển khai kiểm thử.
2. Sao chép Mã nhận dạng bản triển khai chính để sử dụng trong bước sau và nhấp vào Xong.

Định cấu hình ứng dụng Chat

Hãy làm theo các bước sau để định cấu hình ứng dụng Google Chat:

1. Trong Bảng điều khiển API, hãy tìm kiếm Google Chat API, rồi nhấp vào Google Chat API.
2. Nhấp vào Quản lý.

3. Nhấp vào Cấu hình rồi thiết lập ứng dụng Chat:

   1. Trong trường Tên ứng dụng, hãy nhập Add-on Chat app.
   2. Trong trường URL hình đại diện, hãy nhập https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. Trong trường Mô tả, hãy nhập Add-on Chat app.
   4. Trong phần Chức năng, hãy chọn Tham gia không gian và cuộc trò chuyện nhóm.
   5. Trong phần Cài đặt kết nối, hãy chọn Dự án Apps Script.
   6. Trong trường Mã nhận dạng bản triển khai, hãy dán Mã nhận dạng bản triển khai chính mà bạn đã sao chép trước đó.
   7. Trong phần Chế độ hiển thị, hãy chọn Những người và nhóm cụ thể trong miền của bạn rồi nhập email của bạn.

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

Ứng dụng Chat đã sẵn sàng phản hồi tin nhắn.

Kiểm thử ứng dụng Chat

Để kiểm thử ứng dụng Chat, hãy mở một phòng tin nhắn trực tiếp bằng ứng dụng Chat rồi gửi tin nhắn:

1. 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.

   Chuyển đến Google Chat

2. Nhấp vào Cuộc trò chuyện mới.
3. Trong trường Thêm 1 người trở lên, hãy nhập tên của ứng dụng Chat.

4. Chọn ứng dụng Chat trong kết quả. Một tin nhắn trực tiếp sẽ mở ra.

   Lưu ý: Nếu không thấy ứng dụng Chat trong danh sách kết quả, hãy đảm bảo rằng bạn đã đưa tài khoản Google Workspace vào phần cài đặt Chế độ hiển thị của trang Cấu hình API Chat trong Bảng điều khiển API của Google.

5. Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập Hello rồi nhấn enter.

   Ứng dụng Chat cảm ơn bạn đã thêm ứng dụng và lặp lại tin nhắn của bạn.

Để 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 hoặc thẻ Google Chat 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 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ể xem các thông báo lỗi mang tính mô tả và dữ liệu nhật ký để giúp khắc phục lỗi khi tính năng ghi nhật ký lỗi cho ứng dụng Chat được bật. Để được trợ giúp về cách xem, gỡ lỗi và khắc phục lỗi, hãy xem bài viết Khắc phục sự cố và sửa lỗi Google Chat.

Dọn dẹp

Để tránh bị tính phí vào tài khoản Google Cloud cho 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 đám mây.

Thận trọng: Việc xoá một dự án sẽ gây ra những tác động sau:

• Mọi thứ trong dự án đều bị xoá. Nếu bạn đã sử dụng một dự án hiện có cho hướng dẫn này, thì khi xoá dự án đó, bạn cũng sẽ xoá mọi công việc khác mà bạn đã thực hiện trong dự án.
• Mã dự án tuỳ chỉnh sẽ bị mất. Khi tạo dự án này, bạn có thể đã tạo một mã dự án tuỳ chỉnh mà bạn muốn sử dụng trong tương lai. Để giữ lại các URL sử dụng mã dự án, chẳng hạn như URL trên appspot.com, hãy xoá các tài nguyên đã chọn bên trong dự án thay vì xoá toàn bộ dự án.

Nếu bạn dự định khám phá nhiều hướng dẫn và hướng dẫn bắt đầu nhanh, thì việc sử dụng lại các dự án có thể giúp bạn tránh vượt quá hạn mức dự án.

1. Trong Bảng điều khiển API của Google, 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ị > Quản lý tài nguyên.

   Chuyển đến Trình quản lý tài nguyên

2. Trong danh sách dự án, hãy chọn dự án mà bạn muốn xoá rồi nhấp vào biểu tượng Xoá .
3. Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.