Oturum sınıfı, kullanıcının e-posta adresi ( bazı durumlarda) ve dil ayarını değiştirebilirsiniz.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
getActiveUser() | User | Geçerli kullanıcı hakkında bilgi alır. |
getActiveUserLocale() | String | Geçerli kullanıcının dil ayarını bir dize olarak alır (örneğin, İngilizce için en). |
getEffectiveUser() | User | Komut dosyasının yetkisi altında çalıştığı kullanıcıyla ilgili bilgileri alır. |
getScriptTimeZone() | String | Komut dosyasının saat dilimini alır. |
getTemporaryActiveUserKey() | String | Etkin kullanıcıya özel, ancak kullanıcı kimliğini açıklamayan geçici bir anahtar alır. |
Ayrıntılı belgeler
getActiveUser()
Geçerli kullanıcı hakkında bilgi alır. Güvenlik politikaları kullanıcının
kimlik için geçerli değilse User.getEmail() boş bir dize döndürür. İçeriğin hangi şartlarda
e-posta adresi değişiklik gösterebilir: Örneğin, kullanıcının e-posta adresi hiçbir
Basit bir onOpen(e) veya onEdit(e) tetikleyicisi, Google E-Tablolar'daki özel bir işlev veya bir web uygulaması gibi bir komut dosyasının kullanıcının yetkilendirmesi olmadan çalıştırılmasına olanak tanıyan bağlam
"ben olarak yürüt" moduna dağıtıldı (yani kullanıcı yerine geliştirici tarafından yetkilendirilir).
Ancak, geliştirici komut dosyasını kendisi çalıştırıyorsa bu kısıtlamalar genellikle geçerli değildir.
veya kullanıcıyla aynı Google Workspace alanına ait olmalıdır.
// Log the email address of the person running the script. var email = Session.getActiveUser().getEmail(); Logger.log(email);
Return
User - geçerli kullanıcı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/userinfo.email
getActiveUserLocale()
Geçerli kullanıcının dil ayarını bir dize olarak alır (örneğin, İngilizce için en).
// Log the language setting of the person running the script. Logger.log(Session.getActiveUserLocale());
Return
String: Kullanıcının dil ayarını temsil eden bir dize
getEffectiveUser()
Komut dosyasının yetkisi altında çalıştığı kullanıcıyla ilgili bilgileri alır. Komut dosyası
web uygulaması "benim olarak yürüt" olarak ayarlandı (geliştirici) kullanıyorsanız, geliştiricinin kullanıcı hesabını döndürür. Eğer
komut dosyası, yüklenebilir bir
tetikleyici, tetikleyiciyi oluşturan kullanıcının hesabını döndürür. Diğer birçok
senaryolarda, getActiveUser() ile aynı hesabı döndürür.
// Log the email address of the user under whose authority the script is running. var email = Session.getEffectiveUser().getEmail(); Logger.log(email);
Return
User — komut dosyasının yetkisi altındaki kullanıcı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/userinfo.email
getScriptTimeZone()
Komut dosyasının saat dilimini alır. Yeni komut dosyaları varsayılan olarak sahibinin saat dilimini kullanır, ancak komut dosyasının saat dilimi Dosya > Komut dosyasındaki proje özellikleri yardımcı olur. E-tabloların, Dosya > Google E-Tablolar'daki E-tablo ayarları'nı tıklayın. E-tablo ve diğer saat dilimlerinden farklı olan saat dilimleri komut dosyası saat dilimi, komut dosyası hatalarının yaygın bir kaynağıdır.
// Log the time zone of the script. var timeZone = Session.getScriptTimeZone(); Logger.log(timeZone);
Return
String — komut dosyasının saat dilimi
getTemporaryActiveUserKey()
Etkin kullanıcıya özel, ancak kullanıcı kimliğini açıklamayan geçici bir anahtar alır. Geçici anahtar 30 günde bir döndürülür ve komut dosyasına özgüdür.
// Log the temporary key of the person running the script. Logger.log(Session.getTemporaryActiveUserKey());
Return
String — geçici etkin kullanıcı anahtarı