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 dành cho Google Workspace hoạt động trong Google Chat bằng Google Apps Script. Trong Google Chat, các tiện ích bổ sung sẽ xuất hiện với người dùng dưới dạng ứng dụng 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 và trả lời trực tiếp bằng cách phản hồi tin nhắn của bạn.

Sơ đồ sau đây cho thấy cấu trúc và mẫu thông báo:

Cấu trúc của một ứng dụng Chat được triển khai bằng Apps Script.

Trong sơ đồ trước, 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 phòng Chat.
  2. Logic ứ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. Nếu muốn, logic ứ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 ứng dụng Chat sẽ gửi phản hồi về 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 tiện ích bổ sung của Google Workspace cho ứng dụng Chat.
  • Kiểm thử ứng dụng Chat.

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

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

Mở dự án trên Google Cloud trong Google Cloud Console

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

  1. Trong Google Cloud Console, 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 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 dự án trên Google Cloud, bạn có thể cần phải 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 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.

    Bật API

Tất cả ứng dụng sử dụng OAuth 2.0 đều phải có cấu hình màn hình đồng ý. Việc định cấu hình màn hình xin phép bằng OAuth của ứng dụng sẽ xác định 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 ứng dụng sau này.

  1. Trong Google Cloud Console, hãy chuyển đến Trình đơn > API và dịch vụ > Màn hình đồng ý OAuth.

    Chuyển đến màn hình xin phép bằng OAuth

  2. Đối với Loại người dùng, hãy chọn Nội bộ, sau đó nhấp vào Tạo.
  3. Hoàn tất biểu mẫu đăng ký ứng dụng, sau đó nhấp vào Lưu và tiếp tục.
  4. Hiện tại, bạn có thể bỏ qua bước thêm phạm vi và nhấp vào Lưu và tiếp tục. 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 đó thêm các phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu.

  5. Xem lại thông tin tóm tắt về việc đăng ký ứng dụng. Để chỉnh sửa, hãy nhấp vào Chỉnh sửa. Nếu quá trình đăng ký ứng dụng có vẻ ổn, hãy nhấp vào Quay lại trang tổng quan.

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

Để thiết lập tập lệnh, bạn tạo một bản sao của dự án làm quen nhanh, sau đó thiết lập dự án trên Cloud trong Apps Script.

Tạo bản sao của dự án bắt đầu nhanh

  1. Nhấp vào nút sau để mở dự án Apps Script Tiện ích bổ sung trong Google Chat.
    Mở dự án
  2. Nhấp vào Tổng quan.
  3. Trên trang tổng quan, hãy nhấp vào Biểu tượng để tạo bản sao Tạo bản sao.
  4. Đặt tên cho bản sao dự án Apps Script:

    1. Nhấp vào Bản sao của ứng dụng Chat bổ sung.

    2. Trong Project title (Tên dự án), hãy nhập Add-on Chat app

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

Sao chép số dự án trên Cloud

  1. Trong Google Cloud Console, hãy chuyển đến Trình đơn > IAM & Admin (Quản trị viên và quản lý quyền truy cập) > Settings (Cài đặt).

    Chuyển đến phần IAM và Cài đặt quản trị

  2. Trong trường Mã dự án, hãy sao chép giá trị.

Thiết lập dự án Cloud của dự án Apps Script

  1. Trong dự án Chat Apps Script, hãy nhấp vào Project Settings (Cài đặt dự án) Biểu tượng cài đặt dự án.
  2. Trong phần Dự án trên Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
  3. Trong mục Số dự án GCP, hãy dán số dự án trên Google Cloud.
  4. Nhấp vào Đặt dự án.

Giờ đây, bạn có thể thử nghiệm mã ứng dụng đang hoạt động (như mô tả trong các bước sau) rồi tuỳ chỉnh để đáp ứng các yêu cầu của mình.

Đảm bảo bạn đã đăng nhập vào đúng Tài khoản Google khi mở dự án Apps Script. Đôi khi, tài khoản hiện tại có thể chuyển sang tài khoản mặc định mà bạn không nhận thấy.

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

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

Để lấy mã hoạt động triển khai đầu, hãy làm như sau:

  1. Trong dự án Chat app Apps Script, hãy nhấp vào Deploy (Triển khai) > Test deployments (Kiểm thử bản triển khai).
  2. Sao chép Mã triển khai đầu để sử dụng trong bước sau rồi nhấp vào Xong.

Định cấu hình tiện ích bổ sung

Khi triển khai Apps Script, hãy làm theo các bước sau để tạo tiện ích bổ sung và triển khai ứng dụng Google Chat:

  1. Trong bảng điều khiển, hãy tì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 App name (Tên ứng dụng), hãy nhập Add-on Chat app.
    2. Trong trường Avatar URL (URL hình đại diện), hãy nhập https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. Trong trường Description (Mô tả), hãy nhập Add-on Chat app.
    4. Trong phần Chức năng, hãy chọn Nhận tin nhắn 1:1Tham 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ã triển khai, hãy dán mã triển khai Head mà bạn đã sao chép trước đó.
    7. Trong phần Mức độ 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 không gian tin nhắn trực tiếp bằng ứng dụng Chat và 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.

  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 thông báo 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 ứ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.

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

    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 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 Shut down (Tắt) để xoá dự án.