アドオンによる機能にはいくつかの制限があります。このような問題を回避して、ユーザーの全体的なエクスペリエンスを高めてください。
一般的な制限事項
すべてのアドオンには、次の制限が適用されます。次のことは行わないでください。
Google Workspace の機能を変更する
アドオン フレームワークは Google Workspace アプリケーションを強化するもので、上限を設けるものではありません。そのため、既存の機能を変更したり、Google Workspace のドキュメント共有モデルをロックダウンしたりすることはできません。
ユーザーにインストールを有料で依頼する
Google はアドオンのインストールに対してユーザーに課金する方法を提供していません。また、アドオンに広告を含めることはできません。ただし、独自の決済システムを導入したり、既存の課金データベースに呼び出したりすることは可能です。アドオンは、ユーザーに請求する 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 個以上である
パフォーマンス上の理由から、1 つのカードに追加できるウィジェットは 100 個まで、カード セクションは 100 個までです。