次の場所にある Apps Script ドキュメントから:
https://developers.google.com/apps-script/add-ons/lifecycle#installing
インストール
アドオンがストアからインストールされると、その onInstall(e) 関数が AuthMode.FULL で実行されます。これにより、アドオンは複雑なセットアップ ルーチンを実行できますが、onInstall(e) を使用してメニュー項目を作成することも重要です。これは、ドキュメントが既に開いているため、onOpen(e) 関数が実行されていないためです。便宜上、次のサンプルに示すように、onInstall(e) から onOpen(e) を呼び出すことができます。
function onInstall(e) {
onOpen(e);
// Perform additional setup as needed.
}
認証ライフ サイクルは混乱する可能性があります。
onInstall() は、アドオンがインストールされたときに 1 回だけ実行されます。フル アクセス モードで実行されるため、すべての Apps Script サービスにアクセスできます。
onOpen() は、ユーザーがアドオンをインストールした後にドキュメントを開くたびに実行されます。
onOpen() には、NONE または LIMITED の 2 つのモードがあります。
NONE: ユーザーは以前にアドオンをインストールしましたが、現在のドキュメントに対して有効にしていません。この時点でできることは、メニュー項目を作成することだけです。現在のドキュメントのアドオンを有効にするには、ユーザーはメニュー項目の 1 つを選択する必要があります。有効にすると、そのドキュメントに対して常に有効になります (アドオンが OAuth スコープを変更し、ユーザーによる再認証が必要な場合を除きます)。
LIMITED: ユーザーは現在のドキュメントのアドオンを有効にしましたが、メニューまたは UI からアドオンを使用していません。ドキュメント UI への完全なアクセス権があり、ユーザー プロパティ サービスにアクセスできます。