Umożliwia skryptom przechowywanie prostych danych w parach klucz-wartość ograniczonych do jednego skryptu, jednego użytkownika skryptu lub jednego dokumentu, w którym używany jest dodatek. Nie można udostępniać właściwości między skryptami. Więcej informacji o stosowaniu poszczególnych typów usług znajdziesz w przewodniku po usłudze Właściwości.
// 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');
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
getDocumentProperties() | Properties | Pobiera magazyn właściwości (tylko dla tego skryptu), do którego wszyscy użytkownicy mają dostęp w otwartym dokumencie, arkuszu kalkulacyjnym lub formularzu. |
getScriptProperties() | Properties | Pobiera magazyn usług, do którego mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu. |
getUserProperties() | Properties | Pobiera magazyn usług, do którego dostęp ma tylko bieżący użytkownik, wyłącznie w ramach tego skryptu. |
Szczegółowa dokumentacja
getDocumentProperties()
Pobiera magazyn właściwości (tylko dla tego skryptu), do którego wszyscy użytkownicy mają dostęp w otwartym dokumencie, arkuszu kalkulacyjnym lub formularzu. Jest dostępna tylko wtedy, gdy skrypt jest opublikowany i uruchamiany jako dodatek lub jest powiązany z typem pliku Google. Gdy właściwości dokumentu są niedostępne, ta metoda zwraca wartość null. Właściwości dokumentu utworzone przez skrypt nie są dostępne poza tym skryptem, nawet dla innych skryptów uzyskujących dostęp do tego samego dokumentu.
Powroty
Properties – magazyn właściwości skryptu, do którego mają dostęp tylko wszyscy użytkownicy bieżącego dokumentu, lub null, jeśli skrypt nie jest dodatkiem ani nie jest powiązany z plikiem Google Workspace.
getScriptProperties()
Pobiera magazyn usług, do którego mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu.
Powroty
Properties – magazyn usług, do którego mają dostęp wszyscy użytkownicy skryptu;
getUserProperties()
Pobiera magazyn usług, do którego dostęp ma tylko bieżący użytkownik, wyłącznie w ramach tego skryptu.
Powroty
Properties – magazyn usług, do którego dostęp ma tylko bieżący użytkownik skryptu;