ВАЖНО

❌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

Место, где допущена ошибка:
query - ошибка в параметрах
body - в теле запроса
Далее приводится сам параметр, в котором допущена ошибка, например:
spreadsheet_url - ошибка в URL запроса
mode - ошибка в параметре mode

msgОписание ошибки, например:
field_required - пропущено поле, обязательное для заполнения
value is not a valid {type} - значение параметра не соответствует требуемому типу
type

Тип ошибки, например:
value_error.missing - значение отсутствует
type_error.{type} - тип параметра не соответствует


  • Нет меток