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;