Properties Service

Usługi

Ta usługa umożliwia skryptom przechowywanie ciągów znaków w postaci par klucz-wartość w zakresie jednego skryptu, jednego użytkownika skryptu lub jednego dokumentu, w którym jest używany dodatek do edytora. Więcej informacji o tym, kiedy używać poszczególnych typów właściwości, znajdziesz w przewodniku po usłudze Properties.

Zajęcia

NazwaKrótki opis
PropertiesObiekt properties służy jako interfejs dostępu do właściwości użytkownika, dokumentu lub skryptu.
PropertiesServiceUmożliwia skryptom przechowywanie prostych danych w postaci par klucz-wartość w zakresie jednego skryptu, jednego użytkownika skryptu lub jednego dokumentu, w którym używany jest dodatek.
ScriptPropertiesWłaściwości skryptu to pary klucz-wartość przechowywane przez skrypt w pamięci trwałej.
UserPropertiesWłaściwości użytkownika to pary klucz-wartość unikalne dla danego użytkownika.

Properties

Metody

MetodaZwracany typKrótki opis
deleteAllProperties()PropertiesUsuwa wszystkie właściwości w bieżącym magazynie Properties.
deleteProperty(key)PropertiesUsuwa właściwość o podanym kluczu z bieżącego Properties.
getKeys()String[]Pobiera wszystkie klucze w bieżącym sklepie Properties.
getProperties()ObjectPobiera kopię wszystkich par klucz-wartość w bieżącym Properties.
getProperty(key)StringPobiera wartość powiązaną z podanym kluczem w bieżącym sklepie Properties lub null, jeśli taki klucz nie istnieje.
setProperties(properties)PropertiesUstawia wszystkie pary klucz-wartość z danego obiektu w bieżącym Properties.
setProperties(properties, deleteAllOthers)PropertiesUstawia wszystkie pary klucz-wartość z danego obiektu w bieżącym Properties sklepie, opcjonalnie usuwając wszystkie inne właściwości w sklepie.
setProperty(key, value)PropertiesUstawia podaną parę klucz-wartość w bieżącym sklepie Properties.

PropertiesService

Metody

MetodaZwracany typKrótki opis
getDocumentProperties()PropertiesPobiera pamięć usługi (tylko dla tego skryptu), do której wszyscy użytkownicy mają dostęp w otwartym dokumencie, arkuszu kalkulacyjnym lub formularzu.
getScriptProperties()PropertiesPobiera magazyn właściwości, do którego wszyscy użytkownicy mają dostęp, ale tylko w ramach tego skryptu.
getUserProperties()PropertiesPobiera magazyn właściwości, do którego dostęp ma tylko bieżący lub efektywny użytkownik i tylko w tym skrypcie.

ScriptProperties

UserProperties