Google Workspace eklentileri, kullanıcısının yerel ayarına ve saat dilimine erişebilir ve arayüzünü ve davranışını özelleştirmek için bu bilgileri kullanabilir. Eklentinizin bu bilgilere erişmesine izin vermek için eklentinizin manifestini yapılandırmanız gerekir.
Eklenti manifestini yapılandırma
Eklentinizi, aşağıdaki adımları uygulayarak kullanıcı yerel ayarına ve saat dilimi bilgilerine erişecek şekilde yapılandırabilirsiniz:
- Eklentinizin manifest dosyasında
addOns.common.useLocaleFromAppalanınıtrueolarak ayarlayın. - Henüz mevcut değilse manifest'in
oauthScopeslistesine aşağıdaki açık kapsamı ekleyin:https://www.googleapis.com/auth/script.locale
Eklentinin oauthScope listesine bir kapsam eklediyseniz kullanıcıların eklenti bir sonraki sefer açıldığında yeniden yetkilendirmesi gerekir.
Yerel ayar ve saat dilimi bilgilerini alma
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 dili ve ülke/bölge tanımlayıcısı. Örneğin,en-US.commonEventObject.timeZone.offset: Kullanıcının saat dilimi, Eşgüdümlü Evrensel Zaman'a (UTC) göre 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 farkı.
Daha fazla bilgi için Etkinlik nesneleri bölümüne bakın.
Etkinlik nesneleri, kullanıcı eklentinizle etkileşime geçtiğinde işlem geri çağırma işlevlerine, ana sayfaya ve bağlama dayalı tetikleyici işlevlerine iletilir. Her geri çağırma veya tetikleyici işlevi, etkinlik nesnesinden yerel ayar ve saat dilimi bilgilerini okuyabilir ve gerektiğinde kullanabilir. Örneğin, yeni bir karta yönlendiren bir geri çağırma işlevi, karta hangi metnin ekleneceğine karar verirken yerel ayar dizesine başvurabilir.