Cấp độ lập trình: Trung cấp
Thời lượng: 25 phút
Loại dự án: Ứng dụng Google Chat
Mục tiêu
- Tìm hiểu vai trò của giải pháp.
- Hiểu chức năng của các dịch vụ Apps Script trong giải pháp.
- Thiết lập môi trường.
- Thiết lập tập lệnh.
- Chạy tập lệnh.
Giới thiệu về giải pháp này
Lên lịch cuộc họp trong Lịch Google ngay trong tin nhắn trực tiếp (DM) hoặc một không gian trong Google Chat. Bạn có thể đặt thông tin cụ thể cho cuộc họp, chẳng hạn như tiêu đề, thời gian bắt đầu hoặc thời lượng, hoặc sử dụng các chế độ cài đặt mặc định để lên lịch cuộc họp tức thì.
Cách hoạt động
Tập lệnh ứng dụng Chat sử dụng lệnh dấu gạch chéo và hộp thoại để lấy thông tin chi tiết về cuộc họp từ người dùng và lên lịch cho một sự kiện trên Lịch. Tập lệnh này bao gồm các chế độ cài đặt cuộc họp mặc định có thể được tuỳ chỉnh cho phù hợp với nhu cầu của bạn.
Dịch vụ Apps Script
Giải pháp này sử dụng các dịch vụ sau:
- Dịch vụ lịch – Tạo sự kiện trên lịch từ thông tin cuộc họp được cung cấp.
- Dịch vụ cơ sở – Sử dụng lớp
Session
để lấy múi giờ của tập lệnh. Lịch sử dụng múi giờ này khi lên lịch cho sự kiện. - Dịch vụ tiện ích – Định dạng ngày cho sự kiện trên lịch và mã hoá mã sự kiện để giúp lấy URL sự kiện.
Điều kiện tiên quyết
Để sử dụng mẫu này, bạn cần có các điều kiện tiên quyết sau:
- Tài khoản Google (các tài khoản Google Workspace có thể yêu cầu quản trị viên phê duyệt).
- Một trình duyệt web có quyền truy cập vào Internet.
- Một dự án trên Google Cloud.
Thiết lập môi trường
Mở dự án Cloud trong bảng điều khiển Google Cloud
Nếu chưa mở, hãy mở dự án Cloud mà bạn định sử dụng cho mẫu này:
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Chọn dự án.
- 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 phải bật tính năng thanh toán cho dự án.
Bật API
Trước khi sử dụng các API của Google, bạn cần bật những 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 dự án trên Google Cloud, hãy bật API Google Chat.
Định cấu hình màn hình xin phép bằng OAuth
Tất cả các ứng dụng trong Chat đều yêu cầu bạn phải thiết lập màn hình xin phép. 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 mà Google hiển thị cho người dùng và đăng ký ứng dụng của bạn để bạn có thể phát hành sau này.
- Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > API và dịch vụ > màn hình đồng ý OAuth.
- Đối với Loại người dùng, hãy chọn Nội bộ, rồi nhấp vào Tạo.
- 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.
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. Sau này, khi tạo một ứng dụng để dùng bên ngoài tổ chức Google Workspace của mình, bạn phải thay đổi Loại người dùng thành Bên ngoài, sau đó thêm phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu.
- Xem lại tóm tắt đăng ký ứng dụng của bạn. Để 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 Back to Dashboard (Quay lại Trang tổng quan).
Thiết lập tập lệnh
Tạo dự án Apps Script
- Nhấp vào nút sau để mở dự án Apps Script Lên lịch cuộc họp từ Google Chat.
Mở dự án - Nhấp vào biểu tượng Tổng quan .
- Trên trang tổng quan, hãy nhấp vào biểu tượng Tạo bản sao .
Sao chép số dự án trên Google Cloud
-
Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị viên
> Cài đặt.
Chuyển đến phần Cài đặt quản trị viên và quản lý danh tính và quyền truy cập (IAM)
- Trong trường Số dự án, hãy sao chép giá trị đó.
Đặt dự án Cloud của dự án Apps Script
- Trong dự án Apps Script đã sao chép, hãy nhấp vào biểu tượng Cài đặt dự án .
- Trong mục Dự án Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
- Trong mục Số dự án GCP, hãy dán số dự án Google Cloud.
- Nhấp vào Đặt dự án.
Tạo quá trình triển khai thử nghiệm
- Trong dự án Apps Script đã sao chép, hãy nhấp vào implementation (Triển khai) > Kiểm thử các bản triển khai.
- Sao chép Mã triển khai head để sử dụng trong bước tiếp theo rồi nhấp vào Done (Xong).
Định cấu hình API Chat
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang API Chat.
Chuyển đến API Chat - Nhấp vào Cấu hình.
- Định cấu hình API Chat bằng các thông tin sau:
- Tên:
Meeting Scheduler
- URL hình đại diện: Thêm URL trỏ đến một hình ảnh có kích thước tối thiểu là 256x256 pixel.
- Mô tả:
Quickly create meetings.
- Chức năng: Đánh dấu vào cả hai hộp để cho phép người dùng nhắn tin trực tiếp cho ứng dụng và thêm ứng dụng vào không gian.
- Chế độ cài đặt kết nối: Nhấp vào Apps Script rồi nhập mã triển khai trưởng.
- Lệnh gạch chéo: Thêm lệnh dấu gạch chéo cho
/help
và/schedule_Meeting
bằng cách thực hiện các bước sau:- Nhấp vào Thêm lệnh dấu gạch chéo và định cấu hình lệnh đó với các thông tin sau:
- Tên:
/help
- Mã lệnh:
1
- Mô tả:
Learn what this app does.
- Tên:
- Nhấp lại vào Add Add Command (Thêm lệnh dấu gạch chéo) rồi định cấu hình nó với các thông tin sau:
- Tên:
/schedule_Meeting
- Mã lệnh:
2
- Mô tả:
Schedule a meeting.
- Đánh dấu vào hộp Mở hộp thoại.
- Tên:
- Nhấp vào Thêm lệnh dấu gạch chéo và định cấu hình lệnh đó với các thông tin sau:
- Quyền: Chọn Những người và nhóm cụ thể trong miền của bạn rồi nhập địa chỉ email.
- Tên:
- Nhấp vào Lưu rồi làm mới trang.
- Trên trang cấu hình, trong phần Trạng thái ứng dụng, hãy đặt trạng thái thành Đang hoạt động – cho phép người dùng sử dụng.
- Nhấp vào Lưu.
Chạy tập lệnh
- Mở Google Chat.
- Nhấp vào biểu tượng Bắt đầu trò chuyện .
- Tìm kiếm tên của ứng dụng,
Meeting Scheduler
. - Gửi một tin nhắn ban đầu, chẳng hạn như
hello
, để nhắc cấp quyền. Khi ứng dụng phản hồi, hãy nhấp vào Định cấu hình và cho phép ứng dụng. Nếu màn hình xin phép bằng OAuth hiển thị cảnh báo, Ứng dụng này chưa được xác minh, hãy tiếp tục bằng cách chọn Nâng cao > Chuyển đến {Tên dự án} (không an toàn).
Gửi
/schedule_Meeting
đến ứng dụng.Trong hộp thoại, hãy thêm ít nhất một địa chỉ email của người được mời. Bạn có thể cập nhật các trường khác hoặc sử dụng các mục mặc định.
Nhấp vào Gửi.
Để xem cuộc họp, hãy nhấp vào Mở sự kiện trên Lịch.
Xem lại đoạn mã
Để xem lại mã Apps Script cho giải pháp này, hãy nhấp vào phần Xem mã nguồn bên dưới:
Xem mã nguồn
Code.gs
Dialog.gs
Utilities.gs
Người đóng góp
Mẫu này được Google duy trì với sự trợ giúp của các chuyên gia nhà phát triển của Google.