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