アドオンをインストールして承認する

ユーザーは、事前にアドオンをインストールして承認する必要があります 開いて使用できます。これらのステップは、トレーニングの 理解する必要があるのは 独自のアドオンの作成を始める前に

このドキュメントでは、ユーザーがインストール、認証、 できます。

アドオンをインストールする

アドオンを使用するには、その前にアドオンをインストールする必要があります。 インストールが完了すると、 Google Workspace ホスト アプリケーション あります。

公開されたアドオンは、 Google Workspace ホスト アプリケーション、または Google Workspace Marketplace: また、ドメイン管理者は、ユーザーの代わりに Google Workspace Marketplace から 購入できますまた、 非公開のアドオンのインストール それらをテストすることができます。インストール済みの 初めて使用する場合は、 承認 できます。

詳しくは、 アドオンを公開する

アドオンを承認する

インストールしたアドオンは、 Google Workspace ホスト アプリケーション あります。ユーザーが初めて ホスト アプリケーションのアドオンから 認証カードまたはダイアログ。このカードでは ユーザーに対して次のような操作を行うための権限が必要です。 現在の Google スプレッドシートのコンテンツにアクセスします。ユーザーはそれらの権限を アドオンの続行を許可します。もし ユーザーがアドオンを拒否した場合 アドオンを使用できないためです。

エディタのアドオンで使用される認可モデルは、 Google Workspace アドオン。 エディタのアドオンは Google ドライブのファイルに対して機能するため、 エディタの認可モデルでは、認証時に適用されるさまざまな認証モードが 個々のファイルで使用されます。開発環境では、 さまざまなモードとオプションの違いを 両者間でのアドオンの移動方法についても 学びます

公開済みのアドオンを承認する

公開済みのアドオンをインストールすると、すぐに承認フローが開始されます。

  1. アドオンをインストールするアカウントを選択するよう求められます。
  2. その後、アドオンの承認のリストが表示されます。 それにより、何を行うのかを把握できます。レビュー 慎重に承認してください。それでも承認が必要な場合は、 [許可] をクリックします。これにより、アドオンが使用可能になります。
  3. ここから実行できるようになります。 ホスト アプリケーション あります。アプリケーションをブラウザタブですでに開いていた場合は、 アドオンが利用可能になる前にタブを更新する必要があります。

インストールしたアドオンが後で更新され、追加の 許可する場合は、それらの認証情報を指定するように 次回アドオンを使用するときに設定されます。

非公開の 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 メソッド) は ConferenceData 含まれる ConferenceError認証 URL

このオブジェクトを受け取ると、Google カレンダーで [ログイン] ボタンが作成され、 アドオンが提供する認証 URL にリンクされたイベント編集 UI。 ユーザーは、事前にこのボタンを使用して、 そのアドオンを使用することになります

サードパーティの会議を作成するをご覧ください。 ConferenceError を使用した承認の処理について詳しくは、こちらをご覧ください。

非公開のエディタ アドオンを承認する

エディタのアドオンをテストすることをおすすめします。 重要な役割を果たします承認フローは 公開されているエディタ アドオンが対象です。ただし、次のフローは は、アドオンを最初にテストしようとしたときに開始されます。後でもう一度同じルールをテストすると、 承認を求められることはありません。

アドオンの承認を取り消す

アドオンを開発する際は、再テストできるようにアドオンを認証解除しておくと便利です。 確認します。

アドオンの承認を解除する手順は次のとおりです。

  1. アカウント セキュリティ コンソールを開きます。
  2. 許可を取り消すアドオンを見つけてクリックします。
  3. [アクセス権を削除] をクリックします。

アドオンを認可解除した後に再度実行すると、 再度表示されます。