アドオンの設計に関するガイドに沿って、ユーザーの全体的なエクスペリエンスを改善します。
一般的なベスト プラクティス
開発するすべてのアドオンで、次のベスト プラクティスに従うことをおすすめします。
開始前にアドオンの所有権を特定する
アドオンは Apps Script プロジェクトで定義されます。このプロジェクトは、特定のアカウントが所有するか、共有ドライブに配置する必要があります。アドオンをコーディングする前に、プロジェクトを所有するアカウントと、パブリッシャーとして機能するアカウントを決定します。また、コラボレーション パートナーとして機能するアカウントを決定し、それらのアカウントがスクリプト プロジェクトとそれに関連付けられた Cloud Platform プロジェクトにアクセスできることを確認します。
Google Workspace を拡張する、複製しない
アドオンは、拡張する Google Workspace アプリケーションに新しい機能を提供するか、複雑なタスクを自動化することを目的としています。アプリケーション内にすでに存在する機能を単に複製するアドオンや、ワークフローを大幅に改善しないアドオンは、公開のためのアドオン審査に合格しない可能性があります。
スコープを狭くする
スコープを明示的に定義する場合は、可能な限り制限の少ないスコープ セットを選択してください。たとえば、読み取りアクセス権のみが必要な場合は、https://www.googleapis.com/auth/calendar スコープでユーザーのカレンダーへの完全アクセス権をアドオンがリクエストしないようにします。読み取り専用アクセスの場合は、https://www.googleapis.com/auth/calendar.readonly スコープを使用します。
ライブラリに過度に依存しない
Apps Script のライブラリを使用すると、すべての Apps Script コードが 1 つのスクリプト プロジェクトに含まれている場合よりも、アドオンの実行速度が遅くなる可能性があります。Apps Script ライブラリはアドオンで動作しますが、使用するとパフォーマンスが低下する可能性があります。プロジェクトに不要なライブラリを含めないようにし、アドオンのライブラリへの依存を減らす方法を検討してください。
上記のレイテンシは、サーバーサイド ライブラリとして使用される Apps Script プロジェクトにのみ適用されます。jQuery などのクライアントサイド JavaScript ライブラリは、このレイテンシが発生することなく自由に使用できます。
エディタ アドオンのベスト プラクティス
次のベスト プラクティスは、エディタ アドオンにのみ適用されます}。
インターフェースの HTML とクライアントサイド JavaScript を独自のスクリプト ファイルに配置する
Apps Script プロジェクトには複数のスクリプト ファイルを作成できます。複雑なアドオンを管理する際は、アドオンのサイドバーとダイアログを定義する HTML と JavaScript を、それ専用のスクリプト ファイルに配置すると管理しやすくなります。
さまざまな認可モードで徹底的にテストする
アドオンをテストする際は、異なるファイルと異なる承認状態の構成を試してください。