Mendapatkan lokalitas dan zona waktu pengguna

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:

  1. Dalam file manifes add-on, tetapkan kolom addOns.common.useLocaleFromApp ke true.
  2. 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.

Lihat Objek peristiwa untuk mengetahui detail selengkapnya.

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.