Class PropertiesService

속성서비스

스크립트가 하나의 스크립트, 스크립트의 한 사용자 또는 부가기능이 사용되는 하나의 문서로 범위가 지정된 키-값 쌍에 간단한 데이터를 저장할 수 있습니다. 스크립트 간에 속성을 공유할 수 없습니다. 각 유형의 속성을 사용해야 하는 경우에 대한 자세한 내용은 속성 서비스 가이드를 참고하세요.

// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const 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를 반환합니다. 스크립트에서 만든 문서 속성은 동일한 문서에 액세스하는 다른 스크립트도 해당 스크립트 외부에서 액세스할 수 없습니다.

리턴

Properties: 현재 문서의 모든 사용자가 액세스할 수 있는 이 스크립트의 속성 저장소 또는 스크립트가 부가기능이 아니거나 Google Workspace 파일에 바인딩되지 않은 경우 null


getScriptProperties()

모든 사용자가 이 스크립트 내에서만 액세스할 수 있는 속성 스토어를 가져옵니다.

리턴

Properties: 스크립트의 모든 사용자가 액세스할 수 있는 속성 저장소입니다.


getUserProperties()

현재 사용자만 이 스크립트 내에서 액세스할 수 있는 속성 스토어를 가져옵니다.

리턴

Properties: 스크립트의 현재 사용자만 액세스할 수 있는 속성 저장소입니다.