API 오류 문제 해결

이 페이지에서는 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 수식의 소스로 사용하는 것을 제한합니다.
  • 스프레드시트에 대한 액세스를 필요한 사용자에게만 제한합니다.