Trước khi tạo tiện ích bổ sung cho Trình chỉnh sửa, hãy xem lại hạn mức và giới hạn của Apps Script để đảm bảo thiết kế dự án của bạn phù hợp với các nguyên tắc này. Việc làm quen với các giới hạn này ngay từ đầu quá trình phát triển có thể giúp ngăn chặn các vấn đề tiềm ẩn sau này. Apps Script là công cụ lý tưởng để phát triển tiện ích bổ sung nhẹ cho bản thân, nhóm hoặc tổ chức của bạn. Tuy nhiên, nếu bạn dự định xây dựng một tiện ích bổ sung quy mô lớn cần xử lý nhiều người dùng, yêu cầu độ trễ thấp hoặc yêu cầu toàn quyền kiểm soát cơ sở hạ tầng, hãy cân nhắc phát triển tiện ích bổ sung Google Workspace trên môi trường thời gian chạy khác.
Hãy làm theo quy trình chung sau đây khi tạo tiện ích bổ sung cho Trình chỉnh sửa:
- Tạo một dự án Apps Script.
- Viết mã để xác định giao diện và hành vi của tiện ích bổ sung, sử dụng dịch vụ HTML tích hợp sẵn trong Apps Script.
- Kiểm thử tiện ích bổ sung.
- Xuất bản tiện ích bổ sung.
Tạo dự án tập lệnh
Tiện ích bổ sung cho Trình chỉnh sửa là một dự án Apps Script độc lập. Hướng dẫn về tập lệnh độc lập cung cấp hướng dẫn tạo dự án mới.
Bạn cũng có thể chỉ cần mở một tập lệnh mới.
Nếu bạn làm như vậy, tệp dự án (ban đầu có tên là Untitled project
) sẽ được đặt trong thư mục gốc của Drive.
Cộng tác
Khi bạn cộng tác với người khác để phát triển một tiện ích bổ sung, một tài khoản người dùng sẽ sở hữu dự án tiện ích bổ sung đó. Khi bạn phát hành một tiện ích bổ sung, một tài khoản người dùng sẽ đóng vai trò là nhà xuất bản. Tài khoản phát hành phải có quyền chỉnh sửa dự án tập lệnh bổ sung, nhưng không cần phải là chủ sở hữu dự án.
Bạn cần tránh những trường hợp mất quyền truy cập vào mã hoặc chế độ cài đặt của một tiện ích bổ sung do chủ sở hữu dự án đã rời khỏi tổ chức của bạn.
Để tránh mất quyền truy cập vào mã tiện ích bổ sung, bạn nên sử dụng ổ đĩa dùng chung khi cộng tác trên một tiện ích bổ sung. Việc đặt tệp tập lệnh tiện ích bổ sung vào một bộ nhớ dùng chung sẽ đảm bảo rằng không có tài khoản nào là chủ sở hữu duy nhất của dự án.
Bạn cũng nên thêm cộng tác viên vào dự án Cloud Platform (GCP) của dự án tập lệnh. Điều này giúp đảm bảo rằng luôn có người trong nhóm của bạn có thể truy cập vào chế độ cài đặt trên đám mây của tiện ích bổ sung.
Mã hoá tiện ích bổ sung
Sau khi tạo dự án tập lệnh, bạn có thể bắt đầu viết mã để xác định giao diện và hành vi của tiện ích bổ sung. Bạn sử dụng Apps Script HtmlService để tạo giao diện người dùng của tiện ích bổ sung – hộp thoại và thanh bên – bằng HTML và CSS thông thường. Tiện ích bổ sung của Trình chỉnh sửa cũng có thể xác định các mục trong trình đơn tuỳ chỉnh.
Khi bạn lập trình, hãy tham khảo hướng dẫn về kiểu tiện ích bổ sung của Trình chỉnh sửa để biết các nguyên tắc về cách thiết kế trải nghiệm người dùng cho tiện ích bổ sung. Ngoài ra, hãy nhớ hiểu rõ và lập trình cho các trạng thái vòng đời uỷ quyền mà tiện ích bổ sung của bạn có thể gặp phải.
Kiểm thử tiện ích bổ sung
Bạn có thể kiểm thử các tiện ích bổ sung của Trình chỉnh sửa trước khi phát hành để đảm bảo chúng hoạt động như mong đợi. Để kiểm thử, bạn cần tạo một cấu hình kiểm thử và sử dụng tài liệu, bảng tính, biểu mẫu hoặc bản trình bày kiểm thử.
Hãy xem phần Kiểm thử tiện ích bổ sung của Trình chỉnh sửa để biết thông tin chi tiết.
Xuất bản tiện ích bổ sung
Khi bạn xuất bản tiện ích bổ sung, tiện ích đó sẽ được cung cấp cho người khác, công khai hoặc chỉ dành cho người dùng trong miền của bạn. Trước khi bắt đầu quy trình xuất bản, hãy nhớ xem lại tổng quan về ấn bản.
Tiện ích bổ sung cho Trình chỉnh sửa được phát hành trên Google Workspace Marketplace. Các tiện ích bổ sung được cung cấp công khai phải hoàn tất quy trình xem xét tiện ích bổ sung trước khi được xuất bản.
Hãy xem phần Xuất bản tiện ích bổ sung cho Trình chỉnh sửa để biết thêm thông tin chi tiết.