Если при использовании API Таблиц возникают ошибки 500, это обычно указывает на проблему с самим API. Отправьте отчёт об ошибке в систему отслеживания ошибок API Таблиц, указав запрос, вызвавший ошибку.
503 Service Unavailable
API Таблиц возвращает ошибку 503, если сервис недоступен или если запрос или таблица слишком сложные. Ниже приведены несколько рекомендаций по ограничению частоты возникновения ошибок 503 путём изменения запросов API и базовой таблицы.
Запрос
Используйте batchUpdate для объединения связанных обновлений в один запрос. Будьте осторожны при пакетной обработке больших обновлений, так как это может привести к тайм-ауту.
Ограничьте количество одновременных запросов к API для одной электронной таблицы до 1 запроса в секунду.
Для больших электронных таблиц извлекайте только необходимые значения электронной таблицы, используя нотацию A1 , и ограничьте использование includeGridData .
Используйте маски полей , чтобы ограничить объем данных, возвращаемых API.
Используйте экспоненциальную задержку при повторных запросах.
Электронная таблица
Для часто обновляемых таблиц периодически переходите к новой таблице, чтобы сократить накопление версий.
Ограничьте использование IMPORTRANGE , QUERY и других сложных формул.
Рассмотрите возможность разделения больших электронных таблиц на несколько таблиц.
Ограничьте использование одной электронной таблицы в качестве источника для многих формул IMPORTRANGE .
Ограничьте доступ к электронной таблице только теми, кому это необходимо.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[],[],null,["# Troubleshoot API errors\n\nThis page describes how to troubleshoot errors with the Sheets API.\n| **Note:** The [Status\n| Dashboard](https://www.google.com/appsstatus/dashboard/) is a good place to start when troubleshooting errors with the Sheets API. It provides real-time information about the status of the Sheets API.\n\n`400 Bad Request`\n-----------------\n\nThis error indicates that the request was malformed. For troubleshooting these\nrequests, see the [reference documentation](https://developers.google.com/workspace/sheets/api/reference/rest) and the\n[support page](https://developers.google.com/workspace/sheets/api/support#questions_advice).\n\n`500 Internal Server Error`\n---------------------------\n\nIf you are encountering 500 errors when using the Sheets API, it\ntypically indicates that there is an issue with the API itself. File a bug\nreport on the Sheets API [Issue Tracker](https://developers.google.com/workspace/sheets/api/support#developer_product_feedback) with the request that caused\nthe error.\n\n`503 Service Unavailable`\n-------------------------\n\nThe Sheets API returns a 503 error when the service is unavailable or\nwhen the complexity of the request or spreadsheet is high. The following are\nsome suggestions to limit the rate of 503 errors by modifying the API requests\nand the underlying spreadsheet.\n\n### Request\n\n- Use [`batchUpdate`](https://developers.google.com/workspace/sheets/api/guides/batch) to combine related updates into a single request. Exercise caution when batching large updates as this might trigger a timeout.\n- Limit the number of concurrent requests to the API per spreadsheet to 1 request per second.\n- For large spreadsheets, retrieve only the necessary spreadsheet values using [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) and limit the use of [`includeGridData`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get#query-parameters).\n- Use [field masks](https://developers.google.com/workspace/sheets/api/guides/performance#partial) to limit the amount of data returned by the API.\n- Use exponential backoff when retrying requests.\n\n### Spreadsheet\n\n- For frequently updated sheets, rotate to a new spreadsheet periodically to reduce accumulation of versions.\n- Limit the use of [`IMPORTRANGE`](https://support.google.com/docs/answer/3093340), [`QUERY`](https://support.google.com/docs/answer/3093343), and other complex formulas.\n- Consider splitting large spreadsheets into multiple spreadsheets.\n- Limit the use of a single spreadsheet as a source for many [`IMPORTRANGE`](https://support.google.com/docs/answer/3093340) formulas.\n- Limit access to the spreadsheet to only those who need it."]]
