Class UserProperties

Właściwości użytkownika

Wycofany. Ta klasa została wycofana i nie powinna być używana w nowych skryptach.

Właściwości użytkownika to pary klucz-wartość, które są unikalne dla danego użytkownika. Właściwości użytkownika są ograniczone do poszczególnych użytkowników. Każdy skrypt działający pod tożsamością użytkownika może uzyskać dostęp do właściwości użytkownika tylko tego użytkownika.

MetodaZwracany typKrótki opis
deleteAllProperties()UserPropertiesusuwa wszystkie usługi.
deleteProperty(key)UserPropertiesUsuwa usługę o podanym kluczu.
getKeys()String[]Pobierz wszystkie dostępne klucze.
getProperties()ObjectPobieranie wszystkich dostępnych usług naraz.
getProperty(key)StringZwraca wartość powiązaną z podanym kluczem lub wartość null, jeśli takiej wartości nie ma.
setProperties(properties)UserPropertieszbiorczo ustawia wszystkie właściwości pobrane z danego obiektu.
setProperties(properties, deleteAllOthers)UserPropertieszbiorczo ustawia wszystkie właściwości pobrane z danego obiektu.
setProperty(key, value)UserPropertiesZapisywanie określonej wartości z kluczem.

Wycofane metody

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

usuwa wszystkie usługi.

UserProperties.deleteAllProperties();

Powrót

UserProperties – ten obiekt, do łańcuchowania

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Usuwa usługę o podanym kluczu.

UserProperties.deleteProperty('special');

Parametry

NazwaTypOpis
keyStringklucz usługi do usunięcia

Powrót

UserProperties – ten obiekt, do łańcuchowania

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobierz wszystkie dostępne klucze.

Powrót

String[]


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie wszystkich dostępnych usług naraz.

Jest to kopia, a nie widok na żywo, więc zmiana właściwości zwróconego obiektu nie spowoduje ich aktualizacji w magazynie i odwrotnie.

UserProperties.setProperties({
  "cow"     : "moo",
  "sheep"   : "baa",
  "chicken" : "cluck"
});

// Logs "A cow goes: moo"
Logger.log("A cow goes: %s", UserProperties.getProperty("cow"));

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = UserProperties.getProperties();

// Logs:
// A chicken goes cluck!
// A cow goes moo!
// A sheep goes baa!
for(var kind in animalSounds) {
  Logger.log("A %s goes %s!", kind, animalSounds[kind]);
}

Powrót

Object – kopia właściwości zawierających pary klucz-wartość


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Zwraca wartość powiązaną z podanym kluczem lub wartość null, jeśli takiej wartości nie ma.

const specialValue = UserProperties.getProperty('special');

Parametry

NazwaTypOpis
keyStringklucz do pobieranej wartości;

Powrót

String – wartość powiązana z kluczem

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

zbiorczo ustawia wszystkie właściwości pobrane z danego obiektu.

UserProperties.setProperties({special: 'sauce', 'meaning': 42});

Parametry

NazwaTypOpis
propertiesObjectobiekt zawierający właściwości do ustawienia.

Powrót

UserProperties – ten obiekt, do łańcuchowania

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

zbiorczo ustawia wszystkie właściwości pobrane z danego obiektu.

// This deletes all other properties
UserProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

Parametry

NazwaTypOpis
propertiesObjectobiekt zawierający właściwości do ustawienia.
deleteAllOthersBooleanczy usunąć wszystkie istniejące usługi.

Powrót

UserProperties – ten obiekt, do łańcuchowania

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Zapisywanie określonej wartości z kluczem. Istniejąca wartość powiązana z tym kluczem zostanie zastąpiona.

UserProperties.setProperty('special', 'sauce');

Parametry

NazwaTypOpis
keyStringklucz właściwości
valueStringwartość do powiązania z kluczem.

Powrót

UserProperties – ten obiekt, do łańcuchowania

Zobacz też