Panduan ini menjelaskan cara add-on mendapatkan lokal dan zona waktu pengguna, lalu menggunakan informasi tersebut untuk menyesuaikan antarmuka dan perilakunya. Untuk panduan khusus Google Apps Script, lihat Mendapatkan lokalitas dan zona waktu pengguna dalam dokumentasi developer Apps Script.
Mengonfigurasi resource deployment add-on
Untuk mengizinkan add-on mendapatkan lokalitas dan zona waktu pengguna, konfigurasikan resource deployment add-on:
- Di resource deployment add-on, tetapkan kolom
addOns.common.useLocaleFromApp
ketrue
. - Tambahkan cakupan otorisasi
https://www.googleapis.com/auth/script.locale
ke daftaroauthScopes
resource deployment. Cakupan ini memberikan add-on izin pengguna untuk melihat negara, bahasa, dan zona waktu mereka. - Simpan resource deployment yang diperbarui.
Setelah menambahkan cakupan ke daftar
oauthScopes
add-on,
pengguna harus mengizinkan ulang add-on pada saat mereka menggunakannya lagi.
Mendapatkan informasi lokalitas dan zona waktu
Objek peristiwa
menyertakan informasi lokalitas pengguna, yang dapat Anda peroleh dari properti
commonEventObject
berikut:
commonEventObject.userLocale
—Bahasa dan ID negara atau wilayah pengguna. Misalnya,en-US
mewakili bahasa Inggris seperti yang digunakan di Amerika Serikat.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
action
,
fungsi homepageTrigger
, dan
fungsi contextualTrigger
saat pengguna berinteraksi dengan add-on dengan, misalnya, mengklik tombol. Setiap callback atau fungsi pemicu bisa mendapatkan
informasi lokal dan zona waktu dari
objek peristiwa
dan menggunakannya sesuai kebutuhan. Misalnya, fungsi callback yang membuka kartu baru dapat
merujuk ke string lokalitas saat menentukan teks yang akan ditambahkan ke kartu.