Tạo tiện ích bổ sung cho Trình chỉnh sửa

Trước khi tạo tiện ích bổ sung cho Trình chỉnh sửa, hãy xem 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 tuân thủ các nguyên tắc này. Việc làm quen với những giới hạn này ngay từ đầu trong quá trình phát triển có thể giúp bạn tránh được các vấn đề tiềm ẩn sau này. Apps Script là lựa chọn lý tưởng để phát triển tiện ích bổ sung đơn giản cho chính bạn, nhóm của bạn hoặc tổ chức của bạn. Tuy nhiên, nếu bạn dự định tạo 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 cần toàn quyền kiểm soát cơ sở hạ tầng của mình, hãy cân nhắc việc phát triển một tiện ích bổ sung Google Workspace trên một môi trường thời gian chạy khác.

Hãy làm theo quy trình chung này khi tạo một tiện ích bổ sung cho Editor:

  1. Tạo một dự án Apps Script.
  2. Viết mã để xác định giao diện và hành vi của tiện ích bổ sung bằng cách sử dụng dịch vụ HTML tích hợp của Apps Script.
  3. Kiểm thử tiện ích bổ sung.
  4. Xuất bản tiện ích bổ sung.

Tạo dự án tập lệnh

Tiện ích bổ sung dành 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 cách 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 duy nhất sẽ sở hữu dự án tiện ích bổ sung đó. Khi bạn xuất bản một tiện ích bổ sung, một tài khoản người dùng duy nhất sẽ đóng vai trò là nhà xuất bản. Tài khoản xuất bản phải có quyền chỉnh sửa đối với dự án tập lệnh của tiện ích bổ sung, nhưng không cần phải là chủ sở hữu dự án.

Bạn cần tránh 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 vì 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 của tiện ích bổ sung vào bộ nhớ dùng chung đả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. Việc 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 Cloud của tiện ích bổ sung.

Mã hoá tiện ích bổ sung

Sau khi tạo một 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 tuỳ chỉnh trong trình đơn.

Khi bạn viết mã, hãy tham khảo Hướng dẫn về kiểu của tiện ích bổ sung cho 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 đảm bảo bạn hiểu và lập trình cho các trạng thái vòng đời uỷ quyền khác nhau 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 cho Trình chỉnh sửa trước khi chúng được xuất bản để đả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 một 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 bài viết Kiểm thử một 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, người khác có thể sử dụng tiện ích bổ sung của bạn, cho dù là công khai hay chỉ những 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 thông tin tổng quan về ấn phẩm.

Các tiện ích bổ sung cho trình chỉnh sửa được xuất bản 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 đánh giá 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.