Class UserProperties

사용자속성

지원 중단되었습니다. 이 클래스는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

사용자 속성은 사용자마다 고유한 키-값 쌍입니다. 사용자 속성은 사용자별로 범위가 지정됩니다. 사용자의 ID로 실행되는 모든 스크립트는 해당 사용자의 사용자 속성에만 액세스할 수 있습니다.

지원 중단된 메서드

메서드	반환 유형	간략한 설명
deleteAllProperties()	UserProperties	모든 속성을 삭제합니다.
deleteProperty(key)	UserProperties	지정된 키가 있는 속성을 삭제합니다.
getKeys()	String[]	사용 가능한 모든 키를 가져옵니다.
getProperties()	Object	사용 가능한 모든 속성을 한 번에 가져옵니다.
getProperty(key)	String	제공된 키와 연결된 값을 반환하거나 이러한 값이 없는 경우 null을 반환합니다.
setProperties(properties)	UserProperties	지정된 객체에서 그려진 모든 속성을 일괄 설정합니다.
setProperties(properties, deleteAllOthers)	UserProperties	지정된 객체에서 그려진 모든 속성을 일괄 설정합니다.
setProperty(key, value)	UserProperties	지정된 값을 제공된 키로 유지합니다.

지원 중단된 메서드

deleteAllProperties()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

모든 속성을 삭제합니다.

UserProperties.deleteAllProperties();

리턴

UserProperties - 연결을 위한 이 객체

참고 항목

• deleteProperty(key)

---

deleteProperty(key)

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

지정된 키가 있는 속성을 삭제합니다.

UserProperties.deleteProperty('special');

매개변수

이름	유형	설명
key	String	삭제할 속성의 키

리턴

UserProperties - 연결을 위한 이 객체

참고 항목

• deleteAllProperties()

---

getKeys()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

사용 가능한 모든 키를 가져옵니다.

리턴

String[]

---

getProperties()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

사용 가능한 모든 속성을 한 번에 가져옵니다.

이렇게 하면 실시간 보기가 아닌 사본이 제공되므로 반환된 객체의 속성을 변경해도 저장소에서 업데이트되지 않으며 그 반대의 경우도 마찬가지입니다.

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]);
}

리턴

Object: 키-값 쌍이 포함된 속성의 사본

---

getProperty(key)

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

제공된 키와 연결된 값을 반환하거나 이러한 값이 없는 경우 null을 반환합니다.

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

매개변수

이름	유형	설명
key	String	검색할 값의 키

리턴

String: 키와 연결된 값

참고 항목

• setProperty(key, value)

---

setProperties(properties)

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

지정된 객체에서 그려진 모든 속성을 일괄 설정합니다.

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

매개변수

이름	유형	설명
properties	Object	설정할 속성이 포함된 객체입니다.

리턴

UserProperties - 연결을 위한 이 객체

참고 항목

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

지정된 객체에서 그려진 모든 속성을 일괄 설정합니다.

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

매개변수

이름	유형	설명
properties	Object	설정할 속성이 포함된 객체입니다.
deleteAllOthers	Boolean	기존 속성을 모두 삭제할지 여부입니다.

리턴

UserProperties - 연결을 위한 이 객체

참고 항목

• setProperty(key, value)

---

setProperty(key, value)

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

지정된 값을 제공된 키로 유지합니다. 이 키와 연결된 기존 값은 덮어씁니다.

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

매개변수

이름	유형	설명
key	String	속성 키
value	String	키와 연결할 값

리턴

UserProperties - 연결을 위한 이 객체

참고 항목

• getProperty(key)