ユーザーがアドオンを開いて使用するには、アドオンをインストールして承認する必要があります。これらのステップは、トレーニングの 理解する必要があるのは 独自のアドオンの作成を始める前に
このドキュメントでは、ユーザーがインストール、承認、 できます。
アドオンをインストールする
アドオンを使用するには、まずアドオンをインストールする必要があります。インストールが完了すると、 Google Workspace ホスト アプリケーション あります。
公開されたアドオンは、Google Workspace ホスト アプリケーションまたは Google Workspace Marketplace からインストールできます。ドメイン管理者は、ユーザーの代わりにアドオンをインストール Google Workspace Marketplace から 購入できますまた、 非公開のアドオンのインストール それらをテストすることができます。インストール済みの 初めて使用する場合は、 承認 できます。
詳しくは、 アドオンを公開する。
アドオンを承認する
インストールしたアドオンは、 Google Workspace ホスト アプリケーション あります。ユーザーがアドオンを初めて使用しようとすると、ホスト アプリケーションから承認カードまたはダイアログが表示されます。このカードには、現在の Google スプレッドシートのコンテンツへのアクセスなど、アドオンがユーザーに対して行うために権限が必要な操作について説明されています。ユーザーは、これらの権限を付与してアドオンの実行を許可できます。ユーザーがアドオンの承認を拒否した場合、そのアドオンは使用できません。
Editor アドオンは、Google Workspace アドオンとは異なる認可モデルを使用します。エディタ アドオンは Google ドライブ ファイルで動作するため、エディタの承認モデルでは、アドオンが個々のファイルで使用された場合に発生するさまざまな承認モードが定義されています。エディタ アドオンを開発する際は、さまざまなモードと、アドオンがそれらのモード間を移動する方法について理解しておくことが重要です。
公開済みのアドオンを承認する
公開済みのアドオンをインストールすると、すぐに承認フローが開始されます。
- アドオンをインストールするアカウントを選択するよう求められます。
- アドオンの動作に必要な認可のリストが表示されます。このリストで、アドオンが何をしようとしているかを確認します。このリストをよく確認し、それでも認可する場合は [許可] をクリックします。これにより、アドオンを使用できるようになります。
- ここから実行できるようになります。 ホスト アプリケーション あります。アプリケーションがすでにブラウザタブで開いている場合は、アドオンが使用可能になる前にタブを更新する必要があります。
インストールしたアドオンが後で更新され、まだ付与していない追加の承認が必要な場合は、次回アドオンを使用するときに、その権限を付与するよう求められます。
非公開の Google Workspace アドオンを承認する
公開されていないアドオンの承認フローは、公開済みアドオンと同じではありません まだ Google Workspace Marketplace に掲載されていないためです。公開されていないアドオンをインストールしても、すぐに承認を求められることはありません。承認フローは は、アドオンを最初に使用しようとしたときに開始されます。
アドオンの実行時に、ユーザー承認が必要かどうかが判断されます。承認が必要な場合は、アドオンが承認カードを提示します。アドオンを初めて実行する際には、常に承認が必要です。また、新しいバージョンのアドオンで、以前に承認されていないサービスが使用されている場合にも、承認が必要になることがあります。[Authorize Access] ボタンをクリックすると、に対するダイアログ ウィンドウが表示されます。 アドオンの承認を [許可] または [拒否] に設定します。
Google Workspace アドオンで Google 以外のサービスを承認する
Google Workspace アドオンは、それ自体が認証を必要とするサードパーティ サービスに接続できます。当該サービスに接続する Google Workspace アドオン ユーザーに 2 つのアクションが必要です。
- アドオンのインストール時または初回起動時のアドオン自体の承認。
- Google 以外のサービスへの初回アクセス時の認可。
Google Workspace アドオンでニーズを検討している場合 OAuth を使用して Google 以外のサービスにアクセスするには、 接続を構成する そのサービスに対して追加することもできます。
詳細については、このモジュールの Google Workspace アドオンをサードパーティ サービスに接続します。
サードパーティ製会議システム
Google カレンダーを拡張する Google Workspace アドオン スペースに 会議ソリューション ユーザーが編集時にサードパーティの会議システムを選択できる Google カレンダーの予定。アドオンで、ユーザーがログインする必要がある会議オプションを提供している場合は、ユーザーがログインできるようにする必要があります。
ユーザーが必要なログインなしでアドオンを使用して会議を作成しようとした場合、会議ソリューションの onCreateFunction メソッドは、認証 URL を含む ConferenceError を含む ConferenceData オブジェクトを返す必要があります。
このオブジェクトを受け取ると、Google カレンダーは、アドオンが提供する認証 URL にリンクする [ログイン] ボタンをイベント編集 UI に作成します。ユーザーは、アドオンをさらに使用する前に、このボタンを使用してサードパーティ システムにログインできます。
サードパーティの会議を作成するをご覧ください。
ConferenceError を使用した承認の処理について詳しくは、こちらをご覧ください。
非公開のエディタ アドオンを承認する
エディタ アドオンを開発する際にテストすることをおすすめします。承認フローは、アドオンを初めてテストしようとしたときに開始される点を除き、公開済みのエディタ アドオンの場合と同じです。後でもう一度同じルールをテストすると、 承認を求められることはありません。
アドオンの承認を取り消す
アドオンを開発する際は、再テストできるようにアドオンの承認を解除すると便利です。 確認します。
アドオンの承認を取り消す手順は次のとおりです。
- アカウント セキュリティ コンソールを開きます。
- 承認を取り消すアドオンを見つけてクリックします。
- [アクセス権を削除] をクリックします。
アドオンを認可解除した後に再度実行すると、 再度表示されます。
アドオンをアンインストールする
Google Workspace Marketplace からインストールしたアドオンをアンインストールするには、Marketplace アプリまたはアドオンをアンインストールするをご覧ください。
組み込みの非公開アドオンをアンインストールするには Apps Script については、未公開のアンインストールと アドオン。