속성 서비스를 사용하면 간단한 데이터를 하나의 스크립트, 스크립트의 사용자 한 명 또는 부가기능이 사용되는 하나의 문서로 범위가 지정된 키-값 쌍에 저장할 수 있습니다. 일반적으로 개발자 구성이나 사용자 환경설정을 저장하는 데 사용됩니다. 속성은 스크립트 간에 공유되지 않습니다.
속성 서비스의 일일 할당량 및 스토리지 한도를 보려면 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 프로젝트를 엽니다.
- 왼쪽에서 프로젝트 설정 을 클릭합니다.
- 스크립트 속성에서 스크립트 속성 수정을 클릭합니다.
- 삭제하려는 속성 옆의 삭제 를 클릭합니다.
- 스크립트 속성 저장을 클릭합니다.