...
В ответе сервера на запрос к новому 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 ответ сервера будет содержать информацию о том, где именно допущена ошибка, и иметь примерно следующий вид:
...