Usługa Właściwości umożliwia przechowywanie prostych danych w parach klucz-wartość ograniczonych do 1 skryptu, 1 użytkownika skryptu lub 1 dokumentu, w którym używany jest dodatek. Służy on zwykle do zapisywania konfiguracji dewelopera lub preferencji użytkownika. Właściwości nigdy nie są współdzielone przez skrypty.
Aby wyświetlić dzienne limity i limity miejsca na dane w usłudze Usługi, przeczytaj artykuł o limitach w usługach Google.
Porównywanie sklepów z nieruchomościami
Obiekt globalny PropertiesService
udostępnia 3 metody, z których każda zwraca podobny obiekt Properties
, ale z różnymi uprawnieniami dostępu. Jak widać w tej tabeli:
Właściwości skryptu | Właściwości użytkownika | Właściwości dokumentu | |
---|---|---|---|
Sposób 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 konfiguracji dotyczące całej aplikacji, takie jak nazwa użytkownika i hasło do zewnętrznej bazy danych dewelopera | ustawienia dostosowane do użytkownika, np. jednostki metryczne lub imperialne, | dane specyficzne dla dokumentów, takie jak źródłowy adres URL umieszczonego wykresu; |
Format danych
Usługa Właściwości przechowuje wszystkie dane pod postacią ciągów znaków w parach klucz-wartość. Typy danych, które nie są jeszcze ciągami tekstowymi, są automatycznie konwertowane na ciągi tekstowe. Dotyczy to też metod zawartych w zapisanych obiektach.
Oszczędzanie danych
Aby zapisać pojedynczą wartość, wywołaj metodę Properties.setProperty(key,
value)
odpowiedniego sklepu, jak pokazano w tym przykładzie:
Aby zapisywać dane zbiorczo, przekaż mapę par klucz-wartość do funkcji Properties.setProperties(properties)
.
Każda para klucz-wartość obiektu w parametrze jest przechowywana jako osobna właściwość:
Odczytywanie danych
Aby pobrać jedną zapisaną wcześniej wartość, wywołaj metodę Properties.getProperty(key)
:
Aby pobrać wszystkie wartości z bieżącego magazynu usług, wywołaj metodę Properties.getProperties()
:
Modyfikowanie danych
Metody getProperty()
i getProperties()
zwracają kopię zapisanych danych, a nie podgląd na żywo, więc zmiana zwróconego obiektu nie spowoduje zaktualizowania wartości w magazynie właściwości. Aby zaktualizować dane w sklepie, po prostu zapisz je ponownie:
Usuwanie danych
Aby usunąć jedną wartość, wywołaj metodę Properties.deleteProperty(key)
:
Aby usunąć wszystkie usługi w bieżącym magazynie, wywołaj metodę Properties.deleteAllProperties()
:
Ręczne zarządzanie właściwościami skryptu
Na stronie ustawień projektu możesz ręcznie dodać maksymalnie 50 właściwości niestandardowych jako ciągi znaków w parach klucz-wartość. Aby dodać więcej niż 50 właściwości, musisz dodać je automatycznie za pomocą metod opisanych powyżej w sekcji Zapisywanie danych. Podczas ustawiania właściwości skryptu na stronie ustawień projektu nie możesz się odwoływać do 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 usługi, 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 parę klucza dla każdej właściwości, którą chcesz zmodyfikować.
- 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.