Properties Service

Usługi

Ta usługa umożliwia przechowywanie skryptów jako par klucz-wartość w ramach jednego skryptu, jednego użytkownika skryptu lub jednego dokumentu, w którym używany jest dodatek do edytora. Więcej informacji o tym, kiedy używać poszczególnych typów usług, znajdziesz w przewodniku po usłudze.

Zajęcia

NazwaKrótki opis
PropertiesObiekt properties pełni funkcję interfejsu umożliwiającego dostęp do właściwości użytkownika, dokumentu lub skryptu.
PropertiesServiceZezwala 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.
ScriptPropertiesWłaściwości skryptu to pary klucz-wartość przechowywane przez skrypt w magazynie trwałym.
UserPropertiesWłaściwości użytkownika to pary klucz-wartość, które są unikalne dla użytkownika.

Properties

Metody

MetodaZwracany typKrótki opis
deleteAllProperties()PropertiesUsuwa wszystkie usługi z bieżącego sklepu w Properties.
deleteProperty(key)PropertiesUsuwa usługę z danym kluczem w bieżącym sklepie Properties.
getKeys()String[]Pobiera wszystkie klucze z bieżącego sklepu Properties.
getProperties()ObjectPobiera kopię wszystkich par klucz-wartość w bieżącym sklepie Properties.
getProperty(key)StringPobiera wartość powiązaną z danym kluczem w bieżącym sklepie Properties lub null, jeśli nie istnieje taki klucz.
setProperties(properties)PropertiesUstawia wszystkie pary klucz-wartość z danego obiektu w bieżącym sklepie Properties.
setProperties(properties, deleteAllOthers)PropertiesUstawia wszystkie pary klucz-wartość z określonego obiektu w bieżącym sklepie Properties. Opcjonalnie możesz też usunąć wszystkie pozostałe właściwości w sklepie.
setProperty(key, value)PropertiesUstawia daną parę klucz-wartość w bieżącym sklepie Properties.

PropertiesService

Metody

MetodaZwracany typKrótki opis
getDocumentProperties()PropertiesPobiera magazyn usług (tylko dla tego skryptu), do którego wszyscy użytkownicy mają dostęp w otwartym dokumencie, arkuszu kalkulacyjnym lub formularzu.
getScriptProperties()PropertiesPobiera magazyn usług, do którego dostęp mają wszyscy użytkownicy, ale tylko w tym skrypcie.
getUserProperties()PropertiesPobiera sklep z usługami, do którego dostęp ma tylko bieżący użytkownik, oraz tylko w tym skrypcie.

ScriptProperties

UserProperties