소개

Google Apps Script API를 사용하면 Google Apps Script에서 스크립트 생성, 관리, 실행을 자동화할 수 있습니다. 프로그래매틱 방식으로 Google Apps Script 프로젝트를 만들고 수정하고 배포하며 Apps Script 함수를 원격으로 실행할 수 있습니다. 이러한 작업은 Apps Script 편집기나 UI를 사용해야만 가능합니다.

이 API는 다음 용도로 자주 사용됩니다.

  • Apps Script 프로젝트 및 배포를 만들고 관리합니다.
  • 스크립트 프로젝트에서 함수를 추가하거나 업데이트합니다.
  • 다른 애플리케이션에서 Apps Script 함수를 실행합니다.
  • 스크립트 실행 로그 및 상태를 모니터링합니다.

또한 Apps Script API는 Apps Script Execution API를 대체하고 확장합니다. 실행 API를 사용하는 것과 마찬가지로 Apps Script API를 사용하여 Apps Script 함수를 원격으로 실행할 수 있습니다.

앱에서 이 API를 사용하려면 사용 설정해야 합니다.

다른 앱이 스크립트를 관리하도록 허용하려면 액세스 권한을 부여해야 합니다.

API 개요

Apps Script API는 여러 리소스로 나뉘며 각 리소스에는 특정 목적과 실행할 수 있는 요청 집합이 있습니다. 이러한 리소스는 다음과 같습니다.

  • projects — 스크립트 프로젝트의 표현입니다. 이 API는 프로젝트를 만들고, 읽고, 모니터링하고, 수정하는 메서드를 제공합니다. 이 리소스를 사용하여 프로젝트의 스크립트 파일과 메타데이터를 관리합니다.
  • projects.deployments — 스크립트 배포의 표현입니다. 이 API는 스크립트 프로젝트 배포를 만들고, 나열하고, 업데이트하고, 삭제하는 메서드를 제공합니다. 배포를 사용하여 스크립트를 웹 앱, 부가기능 또는 실행 파일로 사용할 수 있도록 합니다.
  • projects.versions - 스크립트 프로젝트 버전의 표현입니다. 이 API는 프로젝트 버전을 만들고 읽는 메서드를 제공합니다. 버전을 사용하여 스크립트 프로젝트의 다양한 반복을 추적합니다.
  • processes - 스크립트 함수 실행을 나타냅니다. API는 기존 프로세스를 나열하고 유형 및 현재 상태와 같은 프로세스에 관한 정보를 수집하는 메서드를 제공합니다. 이 리소스를 사용하여 scripts.run 메서드를 사용하여 시작된 스크립트 실행을 모니터링합니다.
  • scripts - Apps Script 함수를 원격으로 실행하는 메서드를 제공하는 엔드포인트입니다. 이 리소스를 사용하여 애플리케이션에서 스크립트 프로젝트의 함수를 실행합니다.