Class ScriptProperties

스크립트속성

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

스크립트 속성은 스크립트가 영구 저장소에 저장하는 키-값 쌍입니다. 스크립트 속성은 스크립트를 실행하는 사용자와 관계없이 스크립트별로 범위가 지정됩니다.

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

지원 중단된 메서드

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

모든 속성을 삭제합니다.

ScriptProperties.deleteAllProperties();

리턴

ScriptProperties - 연결을 위한 이 객체

참고 항목


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

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

ScriptProperties.deleteProperty('special');

매개변수

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

리턴

ScriptProperties - 연결을 위한 이 객체

참고 항목


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

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

리턴

String[]


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

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

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

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

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

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = ScriptProperties.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: 키-값 쌍이 포함된 속성의 사본


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

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

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

매개변수

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

리턴

String: 키와 연결된 값

참고 항목


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

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

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

매개변수

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

리턴

ScriptProperties - 연결을 위한 이 객체

참고 항목


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

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

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

매개변수

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

리턴

ScriptProperties - 연결을 위한 이 객체

참고 항목


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

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

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

매개변수

이름유형설명
keyString속성 키
valueString키와 연결할 값

리턴

ScriptProperties - 연결을 위한 이 객체

참고 항목