이 서비스를 통해 스크립트는 하나의 스크립트, 스크립트 사용자 또는 편집자 부가기능이 사용되는 문서로 범위가 지정된 키-값 쌍으로 문자열을 저장할 수 있습니다. 각 유형의 속성을 사용하는 경우에 대한 자세한 내용은 속성 서비스 가이드를 참조하세요.
클래스
| 이름 | 간략한 설명 |
|---|---|
Properties | 속성 객체는 사용자, 문서 또는 스크립트 속성에 액세스하기 위한 인터페이스 역할을 합니다. |
PropertiesService | 스크립트가 하나의 스크립트, 스크립트 사용자 한 명 또는 부가기능이 사용되는 문서 한 개로 범위가 지정된 키-값 쌍으로 간단한 데이터를 저장할 수 있습니다. |
| 스크립트 속성은 영구 저장소에 있는 스크립트에 의해 저장된 키-값 쌍입니다. |
| 사용자 속성은 사용자별로 고유한 키-값 쌍입니다. |
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 | 현재 사용자만 액세스할 수 있는 속성 저장소를 이 스크립트 내에서만 가져옵니다. |