ВАЖНО
❌Google-таблицы НЕ предназначены для быстрой работы с большим объемом данных❌
❌Google-таблицы НЕ рекомендуется использовать для финального продукта❌
❌По работоспособности интеграции с google-таблицами НЕТ и НЕ будет никаких гарантий❌
❌По ошибка сценариев с использованием google-таблиц техническая поддержка не оказывается❌
В ответе сервера на запрос к новому 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 ответ сервера будет содержать информацию о том, где именно допущена ошибка, и иметь примерно следующий вид:
{
"detail": [
{
"loc": [
"query",
"spreadsheet_url"
],
"msg": "field required",
"type": "value_error.missing"
}
]
}
где:
| Параметр | Значение |
|---|---|
| loc | Место, где допущена ошибка: |
| msg | Описание ошибки, например: field_required - пропущено поле, обязательное для заполнения value is not a valid {type} - значение параметра не соответствует требуемому типу |
| type | Тип ошибки, например: |