制限

アドオンでできることにはいくつかの制限があります。これらの落とし穴を回避して、ユーザーの全体的なエクスペリエンスを改善しましょう。

一般的な制限事項

すべてのアドオンには、次の制限が適用されます。次のような対応は行わないでください。

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 個を超えるウィジェットや 100 個を超えるカード セクションを追加することはできません。