...
Ссылка на swagger-документацию: httphttps://intgrgspread.twin24.io:60061/docs
Чтение данных из таблицы
Ссылка на документацию по методу
httphttps://intgrgspread.twin24.io:60061/docs#/Get%20Data/Get_data_from_spreadsheet_get_data_get
Метод, URL и авторизация
Метод: GET
Authorization: No Auth
URL: httphttps://intgrgspread.twin24.io:60061/get_data
Описание параметров метода
Параметр | Обязательность | Описание |
|---|---|---|
spreadsheet_url | да | Ссылка на гугл таблицу |
worksheet_name | нет | Имя "листа", из которого будут получены данные Если отсутствует, то будет использован первый лист |
| filter_headers | нет | Имя заголовков столбцов, по которым будет происходить фильтрация Для передачи нескольких заголовков используется разделитель [///] Например: Хотим использовать заголовки Имя и Телефон Тогда в filter_headers передаем значение Имя[///]Телефон |
filter_values | нет | Значение фильтров по заголовкам Для передачи нескольких заголовков используется разделитель [///] Например: Используя пример с Имя и Телефон, хотим найти Иван с номером 79991234567 Тогда в filter_values передаем значение Иван[///]79991234567 |
Пример запроса (URL)
httphttps://intgrgspread.twin24.io:60061/get_data?spreadsheet_url=https://docs.google.com/spreadsheets/d/1J3SR6E3cH6EJ5Z...3rEx3fX0/edit%23gid=0&worksheet_name=Лист1&filter_headers=Группа[///]Дата&filter_values=1[///]22.01.2022
Пример ответа
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
{
"count": 2,
"data": [
{
"Идентификатор": "7f2e8a0c-4d6f-4d9d-8c2f-7f1c9e7a1c8a",
"Группа": 1,
"Фамилия": "Кузнецова",
"Имя": "Анна",
"Отчество": "Ивановна",
"Дата": "22.01.2022",
"Row": 2
},
{
"Идентификатор": "3f6d4b21-8e4a-4f5d-9b7d-1c3d0f6e9c5b",
"Группа": 1,
"Фамилия": "Лебедев",
"Имя": "Артем",
"Отчество": "Александрович",
"Дата": "22.01.2022",
"Row": 3
}
],
"filter_used": true,
"filter_headers": [
"Группа",
"Дата"
],
"filter_values": [
"1",
"22.01.2022"
],
"msg": "Ok"
} |
...
Ссылка на документацию по методу
httphttps://intgrgspread.twin24.io:60061/docs#/Add%2C%20delete%20or%20update%20data/Add_row_s__to_a_spreadsheet_add_rows_post
Метод, URL, авторизация и тело
...
Authorization: No Auth
URL: httphttps://intgrgspread.twin24.io:60061/add_rows
Body:
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
{
"data": [
[
"Test",
1,
"Just string"
],
[
"Test",
2,
"=A1"
]
]
} |
...
Параметр | Обязательность | Описание |
|---|---|---|
spreadsheet_url | да | Ссылка на гугл таблицу |
worksheet_name | нет | Имя "листа", из которого будут получены данные Если отсутствует, то будет использован первый лист |
| empty | нет | Выбор режима записи одной строки (если строк несколько - игнорируется):
*Первый режим работает значительно быстрее второго, так как не требует поиска пустой строки |
mode | нет | Выбор режима обработки переданных в таблицу данных:
|
...
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
curl --location 'httphttps://intgrgspread.twin24.io:60061/add_rows?spreadsheet_url=https%3A%2F%2Fdocs.google.com%2Fspreadsheets%2Fd%2F1J3SR6E3cH6EJ5Z...3rEx3fX0%2Fedit%23gid%3D0&worksheet_name=%D0%9B%D0%B8%D1%81%D1%821&mode=1' \ --header 'accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "data": [ [ "Test", 1, "Just string" ], [ "Test", 2, "=A1" ] ] }' |
...
Ссылка на документацию по методу
httphttps://intgrgspread.twin24.io:60061/docs#/Add%2C%20delete%20or%20update%20data/Delete_row_s__from_a_spreadsheet_delete_rows_delete
Метод, URL и авторизация
Метод: DELETE
Authorization: No Auth
URL: httphttps://intgrgspread.twin24.io:60061/delete_rows
Описание параметров метода
Параметр | Обязательность | Описание |
|---|---|---|
spreadsheet_url | да | Ссылка на гугл таблицу |
worksheet_name | нет | Имя "листа", из которого будут получены данные Если отсутствует, то будет использован первый лист |
| start | да | Номер строки - начало диапазона для удаления *Если передан только параметр start, то будет удалена одна строка, номер который передан в этом параметре. |
| end | нет | Номер строки - конец диапазона для удаления *Если передан только параметр start, то будет удалена одна строка, номер который передан в этом параметре. |
Пример запроса (URL)
httphttps://intgrgspread.twin24.io:60061/delete_rows?start=18&end=23&spreadsheet_url=https://docs.google.com/spreadsheets/d/1J3SR6E3cH6EJ5Z...3rEx3fX0/edit%23gid=0&worksheet_name=Лист1
Пример ответа
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
{
"msg": "Ok"
} |
...
Ссылка на документацию по методу
httphttps://intgrgspread.twin24.io:60061/docs#/Add%2C%20delete%20or%20update%20data/Update_cell_s__on_a_spreadsheet_update_cells_post
Метод, URL, авторизация и тело
...
Authorization: No Auth
URL: httphttps://intgrgspread.twin24.io:60061/update_cells
Body:
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
{
"range": "C18",
"data": [
[
0,
"=A5"
],
[
"Test"
]
]
} |
...
Параметр | Обязательность | Описание |
|---|---|---|
spreadsheet_url | да | Ссылка на гугл таблицу |
worksheet_name | нет | Имя "листа", из которого будут получены данные Если отсутствует, то будет использован первый лист |
mode | нет | Выбор режима обработки переданных в таблицу данных:
|
...
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
curl -X 'POST' \ 'httphttps://intgrgspread.twin24.io:60061/update_cells?spreadsheet_url=https%3A%2F%2Fdocs.google.com%2Fspreadsheets%2Fd%2F1J3SR6E3cH6EJ5Z...3rEx3fX0%2Fedit%23gid%3D0&worksheet_name=%D0%9B%D0%B8%D1%81%D1%821&mode=1' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "range": "C19", "data":"=B1" }' |
...
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
curl -X 'POST' \ 'httphttps://intgrgspread.twin24.io:60061/update_cells?spreadsheet_url=https%3A%2F%2Fdocs.google.com%2Fspreadsheets%2Fd%2F1J3SR6E3cH6EJ5Z...3rEx3fX0%2Fedit%23gid%3D0&worksheet_name=%D0%9B%D0%B8%D1%81%D1%821&mode=1' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "range": "C18", "data": [ [ 0, "=A5" ], [ "Test" ] ] }' |
...