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 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
Việc sao chép thủ công macro Google Trang tính từ bảng tính này sang bảng tính khác có thể tốn thời gian và dễ xảy ra lỗi. Tiện ích bổ sung Google Workspace này tự động sao chép một dự án tập lệnh và đính kèm dự án đó vào bảng tính do người dùng chỉ định. Mặc dù giải pháp này tập trung vào các macro của Trang tính, nhưng bạn có thể sử dụng giải pháp này để sao chép và chia sẻ bất kỳ tập lệnh liên kết với vùng chứa nào.
Cách hoạt động
Tập lệnh này sẽ sao chép dự án Apps Script được liên kết với bảng tính gốc rồi tạo một dự án Apps Script trùng lặp được liên kết với bảng tính do người dùng chỉ định.
Dịch vụ Apps Script
Giải pháp này sử dụng các dịch vụ sau:
- Dịch vụ Tìm nạp URL – Kết nối với API Apps Script để sao chép dự án nguồn và tạo một bản sao.
- Dịch vụ tập lệnh – Cho phép API Apps Script tránh lời nhắc cấp phép lần thứ hai.
- Dịch vụ bảng tính – Mở bảng tính đích để thêm dự án Apps Script đã sao chép.
- Dịch vụ thẻ – Tạo giao diện người dùng 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:
- 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.
API Google Apps Script được bật trong phần cài đặt trang tổng quan Apps Script.
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 Google Apps Script
Bắt đầu nhanh này sử dụng API Google Apps Script.
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 Cloud, hãy bật API Google Apps Script.
Định cấu hình màn hình xin phép bằng OAuth
Cần phải định cấu hình màn hình đồng ý để sử dụng Tiện ích bổ sung của Google Workspace. Việc định cấu hình màn hình xin phép bằng OAuth của tiện ích bổ sung sẽ xác định nội dung mà Google hiển thị cho người dùng.
- 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 Share a macro (Chia sẻ macro).
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.
Cài đặt quá trình triển khai thử nghiệm
- Trong dự án Apps Script đã sao chép, hãy nhấp vào biểu tượng Trình chỉnh sửa .
- Mở tệp
UI.gs
rồi nhấp vào Run (Chạy). Khi được nhắc, hãy cho phép tập lệnh. - Nhấp vào Triển khai > Thử nghiệm các lượt triển khai.
- Nhấp vào Cài đặt > Xong.
Lấy thông tin bảng tính và tập lệnh macro
- Mở một bảng tính Trang tính có macro và bạn có quyền chỉnh sửa. Để sử dụng bảng tính mẫu, hãy tạo bản sao của bảng tính Macro mẫu.
- Nhấp vào Tiện ích > Apps Script.
- Trong dự án Apps Script, hãy nhấp vào biểu tượng Cài đặt dự án .
- Bên dưới mã tập lệnh, hãy nhấp vào Sao chép.
- Đặt mã nhận dạng tập lệnh sang một bên để sử dụng trong bước sau.
- Mở hoặc tạo một bảng tính mới mà bạn muốn thêm macro. Bạn phải có quyền chỉnh sửa bảng tính.
- Sao chép URL của bảng tính rồi đặt riêng URL đó để sử dụng trong bước sau.
Chạy tập lệnh
Đảm bảo rằng bạn đã bật API Google Apps Script trong cài đặt trang tổng quan. Thực hiện các bước trong những phần sau để chạy tập lệnh của bạn.
Sao chép macro
- Trong Trang tính, ở thanh bên phải, hãy mở tiện ích bổ sung Chia sẻ macro .
- Trong Macro nguồn, hãy dán mã tập lệnh.
- Trong phần Bảng tính mục tiêu, hãy dán URL của bảng tính.
- Nhấp vào Chia sẻ macro.
- Nhấp vào Uỷ quyền truy cập và cho phép tiện ích bổ sung.
- Lặp lại các bước từ 2 đến 4.
Mở macro đã sao chép
- Nếu bảng tính chưa được mở, hãy mở bảng tính mà bạn đã sao chép macro.
- Nhấp vào Tiện ích > Apps Script.
- Nếu bạn không thấy dự án Apps Script đã sao chép, hãy đảm bảo bạn đã bật API Google Apps Script trong cài đặt trang tổng quan và lặp lại các bước nêu trong phần Sao chép macro.
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
UI.gs
appsscript.json
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.
Các bước tiếp theo
- Mở rộng Google Workspace bằng các tiện ích bổ sung
- Tạo tiện ích bổ sung cho Google Workspace
- Phát hành ứng dụng