이 페이지에서는 Sheets API의 오류 문제를 해결하는 방법을 설명합니다.
400 Bad Request
이 오류는 요청의 형식이 잘못되었음을 나타냅니다. 이러한 문제를 해결하기 위해 참조 문서와 지원 페이지를 참조하세요.
500 Internal Server Error
Sheets API를 사용할 때 500 오류가 발생하는 경우 일반적으로 API 자체에 문제가 있음을 나타냅니다. 버그 신고 Sheets API Issue Tracker에서 표시합니다.
503 Service Unavailable
Sheets API는 서비스를 사용할 수 없거나 서비스를 사용할 수 없는 경우 503 오류를 반환합니다. 요청 또는 스프레드시트의 복잡성이 높은 경우 다음은 API 요청을 수정하여 503 오류 비율을 제한하는 몇 가지 제안사항 스프레드시트입니다.
요청
batchUpdate
를 사용하여 관련 업데이트를 단일 요청으로 결합합니다. 대규모 업데이트를 일괄 처리할 때는 시간 초과- 스프레드시트당 API에 대한 동시 요청 수를 1회로 제한합니다. 지정할 수 있습니다
- 큰 스프레드시트의 경우
A1 표기법을 사용하고
includeGridData
사용을 제한합니다. - 필드 마스크를 사용하여 API에서 반환하는 데이터의 양을 제한합니다.
- 요청을 재시도할 때 지수 백오프를 사용하세요.
스프레드시트
- 자주 업데이트되는 시트의 경우 정기적으로 새 스프레드시트로 회전하세요. 버전 축적을 줄일 수 있습니다
IMPORTRANGE
,QUERY
및 기타 복잡한 수식의 사용을 제한하세요.- 큰 스프레드시트를 여러 개의 스프레드시트로 분할해 보세요.
- 단일 스프레드시트를 여러
IMPORTRANGE
의 소스로 사용 제한 공식을 사용할 수 있습니다. - 필요한 사용자만 스프레드시트에 액세스할 수 있도록 제한합니다.