스크립트가 하나의 스크립트, 스크립트 사용자 한 명 또는 부가기능이 사용되는 문서 한 개로 범위가 지정된 키-값 쌍으로 간단한 데이터를 저장할 수 있습니다. 스크립트 간에 속성을 공유할 수 없습니다. 각 유형의 속성을 사용하는 경우에 대한 자세한 내용은 속성 서비스 가이드를 참조하세요.
// Sets three properties of different types. var documentProperties = PropertiesService.getDocumentProperties(); var scriptProperties = PropertiesService.getScriptProperties(); var userProperties = PropertiesService.getUserProperties(); documentProperties.setProperty('DAYS_TO_FETCH', '5'); scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/'); userProperties.setProperty('DISPLAY_UNITS', 'metric');
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getDocumentProperties() | Properties | 열려 있는 문서, 스프레드시트 또는 양식 내에서 모든 사용자가 액세스할 수 있는 속성 저장소를 가져옵니다 (이 스크립트에만 해당). |
getScriptProperties() | Properties | 모든 사용자가 액세스할 수 있지만 이 스크립트 내에서만 액세스할 수 있는 속성 저장소를 가져옵니다. |
getUserProperties() | Properties | 현재 사용자만 액세스할 수 있는 속성 저장소를 이 스크립트 내에서만 가져옵니다. |
자세한 문서
getDocumentProperties()
열려 있는 문서, 스프레드시트 또는 양식 내에서 모든 사용자가 액세스할 수 있는 속성 저장소를 가져옵니다 (이 스크립트에만 해당). 스크립트가 게시될 수 있으며 부가기능으로 실행되거나 Google 파일 형식에 결합된 경우에만 사용할 수 있습니다. 문서 속성을 사용할 수 없으면 이 메서드는 null
를 반환합니다. 스크립트로 생성된 문서 속성은 동일한 문서에 액세스하는 다른 스크립트에 의해서도 스크립트 외부에서 액세스할 수 없습니다.
Return
Properties
: 현재 문서의 모든 사용자가 액세스할 수 있는 스크립트의 속성 저장소 또는 스크립트가 부가기능이 아니거나 Google Workspace 파일에 결합되지 않은 경우 null
getScriptProperties()
모든 사용자가 액세스할 수 있지만 이 스크립트 내에서만 액세스할 수 있는 속성 저장소를 가져옵니다.
Return
Properties
: 스크립트의 모든 사용자가 액세스할 수 있는 속성 저장소