ExecutionError
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Apps Script API를 사용하여 스크립트 함수 실행을 시도하여 발생하는 오류의 특성에 대한 정보를 제공하는 객체입니다. run 호출은 성공했지만 스크립트 함수 (또는 Apps Script 자체)에서 예외가 발생하는 경우 응답 본문의 error 필드에 Status 객체가 포함됩니다. Status 객체의 details 필드에는 이러한 ExecutionError 객체 중 하나가 있는 배열이 포함됩니다.
| JSON 표현 |
{
"scriptStackTraceElements": [
{
object (ScriptStackTraceElement)
}
],
"errorMessage": string,
"errorType": string
} |
| 필드 |
scriptStackTraceElements[] |
object (ScriptStackTraceElement)
스크립트를 통해 스택 트레이스를 제공하여 실행이 실패한 위치를 가장 깊은 호출부터 먼저 표시하는 객체의 배열입니다.
|
errorMessage |
string
Apps Script에서 발생하는 오류 메시지로, 일반적으로 사용자의 언어로 현지화됩니다.
|
errorType |
string
오류 유형(예: TypeError 또는 ReferenceError) 오류 유형을 사용할 수 없는 경우 이 필드는 포함되지 않습니다.
|
ScriptStackTraceElement
실행이 실패한 위치를 보여주는 스크립트를 통한 스택 트레이스
| JSON 표현 |
{
"function": string,
"lineNumber": integer
} |
| 필드 |
function |
string
실패한 함수의 이름입니다.
|
lineNumber |
integer
스크립트가 실패한 줄 번호입니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003e\u003ccode\u003eExecutionError\u003c/code\u003e objects provide information about errors during script execution via the Apps Script API.\u003c/p\u003e\n"],["\u003cp\u003eThese objects contain details such as stack trace elements, error message, and error type.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eScriptStackTraceElement\u003c/code\u003e objects offer a stack trace showing the location of the execution failure within the script.\u003c/p\u003e\n"],["\u003cp\u003eThey include the function name and line number where the error occurred.\u003c/p\u003e\n"]]],[],null,["# ExecutionError\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [ScriptStackTraceElement](#ScriptStackTraceElement)\n - [JSON representation](#ScriptStackTraceElement.SCHEMA_REPRESENTATION)\n\nAn object that provides information about the nature of an error resulting from an attempted execution of a script function using the Apps Script API. If a [run](/apps-script/api/reference/rest/v1/scripts/run#google.apps.script.v1.ScriptExecution.Execute) call succeeds but the script function (or Apps Script itself) throws an exception, the response body's [error](/apps-script/api/reference/rest/v1/scripts/run#body.Operation.FIELDS.error) field contains a [Status](/apps-script/api/reference/rest/v1/scripts/run#Status) object. The `Status` object's `details` field contains an array with a single one of these `ExecutionError` objects.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"scriptStackTraceElements\": [ { object (/apps-script/api/reference/rest/v1/ExecutionError#ScriptStackTraceElement) } ], \"errorMessage\": string, \"errorType\": string } ``` |\n\n| Fields ||\n|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `scriptStackTraceElements[]` | `object (`[ScriptStackTraceElement](/apps-script/api/reference/rest/v1/ExecutionError#ScriptStackTraceElement)`)` An array of objects that provide a stack trace through the script to show where the execution failed, with the deepest call first. |\n| `errorMessage` | `string` The error message thrown by Apps Script, usually localized into the user's language. |\n| `errorType` | `string` The error type, for example `TypeError` or `ReferenceError`. If the error type is unavailable, this field is not included. |\n\nScriptStackTraceElement\n-----------------------\n\nA stack trace through the script that shows where the execution failed.\n\n| JSON representation |\n|-------------------------------------------------------|\n| ``` { \"function\": string, \"lineNumber\": integer } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------|\n| `function` | `string` The name of the function that failed. |\n| `lineNumber` | `integer` The line number where the script failed. |"]]
