Memungkinkan skrip menyimpan data sederhana dalam key-value pair yang dicakupkan ke satu skrip, satu pengguna skrip, atau satu dokumen tempat add-on digunakan. Properti tidak dapat dibagikan di antara skrip. Untuk informasi selengkapnya tentang kapan harus menggunakan setiap jenis properti, lihat panduan untuk layanan Properti.
// Sets three properties of different types.
var documentProperties = PropertiesService.getDocumentProperties();
var scriptProperties = PropertiesService.getScriptProperties();
var userProperties = PropertiesService.getUserProperties();
documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/');
userProperties.setProperty('DISPLAY_UNITS', 'metric');
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
getDocumentProperties() | Properties | Mendapatkan penyimpanan properti (khusus untuk skrip ini) yang dapat diakses oleh semua pengguna dalam dokumen, spreadsheet, atau formulir terbuka. |
getScriptProperties() | Properties | Mendapatkan penyimpanan properti yang dapat diakses oleh semua pengguna, tetapi hanya dalam skrip ini. |
getUserProperties() | Properties | Mendapatkan penyimpanan properti yang hanya dapat diakses oleh pengguna saat ini, dan hanya dalam skrip ini. |
Dokumentasi mendetail
getDocumentProperties()
Mendapatkan penyimpanan properti (khusus untuk skrip ini) yang dapat diakses oleh semua pengguna dalam dokumen, spreadsheet, atau formulir terbuka. Layanan ini hanya tersedia jika skrip dipublikasikan dan dieksekusi sebagai add-on atau diikat dengan jenis file Google. Jika properti dokumen tidak tersedia, metode ini akan menampilkan null. Properti dokumen yang dibuat oleh skrip tidak dapat diakses di luar skrip tersebut, bahkan oleh skrip lain yang mengakses dokumen yang sama.
Return
Properties — penyimpanan properti untuk skrip ini hanya yang dapat diakses oleh semua pengguna dokumen saat ini, atau null jika skrip bukan merupakan add-on atau terikat dengan file Google Workspace
getScriptProperties()
Mendapatkan penyimpanan properti yang dapat diakses oleh semua pengguna, tetapi hanya dalam skrip ini.
Return
Properties — toko properti yang dapat diakses oleh semua pengguna skrip
getUserProperties()
Mendapatkan penyimpanan properti yang hanya dapat diakses oleh pengguna saat ini, dan hanya dalam skrip ini.
Return
Properties — toko properti yang hanya dapat diakses oleh pengguna skrip saat ini