Properties Service

Usługi

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

Zajęcia

NazwaKrótki opis
PropertiesObiekt właściwości działa jako interfejs uzyskujący dostęp do właściwości użytkownika, dokumentu lub skryptu.
PropertiesServiceUmożliwia skryptom przechowywanie prostych danych w parach klucz-wartość ograniczonych do 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 magazynie trwałym.
UserPropertiesWłaściwości użytkownika to pary klucz-wartość unikalne dla użytkownika.

Properties

Metody

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

PropertiesService

Metody

MetodaZwracany typKrótki opis
getDocumentProperties()PropertiesPobiera magazyn właściwości (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 mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu.
getUserProperties()PropertiesPobiera magazyn usług, do którego dostęp ma tylko bieżący użytkownik, wyłącznie w ramach tego skryptu.

ScriptProperties

UserProperties