프로젝트 관리

이 섹션에서는 Apps Script 프로젝트를 만들고 읽고 수정하고 모니터링하는 데 사용할 수 있는 Apps Script API 메서드를 간략하게 설명합니다. 프로젝트 관리 샘플 페이지에는 API 관리 요청의 예시가 표시됩니다. 각 메서드의 참조 문서는 구현 세부정보를 제공합니다.

API 메서드 개요
프로젝트 만들기	projects.create 결과: 프로젝트 파일과 기본 프로젝트 매니페스트가 없는 빈 기본 프로젝트를 만듭니다. 옵션: 프로젝트 제목을 입력할 수 있습니다. 스크립트의 상위 역할을 할 Google 문서, Google 스프레드시트, Google 설문지, 프레젠테이션 파일의 Google 드라이브 ID를 제공하여 바인드된 스크립트를 만들 수도 있습니다.
프로젝트 메타데이터 읽기	projects.get 결과: 프로젝트 메타데이터를 나타내는 Project 객체를 검색합니다. 이 데이터에는 프로젝트 제목, 스크립트 ID, 생성 사용자, 생성 시간, 기타 세부정보가 포함됩니다.
프로젝트 콘텐츠 읽기	projects.getContent 결과: 프로젝트의 코드 및 HTML 파일마다 하나씩 File 객체의 배열을 반환합니다. 이 목록에는 프로젝트 매니페스트도 JSON 파일로 포함됩니다. 파일 객체에는 파일의 소스 콘텐츠(File.source)와 기타 메타데이터(예: 파일의 함수 목록(File.functionSet))가 포함됩니다. 옵션: 쿼리 매개변수를 사용하여 검색할 콘텐츠의 버전을 지정할 수 있습니다.
프로젝트 콘텐츠 업데이트하기	projects.updateContent 결과: 스크립트 프로젝트의 파일 콘텐츠를 변경합니다. 새 콘텐츠를 File 객체의 배열로 제공합니다. 이러한 File 객체 중 하나는 JSON 유형이어야 하며 스크립트 프로젝트의 새 프로젝트 매니페스트를 나타내야 합니다. 새 콘텐츠는 프로젝트의 HEAD 버전으로 저장됩니다. 스크립트가 트리거로 실행되거나, 스크립트 편집기, 부가기능 미리보기 모드에서 실행되거나, 개발 모드에서 웹 앱 또는 Apps Script API로 실행될 때 사용됩니다. 참고: 스크립트 프로젝트 콘텐츠를 업데이트할 때 일반적으로 먼저 projects.getContent 요청을 실행하여 기존 File의 배열을 검색하고 해당 객체를 요청한 후 File을 projects.updateContent 요청의 입력으로 사용하는 것입니다. 경고: 새 콘텐츠가 스크립트 프로젝트의 모든 기존 파일을 대체합니다. 요청에 의해 업데이트되지 않은 파일은 삭제됩니다.
프로젝트 측정항목 읽기	projects.getMetrics 결과: 프로젝트에 대한 특정 측정항목을 읽습니다. 이러한 측정항목에는 사용자 수, 총 실행 수, 총 실행 오류 수, 기타 세부정보가 포함됩니다. MetricType을 사용하여 요청할 정보를 지정합니다. 옵션: MetricsFilter를 사용하여 특정 배포 또는 스크립트 함수로 결과를 제한합니다. MetricsIntervalConfig를 사용하여 특정 측정항목 간격을 정의할 수도 있습니다.