Các phương pháp hay nhất

Hãy cải thiện trải nghiệm tổng thể của người dùng bằng cách làm theo các hướng dẫn sau về thiết kế tiện ích bổ sung.

Các phương pháp hay nhất nói chung

Bạn nên làm theo các phương pháp hay nhất sau đây cho tất cả tiện ích bổ sung mà bạn phát triển.

Xác định quyền sở hữu tiện ích bổ sung trước khi bắt đầu

tiện ích bổ sung được xác định bởi các dự án Apps Script. Các tiện ích này phải thuộc sở hữu của một tài khoản cụ thể hoặc được đặt trong một bộ nhớ dùng chung. Trước khi lập trình một tiện ích bổ sung, hãy xác định tài khoản nào sẽ sở hữu dự án và tài khoản nào đóng vai trò là nhà xuất bản của dự án đó. Đồng thời, xác định những tài khoản sẽ đóng vai trò là cộng tác viên và đảm bảo rằng các tài khoản đó có quyền truy cập vào dự án tập lệnh và dự án Nền tảng đám mây được liên kết với dự án đó.

Mở rộng Google Workspace, không sao chép

tiện ích bổ sung nhằm mục đích cung cấp các chức năng mới cho các ứng dụng Google Workspace mà chúng mở rộng hoặc tự động hoá các tác vụ phức tạp. Tiện ích bổ sung chỉ sao chép chức năng đã có trong ứng dụng hoặc những tiện ích không thực hiện được những cải tiến đáng kể cho quy trình công việc sẽ không vượt qua được quy trình đánh giá tiện ích bổ sung để phát hành.

Thu hẹp phạm vi

Khi xác định rõ ràng phạm vi của bạn, hãy luôn chọn nhóm phạm vi có ít quyền nhất có thể. Ví dụ: không cấp cho tiện ích bổ sung có quyền truy cập đầy đủ vào Lịch của người dùng ở phạm vi https://www.googleapis.com/auth/calendar nếu ứng dụng đó chỉ cần quyền đọc. Đối với quyền chỉ có thể đọc, hãy sử dụng phạm vi https://www.googleapis.com/auth/calendar.readonly.

Tránh phụ thuộc quá nhiều vào thư viện

Việc sử dụng thư viện Apps Script có thể khiến tiện ích bổ sung của bạn chạy chậm hơn so với khi tất cả các mã Apps Script đều có trong một dự án tập lệnh duy nhất. Mặc dù thư viện Apps Script hoạt động trong các tiện ích bổ sung, nhưng bạn có thể bị giảm hiệu suất nếu sử dụng các tiện ích này. Tránh đưa các thư viện không cần thiết vào dự án và cân nhắc các cách giảm sự phụ thuộc vào tiện ích bổ sung.

Độ trễ được mô tả ở trên chỉ áp dụng cho các dự án Apps Script đang được dùng làm thư viện phía máy chủ. Bạn có thể thoải mái sử dụng các thư viện JavaScript phía máy khách như jQuery mà không gặp phải độ trễ này.

Các phương pháp hay nhất về Tiện ích bổ sung dành cho trình chỉnh sửa

Các phương pháp hay nhất sau đây chỉ áp dụng cho Tiện ích bổ sung dành cho trình chỉnh sửa}.

Đặt HTML của giao diện vị trí và JavaScript phía máy khách trong các tệp tập lệnh riêng

Bạn có thể tạo nhiều tệp tập lệnh trong một dự án Apps Script. Việc quản lý một tiện ích bổ sung phức tạp sẽ dễ dàng hơn nếu bạn đặt HTML và JavaScript xác định thanh bên và hộp thoại của tiện ích bổ sung trong các tệp tập lệnh dành riêng cho các tiện ích bổ sung này.

Kiểm thử kỹ lưỡng ở các chế độ uỷ quyền khác nhau

Khi kiểm thử tiện ích bổ sung, hãy nhớ thử các cấu hình có nhiều tệp và trạng thái uỷ quyền khác nhau.