Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

В ответе сервера на запрос к новому API для работы с Google-таблицами всегда возвращается поле msg, которое содержит в себе сообщение об успешности запроса, и если произошла ошибка, то ее описание.

Описание ответов на запросы

Код ответаОтвет сервераОписание
200"msg": "Ok"Запрос прошел успешно.
400

"msg": "Parameter spreadsheet_url is incorrect"

Передан некорректный URL Google-таблицы
403

"msg": "No access to spreadsheet [spreadsheet_url]. Grant access for user twin-gsheets@gspread-restapi.iam.gserviceaccount.com"

У пользователя twin-gsheets@gspread-restapi.iam.gserviceaccount.com нет доступа к таблице: нужно дать доступ для этого пользователя, либо сделать таблицу общедоступной.
404

"msg": "Worksheet {worksheet_name} not found"

В таблице не найден лист с названием, переданным в запросе. Убедитесь, что введено корректное название листа таблицы.
406

"msg": "Given headers are not unique"

В заголовках таблицы присутствуют одинаковые названия столбцов, либо совмещенные ячейки.
422

Описание ошибки валидации

Ошибка валидации: допущена ошибка в url либо в теле запроса.

Описание ошибок методов

Add rows

Код ответаОтвет сервераОписание
400'msg': 'Parameter "mode" could be 1 or None. {mode} passed'Параметр mode может иметь только значение 1, либо не передаваться.
400'msg': f'Parameter "empty" could be 1 or None. {empty} passed'Параметр empty может иметь только значение 1, либо не передаваться.

Delete rows

Код ответаОтвет сервера

Описание

400'msg': "Cannot delete a row(s) that doesn't exist"Невозможно удалить строку, которой не существует в таблице.

Update cells

Код ответаОтвет сервераОписание
400'msg': 'Parameter "mode" could be 1 or None. {mode} passed'Параметр mode может иметь только значение 1, либо не передаваться.

Описание ошибок валидации (код ответа 422)

При ошибке с кодом 422 ответ сервера будет содержать информацию о том, где именно допущена ошибка, и иметь примерно следующий вид:

...