Apps Script 함수 실행

Apps Script API (이전 명칭: Apps Script Execution API)를 사용하면 액세스 권한이 있는 스크립트 프로젝트에서 함수를 원격으로 실행할 수 있습니다. 앱은 지정된 Apps Script 함수를 호출하여 필요한 경우 입력 매개변수를 제공하고 반환된 응답을 수신할 수 있습니다.

이 페이지의 예시는 API로 실행할 수 있는 일반적인 실행 작업을 보여줍니다. 특별한 승인 요구사항을 포함한 자세한 내용은 함수 실행 가이드를 참고하세요.

이 예에서 자리표시자 scriptId는 스크립트 프로젝트 ID를 제공하는 위치를 나타내는 데 사용됩니다. 스크립트 ID를 찾으려면 아래 단계를 따르세요.

1. Apps Script 프로젝트의 왼쪽 상단에서 프로젝트 설정 을 클릭합니다.
2. '스크립트 ID' 옆에 있는 복사를 클릭합니다.

함수 실행

다음 scripts.run 요청은 listFolderContent라는 Apps Script 함수를 호출하여 Drive folderId 및 정수 MAX_SIZE를 인수로 전달합니다. 이 함수는 개발 모드로 실행됩니다. 즉, 실행 파일로 배포된 버전과 관계없이 함수의 가장 최근에 저장된 버전이 실행됩니다.

요청 프로토콜은 다음과 같습니다. 함수 실행 가이드에서는 Google API 클라이언트 라이브러리를 사용하여 다양한 언어로 실행 요청을 구현하는 방법을 보여줍니다.

POST https://script.googleapis.com/v1/scripts/scriptId:run

{
  "function": "listFolderContent",
  "parameters": [
    folderId,
    MAX_SIZE
  ],
  "devMode": true
}

이 요청에 대한 응답에는 호출된 Apps Script 함수가 완료되면 실행 결과 또는 오류 응답이 포함됩니다. 이 예에서 함수는 파일 이름의 배열을 성공적으로 반환합니다.

{
  "response": {
    "result": [
      "fileTitle1",
      "fileTitle2",
      "fileTitle3"
    ]
  },
}

Apps Script 실행 중 함수에 오류가 발생하면 다음과 같은 응답이 가능합니다.

{
  "response": {
    "error": {
      "code": 3,
      "message": "ScriptError",
      "details": [{
        "@type": "type.googleapis.com/google.apps.script.v1.ExecutionError",
        "errorMessage": "The script enountered an exeception it could not resolve.",
        "errorType": "ScriptError",
        "scriptStackTraceElements": [{
          "function": "listFolderContent",
          "lineNumber": 14
        }]
      }]
    }
  }
}