制限

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

一般的な制限事項

すべてのアドオンに次の制限が適用されます。次のことは行わないでください。

Google Workspace の機能を変更する

アドオン フレームワークは、Google Workspace アプリケーションを強化するために設計されており、制限を追加するためのものではありません。そのため、既存の機能を変更したり、Google Workspace ドキュメントの共有モデルをロックダウンしたりすることはできません。

インストール時にユーザーに課金する

アドオンのインストールに対してユーザーに課金する方法は提供されていません。また、アドオンに広告を含めることはできません。ただし、独自の支払いシステムをロールアウトしたり、既存の請求データベースを呼び出したりすることはできます。アドオンは、ユーザーに請求する Google 以外のサービスに接続できます。

多くのイベントを検出する

特定のトリガーを除き、アドオンはユーザーがアドオン外で行った操作を認識できません。たとえば、ユーザーがホスト アプリケーションのツールバーをクリックしたタイミングを検出することはできません。サイドバーのクライアントサイド コードからファイルの内容の変更をポーリングすることは可能ですが、常にわずかな遅延が発生します。

Google Workspace アドオン

次の制限は、Google Workspace アドオンと Card サービスの使用にのみ適用されます。次のことは行わないでください。

すべての 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 個までです。