ユーザーは、アドオンを開いて使用する前にインストールして承認する必要があります。以下の手順は、アドオンのユーザー エクスペリエンスの第一歩であるため、独自のアドオンを作成する前に、理解しておく必要があります。
このドキュメントでは、ユーザーが Google Workspace アドオンをインストール、承認、使用する方法について説明します。
アドオンをインストールする
アドオンを使用するには、そのアドオンをインストールする必要があります。 インストールすると、拡張された Google Workspace のホストアプリケーションでアドオンを使用できるようになります。
公開済みのアドオンは、Google Workspace ホストアプリケーションまたは Google Workspace Marketplace からインストールできます。ドメイン管理者が、ユーザーに代わって Google Workspace Marketplace からアドオンをインストールすることもできます。開発中の非公開アドオンをインストールして、それらをテストすることもできます。インストール済みのアドオンを初めて使用する場合は、事前に承認する必要があります。
詳しくは、アドオンを公開するをご覧ください。
アドオンを承認する
アドオンをインストールすると、拡張された Google Workspace のホストアプリケーションでアドオンを利用できるようになります。ユーザーがホストアプリでアドオンを初めて使用しようとすると、承認カードまたはダイアログが表示されます。このカードには、現在の Google スプレッドシートのコンテンツにアクセスするなど、アドオンがユーザーのために権限を必要とする理由が記載されています。ユーザーはこれらの権限を付与し、アドオンを続行できます。ユーザーがアドオンの承認を拒否した場合、そのアドオンは使用できません。
エディタ アドオンは、Google Workspace アドオンとは異なる認証モデルを使用します。エディタ アドオンは Google ドライブのファイルに対して動作するため、エディタ承認モデルは、アドオンが個々のファイルで使用されるときに発生するさまざまな認証モードを定義します。エディタ アドオンを開発する際は、各モードと、アドオンが各モード間をどのように移動するかを理解することが重要です。
詳細については、認可をご覧ください。
アドオンを開始
アドオンをインストールして承認すると、拡張されたホストアプリケーションでアドオンを使用できるようになります。
Google Workspace アドオンは、ホストアプリケーションのデスクトップまたはモバイル UI にアドオンを表すアイコンを表示します。ユーザーはこのアイコンをクリックして、アドオンを開始または終了できます。
エディタ アドオンは通常、エディタのアドオン メニューに少なくとも 1 つのメニュー オプションを表示し、ユーザーがアドオンの使用を開始できるようにします。
詳しくは、アドオンの開始をご覧ください。