Class AuthorizationInfo

認可情報

ユーザーが 1 つ以上のサービスを使用するためにこのスクリプトを承認する必要があるかどうかを判断し、承認ダイアログの URL を提供するのに使用されるオブジェクト。スクリプトがインストール可能なトリガーを使用するアドオンとして公開されている場合、この情報を使用して、ユーザーに必要な認可がないコードセクションへのアクセスを制御できます。または、アドオンで、問題を解決するために承認ダイアログの URL を開くようユーザーに求めることもあります。

このオブジェクトは ScriptApp.getAuthorizationInfo(authMode) によって返されます。他の認可モードではユーザーによる認可が不要であるため、ほとんどの場合、スクリプトは ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) を呼び出す必要があります。

メソッド

メソッド戻り値の型概要
getAuthorizationStatus()AuthorizationStatus1 つ以上のサービス(ScriptApp.AuthorizationStatus.REQUIRED など)を使用するようにこのスクリプトを承認する必要があるかどうかを示す値を取得します。
getAuthorizationUrl()Stringスクリプトへのアクセス権の付与に使用できる認証 URL を取得します。

詳細なドキュメント

getAuthorizationStatus()

1 つ以上のサービス(ScriptApp.AuthorizationStatus.REQUIRED など)を使用するようにこのスクリプトを承認する必要があるかどうかを示す値を取得します。

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

戻る

AuthorizationStatus - 承認ステータス


getAuthorizationUrl()

スクリプトへのアクセス権を付与するために使用できる認証 URL を取得します。承認が不要な場合、このメソッドは null を返します。URL のページにアクセスし、スクリプトに認証が不要な場合、そのページは自動的に閉じます。

// Log the URL used to grant access to the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

戻る

String - スクリプトの認証に使用できる URL