Memungkinkan skrip untuk menyimpan data sederhana dalam key-value pair yang dicakupkan ke satu skrip, satu pengguna skrip, atau satu dokumen yang menggunakan add-on. Properti tidak dapat dibagikan antar-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 (hanya untuk skrip ini) yang dapat diakses oleh semua pengguna dalam dokumen terbuka, spreadsheet, atau formulir. |
getScriptProperties() | Properties | Mendapatkan penyimpanan properti yang dapat diakses 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 (hanya untuk skrip ini) yang dapat diakses oleh semua pengguna dalam dokumen terbuka, spreadsheet, atau formulir. Library ini hanya tersedia jika skrip dipublikasikan dan dieksekusi sebagai add-on atau jika skrip terikat ke 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 add-on atau terikat dengan file Google Workspace
getScriptProperties()
Mendapatkan penyimpanan properti yang dapat diakses semua pengguna, tetapi hanya dalam skrip ini.
Return
Properties — penyimpanan 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 — penyimpanan properti yang hanya dapat diakses oleh pengguna skrip saat ini