Mendapatkan lokalitas dan zona waktu untuk pengguna Add-on Google Workspace

Panduan ini menjelaskan cara add-on mendapatkan lokal dan zona waktu pengguna, lalu menggunakan informasi tersebut untuk menyesuaikan antarmuka dan perilakunya. Untuk panduan khusus Google Apps Script, lihat Mendapatkan lokalitas dan zona waktu pengguna dalam dokumentasi developer Apps Script.

Mengonfigurasi resource deployment add-on

Untuk mengizinkan add-on mendapatkan lokalitas dan zona waktu pengguna, konfigurasikan resource deployment add-on:

  1. Di resource deployment add-on, tetapkan kolom addOns.common.useLocaleFromApp ke true.
  2. Tambahkan cakupan otorisasi https://www.googleapis.com/auth/script.locale ke daftar oauthScopes resource deployment. Cakupan ini memberikan add-on izin pengguna untuk melihat negara, bahasa, dan zona waktu mereka.
  3. Simpan resource deployment yang diperbarui.

Setelah menambahkan cakupan ke daftar oauthScopes add-on, pengguna harus mengizinkan ulang add-on pada saat mereka menggunakannya lagi.

Mendapatkan informasi lokalitas dan zona waktu

Objek peristiwa menyertakan informasi lokalitas pengguna, yang dapat Anda peroleh dari properti commonEventObject berikut:

  • commonEventObject.userLocale—Bahasa dan ID negara atau wilayah pengguna. Misalnya, en-US mewakili bahasa Inggris seperti yang digunakan di Amerika Serikat.
  • 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.

Objek peristiwa diteruskan ke fungsi callback action, fungsi homepageTrigger, dan fungsi contextualTrigger saat pengguna berinteraksi dengan add-on dengan, misalnya, mengklik tombol. Setiap callback atau fungsi pemicu bisa mendapatkan informasi lokal dan zona waktu dari objek peristiwa dan menggunakannya sesuai kebutuhan. Misalnya, fungsi callback yang membuka kartu baru dapat merujuk ke string lokalitas saat menentukan teks yang akan ditambahkan ke kartu.