Properties Service

속성

이 서비스를 사용하면 스크립트가 편집기 부가기능이 사용되는 하나의 스크립트, 하나의 스크립트 사용자 또는 하나의 문서에 범위가 지정된 문자열을 키-값 쌍으로 저장할 수 있습니다. 각 속성 유형을 언제 사용해야 하는지 자세히 알아보려면 Properties 서비스 가이드를 참고하세요.

클래스

이름간략한 설명
Properties속성 객체는 사용자, 문서 또는 스크립트 속성에 액세스하는 인터페이스 역할을 합니다.
PropertiesService스크립트가 스크립트 하나, 스크립트 사용자 하나 또는 부가기능이 사용되는 문서 하나에 범위가 지정된 키-값 쌍에 간단한 데이터를 저장할 수 있습니다.
ScriptProperties스크립트 속성은 스크립트가 영구 저장소에 저장하는 키-값 쌍입니다.
UserProperties사용자 속성은 사용자마다 고유한 키-값 쌍입니다.

Properties

메서드

메서드반환 유형간략한 설명
deleteAllProperties()Properties현재 Properties 저장소의 모든 속성을 삭제합니다.
deleteProperty(key)Properties현재 Properties 저장소에서 지정된 키가 있는 속성을 삭제합니다.
getKeys()String[]현재 Properties 저장소의 모든 키를 가져옵니다.
getProperties()Object현재 Properties 저장소에 있는 모든 키-값 쌍의 복사본을 가져옵니다.
getProperty(key)String현재 Properties 저장소에서 지정된 키와 연결된 값을 가져오거나, 이러한 키가 없는 경우 null을 가져옵니다.
setProperties(properties)Properties현재 Properties 저장소에 지정된 객체의 모든 키-값 쌍을 설정합니다.
setProperties(properties, deleteAllOthers)Properties지정된 객체의 모든 키-값 쌍을 현재 Properties 저장소에 설정하고 저장소의 다른 모든 속성을 선택적으로 삭제합니다.
setProperty(key, value)Properties현재 Properties 저장소에 지정된 키-값 쌍을 설정합니다.

PropertiesService

메서드

메서드반환 유형간략한 설명
getDocumentProperties()Properties열려 있는 문서, 스프레드시트 또는 양식 내에서 모든 사용자가 액세스할 수 있는 속성 저장소 (이 스크립트 전용)를 가져옵니다.
getScriptProperties()Properties모든 사용자가 액세스할 수 있지만 이 스크립트 내에서만 액세스할 수 있는 속성 저장소를 가져옵니다.
getUserProperties()Properties현재 사용자 또는 유효한 사용자만 액세스할 수 있고 이 스크립트 내에서만 액세스할 수 있는 속성 저장소를 가져옵니다.

ScriptProperties

UserProperties