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. Właściwości nie mogą być współdzielone przez skrypty. Więcej informacji o tym, kiedy należy używać poszczególnych typów właściwości, znajdziesz w przewodniku po usłudze Properties.
// 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');
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
get | Properties | Pobiera z otwartego dokumentu, arkusza kalkulacyjnego lub formularza magazyn właściwości (tylko w przypadku tego skryptu), do którego mają dostęp wszyscy użytkownicy. |
get | Properties | Pobiera z magazynu usługi dane, do których mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu. |
get | Properties | Pobiera magazyn właściwości, do którego dostęp ma tylko bieżący użytkownik i tylko w ramach tego skryptu. |
Szczegółowa dokumentacja
get Document Properties()
Pobiera z otwartego dokumentu, arkusza kalkulacyjnego lub formularza magazyn właściwości (tylko w przypadku tego skryptu), do którego mają dostęp wszyscy użytkownicy. Jest on dostępny tylko wtedy, gdy skrypt jest opublikowany i wykonuje się jako dodatek lub jest powiązany z typem pliku Google. Gdy właściwości dokumentu są niedostępne, ta metoda zwraca null
. Właściwości dokumentu utworzone przez skrypt są niedostępne poza tym skryptem, nawet przez inne skrypty, które mają dostęp do tego samego dokumentu.
Powrót
Properties
– przechowalnia właściwości tylko dla tego skryptu, do której mają dostęp wszyscy użytkownicy bieżącego dokumentu, lub null
, jeśli skrypt nie jest dodatkiem ani nie jest powiązany z plikiem Google Workspace;
get Script Properties()
Pobiera z magazynu usługi dane, do których mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu.
Powrót
Properties
– repozytorium właściwości, do którego mają dostęp wszyscy użytkownicy skryptu.
get User Properties()
Pobiera magazyn właściwości, do którego dostęp ma tylko bieżący użytkownik i tylko w ramach tego skryptu.
Powrót
Properties
– repozytorium właściwości, do którego dostęp ma tylko bieżący użytkownik skryptu.