Устранение ошибок API

На этой странице описано, как устранять ошибки, возникающие при работе с API Google Sheets.

400 Bad Request

Эта ошибка указывает на то, что запрос был неправильно сформирован. Для устранения неполадок с такими запросами см. справочную документацию и страницу поддержки .

500 Internal Server Error

Если при использовании Sheets API вы сталкиваетесь с ошибками 500, это обычно указывает на проблему с самим API. Сообщите об ошибке в систему отслеживания ошибок Sheets API, указав запрос, вызвавший ошибку.

503 Service Unavailable

API Google Sheets возвращает ошибку 503, если сервис недоступен или если запрос или электронная таблица имеют высокую сложность. Ниже приведены некоторые рекомендации по снижению частоты ошибок 503 путем изменения запросов к API и используемой электронной таблицы.

Запрос

  • Используйте batchUpdate для объединения связанных обновлений в один запрос. Будьте осторожны при пакетной обработке больших обновлений, так как это может привести к превышению времени ожидания.
  • Ограничьте количество одновременных запросов к API для каждой электронной таблицы до 1 запроса в секунду.
  • Для больших электронных таблиц извлекайте только необходимые значения, используя обозначение A1 , и ограничьте использование includeGridData .
  • Используйте маски полей , чтобы ограничить объем данных, возвращаемых API.
  • При повторной отправке запросов используйте экспоненциальную задержку.

Электронная таблица

  • Для часто обновляемых таблиц рекомендуется периодически переходить на новую электронную таблицу, чтобы уменьшить накопление версий.
  • Ограничьте использование IMPORTRANGE , QUERY и других сложных формул.
  • Рассмотрите возможность разделения больших электронных таблиц на несколько отдельных таблиц.
  • Ограничьте использование одной электронной таблицы в качестве источника для множества формул IMPORTRANGE .
  • Ограничьте доступ к электронной таблице только для тех, кому это необходимо.