Mengakses lokalitas dan zona waktu pengguna

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:

  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 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.