認証

アドオンが動作するにはユーザーの承認が必要です。これは、Google Workspace Marketplace からインストールした公開済みのアドオンと、自身で開発しているアドオンの両方に当てはまります。

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

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

  1. アドオンをインストールするアカウントを選択するよう求められます。
  2. その後、アドオンの動作に必要な承認のリストが表示され、アドオンが何をしようとしているかがわかります。このリストをよく確認し、それでも権限を付与する場合は [許可] をクリックします。これでアドオンを使用できるようになります。
  3. これで、拡張されたホストアプリからテストを実行できるようになりました。アプリケーションがすでにブラウザタブで開かれている場合は、アドオンが使用可能になる前にタブを更新する必要がある場合があります。

インストールしたアドオンが後で更新され、まだ付与していない追加の承認が必要な場合は、アドオンを次回使用する際にこれらの権限を付与するように求められます。

非公開の Google Workspace アドオンを承認する

アドオン承認カード

非公開のアドオンは Google Workspace Marketplace にまだリストされていないため、公開済みのアドオンと同じ承認フローはありません。非公開のアドオンをインストールした後、すぐに承認を求められるわけではありません。代わりに、アドオンを初めて使用したときに認可フローが開始されます。

アドオンの実行時に、ユーザー認証が必要かどうかを判断します。承認が必要な場合は、アドオンによって承認カードが表示されます。アドオンを初めて実行するときには、常に承認が必要になります。また、以前に承認されていないサービスを新しいバージョンのアドオンで使用する場合にも承認が必要になることがあります。[アクセスを許可] ボタンをクリックすると、アドオンの認証を許可または拒否するためのダイアログ ウィンドウが表示されます。

Google 以外のサービスに対する Google Workspace アドオンの承認

Google Workspace アドオン自体が認可を必要とするサードパーティ サービスに接続することは可能です。このようなサービスに接続する Google Workspace アドオンには、ユーザーが次の 2 つのアクションを行う必要があります。

  • アドオンのインストール時または初回起動時のアドオン自体の承認。
  • Google 以外のサービスに対する初回アクセスの承認。

開発中の Google Workspace アドオンが OAuth を使用して Google 以外のサービスにアクセスする必要がある場合は、アドオンの作成時に、そのサービスの接続を構成する必要があります。

Google 以外のサービスの承認が必要な場合は、Google Workspace アドオンによって、そのサービスの承認プロンプト カードがユーザーに表示されます。必要に応じてこの承認プロンプトをカスタマイズすることも、デフォルトのカードを使用することもできます。

詳しくは、Google 以外のサービスへの接続ガイドをご覧ください。

サードパーティの会議システム

Google カレンダーを拡張する Google Workspace アドオンによって、ユーザーが Google カレンダーの予定を編集する際にサードパーティの会議システムを選択できる会議ソリューションも追加できます。アドオンの会議オプションにユーザーがログインを求める場合は、そのオプションをユーザーに提供する必要があります。

ユーザーがログインせずにアドオンを使用して会議を作成しようとすると、会議ソリューションの onCreateFunction メソッドは、認証 URL を含む ConferenceError を含む ConferenceData オブジェクトを返す必要があります。

このオブジェクトを受け取ると、Google カレンダーの予定編集 UI に、アドオンが提供する認証 URL にリンクする [ログイン] ボタンが作成されます。ユーザーはこのボタンを使用して、アドオンを使用する前にサードパーティのシステムにログインすることができます。

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

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

開発時にエディタ アドオンをテストすることをおすすめします。承認フローは、公開済みのエディタ アドオンの場合と同じですが、アドオンを最初にテストしようとしたときにフローが開始される点が異なります。後で同じアドオンをテストする際に、再度承認を求められることはありません。

アドオンの承認取り消し

アドオンを開発する場合、認可フローを再テストできるように承認を解除すると便利です。

アドオンの許可を取り消す方法は次のとおりです。

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

承認を解除した後にアドオンを再度実行すると、承認フローが再び表示されます。