Mengakses lokal dan zona waktu pengguna

Add-on dapat mengakses lokalitas dan zona waktu penggunanya serta penggunaan 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:

  1. Di 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
  3. Simpan perubahan manifes.

Jika Anda menambahkan cakupan ke daftar oauthScope add-on, pengguna harus memberi otorisasi ulang add-on saat membuka add-on berikutnya.

Memperoleh 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—Bahasa dan ID 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—Offset dan ID zona waktu pengguna.

Lihat Objek peristiwa untuk detail selengkapnya.

Objek peristiwa diteruskan ke fungsi callback tindakan saat pengguna berinteraksi dengan add-on, serta ke fungsi pemicu kontekstual dan halaman beranda. Setiap fungsi callback atau 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.