ユーザーが 1 つ以上のサービスを使用するためにこのスクリプトを承認する必要があるかどうかを判断し、承認ダイアログの URL を提供するために使用するオブジェクト。スクリプトが、インストール可能なトリガーを使用するアドオンとして公開されている場合は、この情報を使用して、ユーザーが必要な承認を得ていないコード セクションへのアクセスを制御できます。または、問題を解決するために、認証ダイアログで URL を開くようユーザーに求めることもできます。
このオブジェクトは ScriptApp.getAuthorizationInfo(authMode)
によって返されます。他の認証モードではユーザーが承認を行う必要がないため、ほとんどの場合、スクリプトは ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL)
を呼び出す必要があります。
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
getAuthorizationStatus() | AuthorizationStatus | ユーザーが 1 つ以上のサービス(例: ScriptApp.AuthorizationStatus.REQUIRED )を使用するためにこのスクリプトを承認する必要があるかどうかを示す値を取得します。 |
getAuthorizationUrl() | String | スクリプトへのアクセスを許可するために使用できる承認 URL を取得します。 |
詳細なドキュメント
getAuthorizationStatus()
ユーザーが 1 つ以上のサービスを使用するためにこのスクリプトを承認する必要があるかどうかを示す値を取得します(例: ScriptApp.AuthorizationStatus.REQUIRED
)。
// Log the authorization status (REQUIRED or NOT_REQUIRED). var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationStatus());
リターン
AuthorizationStatus
- 承認ステータス
getAuthorizationUrl()
スクリプトへのアクセスを許可するために使用できる承認 URL を取得します。承認が不要な場合、このメソッドは null
を返します。URL のページがアクセスされると、その URL のページは自動的に閉じます。スクリプトは承認を必要としません。
// Log the URL used to grant access to the script. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
リターン
String
- スクリプトの承認に使用できる URL