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