프로젝트 관리

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

API 메서드 개요
프로젝트 만들기	projects.create 결과: 프로젝트 파일이 없고 기본 프로젝트 매니페스트가 있는 기본 빈 프로젝트를 만듭니다. 옵션: 프로젝트 제목을 제공할 수 있습니다. 스크립트의 상위 요소로 작동할 Google Docs, Google Sheets, Google Forms 또는 Slides 파일의 Google Drive 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를 사용하여 특정 측정항목 간격을 정의할 수도 있습니다.