アドオンにはいくつかの制限があります。これらの落とし穴を避けて、ユーザー エクスペリエンスの全体的な向上を図りましょう。
一般的な制限事項
すべてのアドオンに次の制限が適用されます。次のことは行わないでください。
Google Workspace の機能を変更する
アドオン フレームワークは、Google Workspace アプリケーションを強化するために設計されており、制限を追加するためのものではありません。そのため、既存の機能を変更したり、Google Workspace ドキュメント共有モデルをロックダウンしたりすることはできません。
インストール時にユーザーに課金する
アドオンのインストール時にユーザーに課金する方法は提供されていません。また、アドオンに 広告を含めることもできません。ただし、独自の決済システムを構築したり、既存の請求データベースを呼び出したりすることはできます。アドオンは、ユーザーに請求する Google 以外のサービスに接続できます。
多数のイベントを検出する
特定トリガーを除き、アドオン自体以外でユーザーが行った操作をアドオンで把握することはできません。たとえば、ユーザーがホスト アプリケーションのツールバーをクリックしたことを検出することはできません。サイドバーのクライアントサイド コードからファイルの内容の変更をポーリングすることはできますが、常にわずかな遅延が発生します。
Google Workspace アドオン
次の制限は、 Google Workspace アドオンと カード サービスの使用にのみ適用されます。次のことは行わないでください。
すべての Google Workspace アプリを拡張する
Google Workspace アドオンで拡張できるのは、Gmail、カレンダー、ドライブ、Meet、ドキュメント、スプレッドシート、スライドのみです。将来的には、Google Workspace アドオンで他の Google Workspace アプリケーションを拡張できるようになる予定です。
エディタのドキュメント コンテキスト
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 個までです。