프로젝트 관리

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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