Google Apps Script 함수 실행

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

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

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

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

함수 실행

다음 scripts.run 요청은 listFolderContent라는 Apps Script 함수를 호출하여 Google 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
        }]
      }]
    }
  }
}