Eklentiler, kullanıcının yerel ayarına ve saat dilimine erişip bu bilgileri arayüz ile davranışını özelleştirmek için kullanabilir. Eklentinizin bu bilgilere erişmesine izin vermek için eklentinizin manifestini yapılandırmanız gerekir.
Eklenti manifestini yapılandırma
Aşağıdaki adımları uygulayarak eklentinizi kullanıcının yerel ayar ve saat dilimi bilgilerine erişecek şekilde yapılandırabilirsiniz:
- Eklentinizin manifest dosyasında
addOns.common.useLocaleFromApp
alanınıtrue
olarak ayarlayın. - Henüz mevcut değilse aşağıdaki açık kapsamı manifest
oauthScopes
listesine ekleyin:https://www.googleapis.com/auth/script.locale
- Manifest değişikliklerini kaydedin.
Eklentinin oauthScope
listesine bir kapsam eklediyseniz kullanıcıların eklentiyi bir sonraki açışında yeniden yetkilendirmesi gerekir.
Yerel ayar ve saat dilimi bilgilerini edinme
Etkinlik nesneleri, doğru şekilde yapılandırıldığında kullanıcı yerel ayar bilgilerini taşır. Aşağıdaki alanlar, etkinlik nesnesinin commonEventObject
alt yapısında görünür:
commonEventObject.userLocale
: Kullanıcının dil ve ülke/bölge tanımlayıcısı. Örneğin,en-US
.commonEventObject.timeZone.offset
: Kullanıcının Eşgüdümlü Evrensel Saat'ten (UTC) olan saat dilimi farkı (milisaniye cinsinden).commonEventObject.timeZone.id
: Kullanıcının saat dilimi tanımlayıcısı. Örneğin,America/New_York
.commonEventObject.timeZone
: Kullanıcının saat dilimi kimliği ve ofseti.
Daha fazla bilgi için Etkinlik nesneleri bölümüne bakın.
Etkinlik nesneleri, kullanıcı eklentinizle etkileşimde bulunurken işlem geri çağırma işlevlerine ve ana sayfa ile bağlamsal tetikleyici işlevlerine aktarılır. Her bir geri çağırma veya tetikleyici işlevi, etkinlik nesnesinden yerel ayar ve saat dilimi bilgilerini okuyabilir ve gerektiği şekilde kullanabilir. Örneğin, yeni bir karta giden bir geri çağırma işlevi, karta eklenecek metne karar verirken yerel ayar dizesine başvurabilir.