프로젝트 관리

이 섹션에서는 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를 사용하여 특정 측정항목 간격을 정의할 수도 있습니다.