ユーザーが 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 のページにアクセスすると、スクリプトは承認を必要としない場合は自動的に閉じます。
// Log the URL used to grant access to the script. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
戻る
String
- スクリプトの認証に使用できる URL