Apps Script 함수 실행

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

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

이 예시에서는 스크립트 프로젝트 ID를 제공할 위치를 나타내기 위해 자리표시자 scriptId가 사용됩니다. 스크립트 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 스크립트 실행 중에 함수에 오류가 발생한 경우 응답은 다음과 같을 수 있습니다.

{
  "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
        }]
      }]
    }
  }
}