Class PropertiesService

속성서비스

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

// 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 - 스크립트의 현재 사용자 또는 유효한 사용자만 액세스할 수 있는 속성 저장소입니다.