Add-on Google Workspace dapat mengakses lokalitas dan zona waktu penggunanya serta penggunaannya informasi itu untuk menyesuaikan antarmuka dan perilakunya. Anda harus mengonfigurasi manifes add-on Anda untuk mengizinkan add-on Anda mengakses informasi ini.
Mengonfigurasi manifes add-on
Anda dapat mengkonfigurasi add-on untuk mengakses lokalitas pengguna dan informasi zona waktu dengan langkah-langkah berikut:
- Di manifes add-on Anda
, setel atribut
addOns.common.useLocaleFromAppketrue. - Jika belum ada, tambahkan cakupan eksplisit berikut dalam
oauthScopesmanifes daftar:https://www.googleapis.com/auth/script.locale
Jika Anda menambahkan cakupan ke daftar oauthScope add-on,
pengguna harus memberi otorisasi ulang
atau Gemini Enterprise
saat berikutnya dibuka.
Mendapatkan informasi lokalitas dan zona waktu
Objek peristiwa
membawa informasi lokalitas pengguna
saat dikonfigurasi dengan benar. Kolom berikut
muncul di commonEventObject
substruktur objek peristiwa:
commonEventObject.userLocale—Bahasa dan negara/wilayah pengguna yang sesuai. Misalnya,en-US.commonEventObject.timeZone.offset—Offset zona waktu pengguna, di dalam milidetik, dari Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC).commonEventObject.timeZone.id—ID zona waktu pengguna. Misalnya,America/New_York.commonEventObject.timeZone—ID zona waktu pengguna dan offset.
Lihat Objek peristiwa untuk mengetahui detail selengkapnya.
Objek peristiwa diteruskan ke fungsi callback tindakan saat pengguna berinteraksi dengan add-on Anda, dan dengan halaman beranda dan kontekstual fungsi pemicu. Setiap callback atau fungsi pemicu dapat membaca informasi lokalitas dan zona waktu dari objek peristiwa dan gunakan sesuai kebutuhan. Misalnya, fungsi callback yang membuka kartu baru dapat merujuk ke string lokal saat memutuskan teks apa yang akan ditambahkan ke kartu.