Class AuthorizationInfo

YetkilendirmeBilgileri

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

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

Bu nesne ScriptApp.getAuthorizationInfo(authMode) tarafından döndürülür. Kullanıcıların yetki vermesini gerektiren başka bir yetkilendirme modu olmadığından, komut dosyaları neredeyse tüm durumlarda 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 (ör. ScriptApp.AuthorizationStatus.REQUIRED) kullanmak için bu komut dosyasını yetkilendirmesi gerekip gerekmediğini belirten bir değer alır.
getAuthorizationUrl()String|nullKomut dosyasına erişim izni vermek için kullanılabilecek yetkilendirme URL'sini alır.
getAuthorizedScopes()String[]|nullKomut dosyası için yetkilendirilmiş kapsamların listesini alır.

Ayrıntılı belgeler

getAuthorizationStatus()

Kullanıcının bir veya daha fazla hizmeti (ör. 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. Bu yöntem, yetkilendirme gerekmiyorsa null değerini döndürür. URL'deki sayfaya erişilirse ve komut dosyası herhangi bir yetkilendirme gerektirmiyorsa 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|null: Komut dosyasını yetkilendirmek için kullanılabilecek bir URL

getAuthorizedScopes()

Komut dosyası için yetkilendirilmiş kapsamların listesini alır. Belirli bir kapsam listesi için yetkilendirme bilgileri istenirse belirtilen listedeki yetkilendirilmiş 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[]|null: Yetkili kapsamların listesi.