アドオンでできることにはいくつかの制限があります。これらの落とし穴を回避して、ユーザーの全体的なエクスペリエンスを改善しましょう。
一般的な制限事項
すべてのアドオンに次の制限が適用されます。次のような対応は行わないでください。
Google Workspace の機能を変更する
アドオン フレームワークは、制限を追加するのではなく、Google Workspace アプリケーションを強化するように設計されています。そのため、既存の機能を変更したり、Google Workspace のドキュメント共有モデルをロックダウンしたりすることはできません。
インストール料金をユーザーに請求する
アドオンのインストールに対してユーザーに料金を請求する方法は提供されていません。また、アドオンに広告を含めることはできません。ただし、独自のお支払いシステムをロールアウトしたり、既存の課金データベースを呼び出したりすることもできます。アドオンは、ユーザーに請求を行う Google 以外のサービスに接続できます。
多くのイベントを検出する
特定のトリガーを除き、アドオンはアドオン自体の外部でユーザーが何をしているかを知ることはできません。たとえば、ユーザーがホスト アプリケーションのツールバーをクリックしたタイミングを検出することはできません。サイドバーのクライアントサイド コードからファイルの内容の変更をポーリングすることは可能ですが、常にわずかな遅延が発生します。
Google Workspace アドオン
次の制限は、Google Workspace アドオンとカード サービスの使用にのみ適用されます。次のような対応は行わないでください。
すべての Google Workspace アプリを拡張する
Google Workspace アドオンは、Gmail、カレンダー、ドライブ、ドキュメント、スプレッドシート、スライドのみを拡張できます。最終的には、Google Workspace アドオンを使用して他の Google Workspace アプリケーションを拡張できるようになります。
ドライブのコンテキスト トリガー
Google Workspace アドオンでコンテキスト トリガーを設定できるのは、Gmail でメールの読み取りまたは作成中、カレンダーで予定が開いているときのみです。ドライブ ファイルのコンテキスト トリガーはまだサポートされていません。暫定的な開発手法をご覧ください。
エディタのドキュメント コンテキスト
Google Workspace アドオンは、エディタでドキュメント コンテキストの使用をまだサポートしていません。つまり、SpreadsheetApp.getActiveSpreadsheet() などのメソッドを使用して現在のドキュメントを取得することはできません。暫定的な開発手法をご覧ください。
HTML/CSS またはクライアントサイド スクリプトを使用する
Google Workspace アドオンは、カードベースのインターフェースを使用する必要があります。エディタ アドオンでサポートされている HTML/CSS インターフェースは使用できません。Google Workspace アドオンは、ウィジェット ベースのアプローチでユーザー インターフェースを構築します。これにより、デスクトップ プラットフォームとモバイル プラットフォームでアドオンを適切に動作させることができ、それぞれにインターフェースを構築する必要がなくなります。
モバイル サポートの完全性
現時点では、Google Workspace アドオンはデスクトップ ウェブ クライアントで機能します。コンテキスト トリガー（Gmail メッセージの読み上げ）は、Gmail モバイルアプリ内からもサポートされています。コンテキストに依存しないホームページは、Gmail、カレンダー、ドライブのモバイルアプリではまだ利用できません。Google Workspace アドオンは、モバイル ウェブブラウザではご利用いただけません。
Apps Script トリガーを使用する
Google Workspace アドオンで Apps Script のシンプルなトリガーを作成または使用することはできません。
SVG 画像を使用する
現在、カード サービスのカードとウィジェットで SVG 画像を使用できません。
ウィジェットが 100 個を超えている
パフォーマンス上の理由から、カードに 100 個を超えるウィジェットや 100 個を超えるカード セクションを追加することはできません。