Class AuthorizationInfo

AuthorizationInfo

Kullanıcının komut dosyasının gerekli kapsamları için yetki verip vermediğini kontrol eden bir nesne. Nesne, kullanıcıların bu izinleri vermesi için bir yetkilendirme URL'si de sağlar.

Bazı komut dosyası yürütmeleri, komut dosyası tarafından kullanılan tüm gerekli kapsamlar için kullanıcının izni olmadan başlayabilir. Bu nesnedeki bilgiler, belirli kapsamlar gerektiren kod bölümlerine erişimi kontrol etmenize ve sonraki yürütmeler için bu kapsamların yetkilendirmesini istemenize olanak tanır.

Bu öğe ScriptApp.getAuthorizationInfo(authMode) tarafından iade edildi. Başka hiçbir yetkilendirme modu kullanıcıların yetki vermesini gerektirmediğinden, komut dosyaları neredeyse her durumda ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) işlevini çağırmalıdır.

Yöntemler

YöntemDönüş türüKısa açıklama
getAuthorizationStatus()AuthorizationStatusKullanıcının bir veya daha fazla hizmeti (örneğin, ScriptApp.AuthorizationStatus.REQUIRED) kullanmak için bu komut dosyasını yetkilendirmesi gerekip gerekmediğini belirten bir değer alır.
getAuthorizationUrl()StringKomut dosyasına erişim izni vermek için kullanılabilecek yetkilendirme URL'sini alır.
getAuthorizedScopes()String[]Komut dosyası için yetkili kapsamların listesini alır.

Ayrıntılı dokümanlar

getAuthorizationStatus()

Kullanıcının bir veya daha fazla hizmeti (örneğin, ScriptApp.AuthorizationStatus.REQUIRED) kullanmak için bu komut dosyasını yetkilendirmesi gerekip gerekmediğini belirten bir değer alır.

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

Return

AuthorizationStatus: Yetkilendirme durumu


getAuthorizationUrl()

Komut dosyasına erişim izni vermek için kullanılabilecek yetkilendirme URL'sini alır. Yetkilendirme gerekli değilse bu yöntem null değerini döndürür. URL'ye erişilirse ve komut dosyası herhangi bir yetkilendirme gerektirmiyorsa URL'deki sayfa otomatik olarak kapanır.

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

Return

String: Komut dosyasını yetkilendirmek için kullanılabilecek bir URL


getAuthorizedScopes()

Komut dosyası için yetkili kapsamların listesini alır. Belirli bir kapsam listesi için yetkilendirme bilgileri istenirse belirtilen listedeki yetkili kapsamları döndürür.

// Logs which scopes in the specified list have been authorized for the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https: //www.googleapis.com/auth/documents',
  'https: //www.googleapis.com/auth/spreadsheets',
]);
Logger.log(authInfo.getAuthorizedScopes());

Return

String[]: Yetkili kapsamların listesi.