Kullanıcının yerel ayarına ve saat dilimine erişme

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:

1. Eklentinizin manifest dosyasında addOns.common.useLocaleFromApp alanını true olarak ayarlayın.
2. Henüz mevcut değilse aşağıdaki açık kapsamı manifest oauthScopes listesine ekleyin: https://www.googleapis.com/auth/script.locale
3. Manifest değişikliklerini kaydedin.

Eklentinin oauthScope listesine bir kapsam eklediyseniz kullanıcıların eklentiyi bir sonraki açışında yeniden yetkilendirmesi gerekir.

Not: Eklentiniz, daha önce kullanıcının yerel ayarına ve saat dilimine erişmek için Apps Komut Dosyası Takvim hizmetini veya başka bir hizmeti kullanıyorsa eklentinizin bu hizmete hâlâ ihtiyaç duyup duymadığını değerlendirin. Aksi takdirde, hizmetin gerektirdiği tüm kapsamları manifest dosyanızdan kaldırın. Kapsam listenizi her zaman yalnızca eklentinizin ihtiyaç duyduğu hizmetlerle sınırlandırın.

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.