속성 서비스를 사용하면 하나의 스크립트, 스크립트의 한 사용자 또는 부가기능이 사용되는 하나의 문서로 범위가 지정된 키-값 쌍에 간단한 데이터를 저장할 수 있습니다. 일반적으로 개발자 구성 또는 사용자 환경설정을 저장하는 데 사용됩니다. 속성은 스크립트 간에 공유되지 않습니다.
속성 서비스의 일일 할당량 및 스토리지 한도를 보려면 Google 서비스 할당량을 참고하세요.
속성 저장소 비교
PropertiesService
전역 객체는 다음 세 가지 메서드를 제공합니다. 각 메서드는 비슷한 Properties
객체를 반환하지만 액세스 권한은 다릅니다(다음 표 참고).
스크립트 속성 | 사용자 속성 | 문서 속성 | |
---|---|---|---|
액세스 방법 | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
다음 간에 공유되는 데이터 | 스크립트, 부가기능 또는 웹 앱의 모든 사용자 | 스크립트, 부가기능 또는 웹 앱의 현재 사용자 | 열려 있는 문서의 부가기능 사용자 전체 |
일반적으로 사용되는 용도 | 개발자의 외부 데이터베이스의 사용자 이름 및 비밀번호와 같은 앱 전체 구성 데이터 | 미터법 또는 야드파운드법과 같은 사용자별 설정 | 문서별 데이터(예: 삽입된 차트의 소스 URL) |
데이터 형식
속성 서비스는 모든 데이터를 키-값 쌍의 문자열로 저장합니다. 아직 문자열이 아닌 데이터 유형은 저장된 객체 내에 포함된 메서드를 포함하여 문자열로 자동 변환됩니다.
데이터 저장 중
단일 값을 저장하려면 다음 예와 같이 적절한 저장소의 Properties.setProperty(key,
value)
메서드를 호출합니다.
데이터를 일괄 저장하려면 키-값 쌍 맵을 Properties.setProperties(properties)
에 전달합니다.
매개변수에 있는 객체의 각 키-값 쌍은 별도의 속성으로 저장됩니다.
데이터 읽기
이전에 저장한 단일 값을 검색하려면 Properties.getProperty(key)
를 호출합니다.
현재 속성 저장소의 모든 값을 가져오려면 Properties.getProperties()
를 호출합니다.
데이터 수정
getProperty()
및 getProperties()
메서드는 실시간 뷰가 아닌 저장된 데이터의 사본을 반환하므로 반환된 객체를 변경해도 속성 저장소의 값은 업데이트되지 않습니다. 저장소의 데이터를 업데이트하려면 데이터를 다시 저장하기만 하면 됩니다.
데이터 삭제
단일 값을 삭제하려면 Properties.deleteProperty(key)
를 호출합니다.
현재 스토어의 모든 속성을 삭제하려면 Properties.deleteAllProperties()
를 호출합니다.
스크립트 속성 수동 관리
프로젝트 설정 페이지에서 키-값 쌍의 문자열로 최대 50개의 맞춤 속성을 수동으로 추가할 수 있습니다. 50개가 넘는 속성을 추가하려면 위에 설명된 데이터 저장의 메서드를 사용하여 프로그래매틱 방식으로 추가해야 합니다. 프로젝트 설정 페이지에서 스크립트 속성을 설정하면 스크립트 변수를 참조할 수 없습니다.
스크립트 속성 추가
- Apps Script 프로젝트를 엽니다.
- 왼쪽에서 프로젝트 설정 을 클릭합니다.
- 첫 번째 속성을 추가하려면 스크립트 속성에서 스크립트 속성 추가를 클릭합니다.
- 두 번째 및 후속 속성을 추가하려면 스크립트 속성에서 스크립트 속성 수정 > 스크립트 속성 추가를 클릭합니다.
- 속성에 키 이름을 입력합니다.
- 값에 키의 값을 입력합니다.
- (선택사항) 속성을 더 추가하려면 스크립트 속성 추가를 클릭합니다.
- 스크립트 속성 저장을 클릭합니다.
스크립트 속성 수정
- Apps Script 프로젝트를 엽니다.
- 왼쪽에서 프로젝트 설정 을 클릭합니다.
- 스크립트 속성에서 스크립트 속성 수정을 클릭합니다.
- 변경하려는 각 속성의 키 이름과 키 값을 변경합니다.
- 스크립트 속성 저장을 클릭합니다.
스크립트 속성 삭제
- Apps Script 프로젝트를 엽니다.
- 왼쪽에서 프로젝트 설정 을 클릭합니다.
- 스크립트 속성에서 스크립트 속성 수정을 클릭합니다.
- 삭제하려는 속성 옆에 있는 삭제 를 클릭합니다.
- 스크립트 속성 저장을 클릭합니다.