Properties Service

Usługi

Ta usługa umożliwia skryptom przechowywanie ciągów znakó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 należy używać poszczególnych typów właściwości, znajdziesz w przewodniku po usłudze Properties.

Zajęcia

NazwaKrótki opis
PropertiesObiekt properties działa jako interfejs do uzyskiwania dostępu 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 trwałym magazynie danych.
UserPropertiesWłaściwości użytkownika to pary klucz-wartość, które są unikalne dla danego użytkownika.

Properties

Metody

MetodaZwracany typKrótki opis
deleteAllProperties()PropertiesUsuwa wszystkie właściwości w bieżącym sklepie Properties.
deleteProperty(key)PropertiesUsuwa w bieżącym Properties Store usługę o danym kluczu.
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 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 parę klucz-wartość w bieżącym magazynie Properties.

PropertiesService

Metody

MetodaZwracany typKrótki opis
getDocumentProperties()PropertiesPobiera z otwartego dokumentu, arkusza kalkulacyjnego lub formularza magazyn właściwości (tylko w przypadku tego skryptu), do którego mają dostęp wszyscy użytkownicy.
getScriptProperties()PropertiesPobiera z magazynu usługi dane, do których mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu.
getUserProperties()PropertiesPobiera magazyn właściwości, do którego dostęp ma tylko bieżący użytkownik i tylko w ramach tego skryptu.

ScriptProperties

UserProperties