Usługa Właściwości umożliwia przechowywanie prostych danych w parach klucz-wartość ograniczonych do jednego skryptu, jednego użytkownika skryptu lub jeden dokument, w którym jest używany dodatek. Jest zwykle służy do przechowywania konfiguracji dewelopera lub ustawień użytkownika. Właściwości nigdy nie są udostępniane między skryptami.
Aby wyświetlić dzienne limity miejsca i limity miejsca na dane w usłudze Właściwości, zapoznaj się z sekcją Limity dla usług Google.
Porównanie sklepów nieruchomości
PropertiesService
obiekt globalny oferuje trzy metody, z których każda zwraca podobny
Properties
ale z innymi uprawnieniami dostępu, jak pokazano w tej tabeli:
Właściwości skryptu | Właściwości użytkownika | Właściwości dokumentu | |
---|---|---|---|
Sposób uzyskania dostępu | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
Dane udostępniane między | Wszyscy użytkownicy skryptu, dodatku lub aplikacji internetowej | Bieżący użytkownik skryptu, dodatku lub aplikacji internetowej | Wszyscy użytkownicy dodatku w otwartym dokumencie |
Typowe zastosowanie | Dane konfiguracyjne obejmujące całą aplikację, takie jak nazwa użytkownika i hasło zewnętrzna baza danych programisty | Ustawienia dla konkretnego użytkownika, np. jednostki metryczne lub jednostki imperialne | dane dotyczące konkretnego dokumentu, takie jak źródłowy adres URL wykresu umieszczonego na stronie; |
Format danych
Usługa Właściwości przechowuje wszystkie dane jako ciągi znaków w parach klucz-wartość. Typy danych , które nie są jeszcze ciągami tekstowymi, zostaną automatycznie przekonwertowane na ciągi, w tym w zapisanych obiektach.
Zapisuję dane
Aby zapisać pojedynczą wartość, wywołaj metodę Properties.setProperty(key,
value)
sklepu, jak w tym przykładzie:
Aby zbiorczo zapisać dane, przekaż mapę par klucz-wartość do funkcji
Properties.setProperties(properties)
Każda para klucz-wartość obiektu w parametrze jest przechowywana jako osobna
usługa:
Odczyt danych
Aby odzyskać jedną zapisaną wcześniej wartość, wywołaj
Properties.getProperty(key)
:
Aby pobrać wszystkie wartości z bieżącego magazynu właściwości, wywołaj
Properties.getProperties()
:
Modyfikowanie danych
Metody getProperty()
i getProperties()
zwracają kopię przechowywanych danych
danych, a nie podglądu na żywo, więc zmiana zwróconego obiektu nie spowoduje aktualizacji wartości.
w magazynie nieruchomości. Aby zaktualizować dane w sklepie, po prostu zapisz je ponownie:
Usuwanie danych
Aby usunąć jedną wartość, wywołaj
Properties.deleteProperty(key)
:
Aby usunąć wszystkie miejsca zakwaterowania w bieżącym magazynie, wywołaj
Properties.deleteAllProperties()
:
Ręczne zarządzanie właściwościami skryptu
Możesz ręcznie dodać do 50 właściwości niestandardowych jako ciągi znaków w parze klucz-wartość ze strony ustawień projektu. Aby dodać więcej niż 50 miejsc zakwaterowania, dodawać je automatycznie, korzystając z metod opisanych powyżej Zapisuję dane. Po ustawieniu właściwości skryptu na stronie ustawień projektu nie możesz zmiennych skryptu.
Dodaj właściwości skryptu
- Otwórz projekt Apps Script.
- Po lewej stronie kliknij Ustawienia projektu
.
- Aby dodać pierwszą właściwość, w sekcji Właściwości skryptu kliknij Dodaj właściwość skryptu.
- Aby dodać drugą i kolejne właściwości, w sekcji Właściwości skryptu kliknij Edytuj właściwości skryptu > Dodaj właściwość skryptu.
- W polu Usługa wpisz nazwę klucza.
- W polu Wartość wpisz wartość klucza.
- (Opcjonalnie) Aby dodać więcej właściwości, kliknij Dodaj właściwość skryptu.
- Kliknij Zapisz właściwości skryptu.
Edytuj właściwości skryptu
- Otwórz projekt Apps Script.
- Po lewej stronie kliknij Ustawienia projektu
.
- W sekcji Właściwości skryptu kliknij Edytuj właściwości skryptu.
- Zmień nazwę i wartość klucza w przypadku każdej właściwości, którą chcesz zmienić.
- Kliknij Zapisz właściwości skryptu.
Usuń właściwości skryptu
- Otwórz projekt Apps Script.
- Po lewej stronie kliknij Ustawienia projektu
.
- W sekcji Właściwości skryptu kliknij Edytuj właściwości skryptu.
- Obok usługi, którą chcesz usunąć, kliknij Usuń .
- Kliknij Zapisz właściwości skryptu.