Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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.useLocaleFromApp alanını true olarak ayarlayın.
Henüz mevcut değilse manifest'in oauthScopes listesine 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ı.
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.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-12-22 UTC."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],[]]
