Cấp độ lập trình: Trung cấp
Thời lượng: 30 phút
Loại dự án: Tiện ích bổ sung của Google Workspace
Mục tiêu
- Tìm hiểu chức năng của tiện ích bổ sung.
- Tìm hiểu cách tạo tiện ích bổ sung bằng Apps Script và tìm hiểu về Apps Script các dịch vụ khác.
- 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ề tiện ích bổ sung này của Google Workspace
Trong mẫu này, bạn sẽ tạo một Tiện ích bổ sung của Google Workspace có thể xem trước các đường liên kết trong Google Sách ở Tài liệu trên Google Tài liệu. Khi bạn nhập hoặc dán URL của Google Sách vào một tài liệu đó thì tiện ích bổ sung này sẽ nhận dạng và kích hoạt bản xem trước đường liên kết. Để xem trước đường liên kết, bạn có thể chuyển đổi liên kết vào một khối thông minh và giữ con trỏ trên đường liên kết để xem một thẻ hiện thêm thông tin về cuốn sách.
Tiện ích bổ sung này sử dụng UrlFetch Service của Apps Script để kết nối với Google Sách API và nhận thông tin về Google Sách để hiển thị trong Google Tài liệu.
Cách hoạt động
Trong tệp kê khai của tiện ích bổ sung cho Google Workspace
, tập lệnh sẽ định cấu hình
tiện ích bổ sung để mở rộng Google Tài liệu và liên kết kích hoạt
bản xem trước URL khớp với một số mẫu nhất định trên trang web Google Sách
(https://books.google.com
).
Trong tệp mã, tập lệnh kết nối với Google Books API và sử dụng URL này
để nhận thông tin về cuốn sách (một phiên bản của Volume
tài nguyên). Chiến lược phát hành đĩa đơn
tập lệnh sử dụng thông tin này để tạo một khối thông minh hiển thị
tiêu đề và thẻ xem trước hiển thị bản tóm tắt, số lượng trang, hình ảnh
bìa sách và số lượt xếp hạng.
Dịch vụ Apps Script
Tiện ích bổ sung này sử dụng các dịch vụ sau:
- UrlFetch Service – Kết nối với Google Sách
API để nhận thông tin về sách (là các phiên bản của API)
Tài nguyên
Volume
). - Dịch vụ thẻ – Tạo người dùng giao diện của tiện ích bổ sung.
Đ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 đây:
- Tài khoản Google (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 thông qua một tài khoản thanh toán liên kết. Hãy tham khảo bài viết Bật tính năng thanh toán cho dự án.
Thiết lập môi trường
Các phần sau đây thiết lập môi trường để bạn tạo tiện ích bổ sung.
Mở dự án Cloud trong bảng điều khiển Google Cloud
Mở dự án Cloud mà bạn định sử dụng nếu chưa mở 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 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, có thể bạn sẽ phải bật tính năng thanh toán cho dự án đó.
Bật Google Books API
Tiện ích bổ sung này kết nối với Google Books API. Trước khi sử dụng các API của Google, bạn cần bật các API này 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 Google Cloud.
Trong dự án trên Google Cloud, hãy bật Books API (API Sách).
Định cấu hình màn hình xin phép bằng OAuth
Tiện ích bổ sung này yêu cầu phải có một dự án trên Google Cloud có màn hình xin phép. Việc định cấu hình màn hình xin phép bằng OAuth sẽ xác định những thông tin Google hiển thị với người dùng và đăng ký ứng dụng của bạn để bạn có thể phát hành ứng dụng đó sau.
- 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 xin phép bằ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 rồi nhấp vào Lưu và tiếp tục. Trong tương lai, khi bạn tạo một ứng dụng để sử dụng bên ngoài Nếu là 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 phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu.
- Xem lại bản tóm tắt về gói đă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 ứng dụng có vẻ ổn, hãy nhấp vào Quay lại trang tổng quan.
Nhận khoá API cho Google Books API
- Chuyển đến bảng điều khiển Google Cloud. Hãy đảm bảo dự án có tính năng thanh toán của bạn đang mở.
Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > API và Dịch vụ > Thông tin đăng nhập.
Nhấp vào Tạo thông tin xác thực > Khoá API.
Hãy ghi lại khoá API của bạn để sử dụng trong bước sau.
Thiết lập tập lệnh
Các phần sau đây thiết lập tập lệnh để tạo tiện ích bổ sung.
Tạo dự án Apps Script
- Nhấp vào nút sau để mở Đường liên kết xem trước trên Google Sách
Dự án Apps Script.
Mở dự án - Nhấp vào Tổng quan.
- Trên trang tổng quan, hãy nhấp vào
Tạo bản sao.
- Trong bản sao dự án Apps Script, hãy chuyển đến
Code.gs
và thay thếYOUR_API_KEY
bằng khoá API mà bạn đã tạo trong phần trước.
Sao chép số dự án trên đám mây
- Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị > Cài đặt.
- Trong trường Project number (Số dự án), hãy sao chép giá trị.
Đặt dự án trên đám mây của dự án Apps Script
- Trong dự án Apps Script,
nhấp vào
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 trên Google Cloud.
- Nhấp vào Đặt dự án.
Kiểm thử tiện ích bổ sung
Các phần sau đây sẽ kiểm tra tiện ích bổ sung mà bạn đã tạo.
Cài đặt hoạt động triển khai thử nghiệm
- Trong dự án Apps Script, hãy nhấp vào Editor (Trình chỉnh sửa).
- Thay thế
YOUR_API_KEY
bằng khoá API cho Google Books API (API Google Sách), được tạo trong phần trước. - Nhấp vào Triển khai > Kiểm thử các bản triển khai.
- Nhấp vào Cài đặt > Xong.
Xem trước đường liên kết trong Google Tài liệu
- Tạo tài liệu trên Google Tài liệu tại docs.new.
- Dán URL sau đây vào tài liệu và nhấn phím tab để
chuyển đổi URL thành một khối thông minh:
https://www.google.com/books/edition/Software_Engineering_at_Google/V3TTDwAAQBAJ
- Giữ con trỏ trên khối thông minh và khi được nhắc, hãy cho phép truy cập vào thực thi tiện ích bổ sung. Thẻ xem trước sẽ xuất hiện về cuốn sách.
Hình ảnh sau đây cho thấy bản xem trước đường liên kết:
Xem lại đoạn mã
Để xem lại mã Apps Script cho vấn đề này tiện ích bổ sung, nhấp vào Xem mã nguồn để mở rộng mục: