Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Add-on Google Workspace dapat mengakses lokalitas dan zona waktu penggunanya serta menggunakan
informasi tersebut untuk menyesuaikan antarmuka dan perilakunya. Anda harus mengonfigurasi
manifes add-on
untuk mengizinkan add-on mengakses
informasi ini.
Mengonfigurasi manifes add-on
Anda dapat mengonfigurasi add-on untuk mengakses lokalitas pengguna dan
informasi zona waktu
dengan langkah-langkah berikut:
Dalam file manifes add-on, tetapkan kolom addOns.common.useLocaleFromApp ke true.
Jika belum ada, tambahkan cakupan eksplisit berikut dalam
daftar oauthScopes
manifes:
https://www.googleapis.com/auth/script.locale
Jika Anda menambahkan cakupan ke daftar oauthScope add-on,
pengguna harus memberi otorisasi ulang
add-on
saat berikutnya add-on dibuka.
Mendapatkan informasi lokalitas dan zona waktu
Objek peristiwa membawa informasi lokalitas pengguna jika dikonfigurasi dengan benar. Kolom berikut
muncul di substruktur commonEventObject
objek peristiwa:
commonEventObject.userLocale—ID bahasa dan negara/wilayah pengguna. Misalnya, en-US.
commonEventObject.timeZone.offset—Offset zona waktu pengguna, dalam
milidetik, dari Waktu Universal Terkoordinasi (UTC).
commonEventObject.timeZone.id—ID zona waktu pengguna.
Misalnya, America/New_York.
commonEventObject.timeZone—ID dan offset zona waktu pengguna.
Objek peristiwa diteruskan ke
fungsi callback tindakan
saat pengguna berinteraksi dengan add-on Anda, dan ke halaman beranda
dan fungsi pemicu kontekstual. Setiap fungsi callback atau pemicu dapat membaca informasi lokalitas dan zona waktu dari objek peristiwa dan menggunakannya sesuai kebutuhan.
Misalnya, fungsi callback yang
membuka kartu baru
dapat merujuk ke string lokalitas saat memutuskan teks yang akan ditambahkan ke kartu.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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."]]],[]]
