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

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 đây 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

các tiện ích bổ sung được xác định bởi các dự án Apps Script. Các dự án 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 ổ dùng chung. Trước khi lập trình 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 sẽ đóng vai trò là nhà xuất bản của dự án. Ngoài ra, hãy 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 trên Google Cloud Platform liên kết với dự án đó.

Mở rộng Google Workspace, đừng sao chép

Tiện ích bổ sung nhằm cung cấp các tính 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. Những tiện ích bổ sung chỉ sao chép chức năng đã có trong ứng dụng hoặc không cải thiện đáng kể quy trình công việc có thể sẽ không vượt qua được quy trình xem xét tiện ích bổ sung để xuất bản.

Giữ phạm vi hẹp

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

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

Việc sử dụng thư viện Apps Script có thể khiến tiện ích bổ sung chạy chậm hơn so với khi tất cả mã Apps Script được chứa trong một dự án tập lệnh. Mặc dù các thư viện Apps Script hoạt động trong tiện ích bổ sung, nhưng bạn có thể gặp phải tình trạng giảm hiệu suất nếu sử dụng các thư viện đó. 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 của tiện ích bổ sung vào các thư viện đó.

Độ trễ được mô tả ở trên chỉ áp dụng cho các dự án Apps Script đang được sử dụng làm thư viện phía máy chủ. Bạn có thể tự do 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 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 của Trình chỉnh sửa}.

Đặt HTML giao diện 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. Bạn có thể dễ dàng quản lý một tiện ích bổ sung phức tạp hơn nếu đặ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 chúng.

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

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à nhiều trạng thái uỷ quyền.