Kullanıcının yerel ayarını ve saat dilimini al

Google Workspace Eklentileri, kullanıcının yerel ayarına ve saat dilimine erişip kullanıcı arayüzü ve davranışını özelleştirmek için bu bilgileri kullanabilir. Şunu yapılandırmanız gerekir: eklentinizin manifesti ve bu bilgilerden faydalanabilirsiniz.

Eklenti manifestini yapılandırma

Eklentinizi kullanıcının yerel ayarına ve saat dilimi bilgileri şu adımları uygulayın:

  1. Eklentinizin manifest'inde dosyasını ayarlamak için addOns.common.useLocaleFromApp alanını true değerine ayarlayın.
  2. Henüz yoksa aşağıdaki açık kapsamı manifest oauthScopes dosyası liste: https://www.googleapis.com/auth/script.locale

Eklentinin oauthScope listesine bir kapsam eklediyseniz kullanıcıların eklenti ilk açılışında okuyacak.

Yerel ayarı ve saat dilimi bilgilerini alın

Etkinlik nesneleri kullanıcı yerel ayar bilgilerini taşıyabilir. Aşağıdaki alanlar şurada görünür: commonEventObject alt yapısı vardır:

  • commonEventObject.userLocale: Kullanıcının dili ve ülkesi/bölgesi kullanır. Örneğin, en-US.
  • commonEventObject.timeZone.offset: Kullanıcının saat dilimi farkı Milisaniye cinsinden, Eşgüdümlü Evrensel Zaman'dan (UTC) itibaren.
  • 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 zaman farkı.

Etkinlik nesneleri bölümünü inceleyin inceleyebilirsiniz.

Etkinlik nesneleri işlem geri çağırma işlevleri Kullanıcı, eklentinizle ve ana sayfanızla etkileşimde bulunurken bağlama dayalı tetikleme işlevleridir. Her geri çağırma veya tetikleyici işlevi yerel ayar ve saat dilimi bilgilerini görüntüleyin ve bunları gerektiği şekilde kullanın. Örneğin, yeni bir karta gitme karta hangi metnin ekleneceğine karar verirken yerel ayar dizesine başvurabilir.