Class PropertiesService

LayananProperti

Memungkinkan skrip menyimpan data sederhana dalam pasangan nilai kunci yang dicakup untuk satu skrip, satu pengguna skrip, atau satu dokumen tempat add-on digunakan. Properti tidak dapat dibagikan antar-skrip. Untuk mengetahui informasi selengkapnya tentang kapan harus menggunakan 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 hasil yang ditampilkanDeskripsi singkat
getDocumentProperties()PropertiesMendapatkan penyimpanan properti (khusus skrip ini) yang dapat diakses oleh semua pengguna dalam dokumen, spreadsheet, atau formulir yang terbuka.
getScriptProperties()PropertiesMendapatkan penyimpanan properti yang dapat diakses oleh semua pengguna, tetapi hanya dalam skrip ini.
getUserProperties()PropertiesMendapatkan penyimpanan properti yang hanya dapat diakses oleh pengguna saat ini, dan hanya dalam skrip ini.

Dokumentasi mendetail

getDocumentProperties()

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

Pulang pergi

Properties — penyimpanan properti khusus 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 oleh 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, dan hanya dalam skrip ini.

Pulang pergi

Properties — penyimpanan properti yang hanya dapat diakses oleh pengguna skrip saat ini