Layanan properti memungkinkan Anda menyimpan data sederhana dalam pasangan nilai kunci yang dicakup ke satu skrip, satu pengguna skrip, atau satu dokumen tempat add-on digunakan. Biasanya digunakan untuk menyimpan konfigurasi developer atau preferensi pengguna. Properti tidak pernah dibagikan antar-skrip.
Untuk melihat kuota harian dan batas penyimpanan untuk layanan Properti, lihat Kuota untuk Layanan Google.
Perbandingan toko properti
Objek
PropertiesService
global menawarkan tiga metode, yang masing-masing menampilkan objek
Properties
serupa, tetapi dengan hak akses yang berbeda, seperti yang ditunjukkan dalam tabel berikut:
Properti Skrip | Properti Pengguna | Properti Dokumen | |
---|---|---|---|
Metode untuk mengakses | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
Data yang dibagikan di antara | Semua pengguna skrip, add-on, atau aplikasi web | Pengguna saat ini dari skrip, add-on, atau aplikasi web | Semua pengguna add-on dalam dokumen yang terbuka |
Biasanya digunakan untuk | Data konfigurasi seluruh aplikasi, seperti nama pengguna dan sandi untuk database eksternal developer | Setelan khusus pengguna, seperti satuan metrik atau imperial | Data khusus dokumen, seperti URL sumber untuk diagram sematan |
Format data
Layanan Properti menyimpan semua data sebagai string dalam pasangan nilai kunci. Jenis data yang belum berupa string akan otomatis dikonversi menjadi string, termasuk metode yang ada dalam objek tersimpan.
Menyimpan data
Untuk menyimpan satu nilai, panggil metode Properties.setProperty(key,
value)
dari penyimpanan yang sesuai, seperti yang ditunjukkan dalam contoh berikut:
Untuk menyimpan data secara massal, teruskan peta pasangan nilai kunci ke
Properties.setProperties(properties)
.
Setiap key-value pair objek dalam parameter disimpan sebagai properti terpisah:
Membaca data
Untuk mengambil satu nilai yang sebelumnya Anda simpan, panggil
Properties.getProperty(key)
:
Untuk mengambil semua nilai di penyimpanan properti saat ini, panggil
Properties.getProperties()
:
Memodifikasi data
Metode getProperty()
dan getProperties()
menampilkan salinan data yang disimpan, bukan tampilan langsung, sehingga mengubah objek yang ditampilkan tidak akan memperbarui nilai di penyimpanan properti. Untuk memperbarui data di penyimpanan, cukup simpan lagi:
Menghapus data
Untuk menghapus satu nilai, panggil
Properties.deleteProperty(key)
:
Untuk menghapus semua properti di toko saat ini, panggil
Properties.deleteAllProperties()
:
Mengelola properti skrip secara manual
Anda dapat menambahkan hingga lima puluh properti kustom secara manual, sebagai string dalam pasangan nilai kunci, dari halaman setelan project. Untuk menambahkan lebih dari lima puluh properti, Anda harus menambahkannya secara terprogram menggunakan metode yang dijelaskan di atas dalam Menyimpan data. Saat menetapkan properti skrip dari halaman setelan project, Anda tidak dapat mereferensikan variabel skrip.
Menambahkan properti skrip
- Buka project Apps Script Anda.
- Di sebelah kiri, klik Setelan Project
.
- Untuk menambahkan properti pertama, di bagian Properti Skrip, klik Tambahkan properti skrip.
- Untuk menambahkan properti kedua dan berikutnya, di bagian Properti Skrip, klik Edit properti skrip > Tambahkan properti skrip.
- Untuk Property, masukkan nama kunci.
- Untuk Nilai, masukkan nilai untuk kunci.
- (Opsional) Untuk menambahkan properti lainnya, klik Tambahkan properti skrip.
- Klik Simpan properti skrip.
Edit properti skrip
- Buka project Apps Script Anda.
- Di sebelah kiri, klik Setelan Project
.
- Di bagian Properti Skrip, klik Edit properti skrip.
- Lakukan perubahan pada nama kunci dan nilai kunci untuk setiap properti yang ingin Anda ubah.
- Klik Simpan properti skrip.
Menghapus properti skrip
- Buka project Apps Script Anda.
- Di sebelah kiri, klik Setelan Project
.
- Di bagian Properti Skrip, klik Edit properti skrip.
- Di samping properti yang ingin Anda hapus, klik Hapus .
- Klik Simpan properti skrip.