Zezwala na przechowywanie w parach klucz-wartość prostych zakresów ograniczonych do jednego skryptu, jednego użytkownika skryptu lub jednego dokumentu, w którym jest używany dodatek. Właściwości nie mogą być udostępniane między skryptami. Więcej informacji o tym, kiedy używać poszczególnych typów usług, znajdziesz w przewodniku po usłudze.
// 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 usług (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 dostęp mają wszyscy użytkownicy, ale tylko w tym skrypcie. |
getUserProperties() | Properties | Pobiera sklep z usługami, do którego dostęp ma tylko bieżący użytkownik, oraz tylko w tym skrypcie. |
Szczegółowa dokumentacja
getDocumentProperties()
Pobiera magazyn usług (tylko dla tego skryptu), do którego wszyscy użytkownicy mają dostęp w otwartym dokumencie, arkuszu kalkulacyjnym lub formularzu. Jest on dostępny tylko wtedy, gdy skrypt został opublikowany i wykonane jako dodatek lub jeśli jest powiązany z typem pliku Google. Jeśli 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 jeśli inne skrypty uzyskują dostęp do tego samego dokumentu.
Zwróć
Properties – magazyn właściwości tego skryptu, do którego mają dostęp wszyscy użytkownicy bieżącego dokumentu, lub właściwość null, jeśli skrypt nie jest dodatkiem ani powiązany z plikiem Google Workspace.
getScriptProperties()
Pobiera magazyn usług, do którego dostęp mają wszyscy użytkownicy, ale tylko w tym skrypcie.
Zwróć
Properties – sklep z usługami, do którego dostęp mają wszyscy użytkownicy skryptu
getUserProperties()
Pobiera sklep z usługami, do którego dostęp ma tylko bieżący użytkownik, oraz tylko w tym skrypcie.
Zwróć
Properties – sklep z usługami, do którego dostęp ma tylko bieżący użytkownik skryptu