Add-on 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 informasi lokalitas dan zona waktu pengguna dengan langkah-langkah berikut:
- Di file manifes add-on, tetapkan
kolom
addOns.common.useLocaleFromApp
ketrue
. - Jika belum ada, tambahkan cakupan eksplisit berikut dalam
daftar
oauthScopes
manifes:https://www.googleapis.com/auth/script.locale
- Simpan perubahan manifes.
Jika Anda menambahkan cakupan ke daftar oauthScope
add-on,
pengguna harus memberikan otorisasi ulang add-on
saat add-on dibuka kembali.
Mendapatkan informasi lokalitas dan zona waktu
Objek peristiwa
membawa informasi lokalitas pengguna jika dikonfigurasi dengan benar. Kolom berikut
muncul dalam 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 (Coordinated Universal Time/UTC).commonEventObject.timeZone.id
—ID zona waktu pengguna. Misalnya,America/New_York
.commonEventObject.timeZone
—ID dan offset zona waktu pengguna.
Lihat Objek peristiwa untuk detail selengkapnya.
Objek peristiwa diteruskan ke fungsi callback tindakan saat pengguna berinteraksi dengan add-on Anda, serta ke halaman beranda dan fungsi pemicu kontekstual. Setiap callback atau fungsi pemicu dapat membaca informasi lokalitas dan zona waktu dari objek peristiwa dan menggunakannya sesuai kebutuhan. Misalnya, fungsi callback yang menavigasi ke kartu baru dapat merujuk ke string lokalitas saat memutuskan teks yang akan ditambahkan ke kartu.