Class PropertiesService

PropertiesService

Memungkinkan skrip menyimpan data sederhana dalam pasangan nilai kunci yang dicakup ke satu skrip, satu pengguna skrip, atau satu dokumen tempat add-on digunakan. Properti tidak dapat dibagikan antar-skrip. Untuk mengetahui informasi selengkapnya tentang waktu penggunaan setiap jenis properti, lihat panduan untuk layanan Properti.

// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty(
    'SERVER_URL',
    'http://www.example.com/MyWeatherService/',
);
userProperties.setProperty('DISPLAY_UNITS', 'metric');

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
getDocumentProperties()PropertiesMendapatkan penyimpanan properti (khusus untuk skrip ini) yang dapat diakses semua pengguna dalam dokumen, spreadsheet, atau formulir yang terbuka.
getScriptProperties()PropertiesMendapatkan penyimpanan properti yang dapat diakses semua pengguna, tetapi hanya dalam skrip ini.
getUserProperties()PropertiesMendapatkan penyimpanan properti yang hanya dapat diakses oleh pengguna saat ini atau efektif, dan hanya dalam skrip ini.

Dokumentasi mendetail

getDocumentProperties()

Mendapatkan penyimpanan properti (khusus untuk skrip ini) yang dapat diakses semua pengguna dalam dokumen, spreadsheet, atau formulir yang terbuka. Hanya tersedia jika skrip dipublikasikan dan dijalankan sebagai add-on atau jika 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.

Pulang pergi

Properties — Penyimpanan properti hanya untuk skrip ini yang dapat diakses oleh semua pengguna dokumen saat ini, atau null jika skrip bukan add-on atau terikat ke file Google Workspace.


getScriptProperties()

Mendapatkan penyimpanan properti yang dapat diakses semua pengguna, tetapi hanya dalam skrip ini.

Pulang pergi

Properties — Penyimpanan properti yang dapat diakses oleh semua pengguna skrip.


getUserProperties()

Mendapatkan penyimpanan properti yang hanya dapat diakses oleh pengguna saat ini atau efektif, dan hanya dalam skrip ini.

Pulang pergi

Properties — Penyimpanan properti yang hanya dapat diakses oleh pengguna skrip saat ini atau yang efektif.