이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class UserProperties

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

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

지원 중단된 메서드

메서드	반환 유형	간략한 설명
`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을 반환합니다.

var 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)