API Google Таблиц позволяет управлять данными в электронных таблицах различными способами. Большинство функций, доступных пользователям, работающим с пользовательским интерфейсом Таблиц, также доступны с API Таблиц. Примеры на этой странице иллюстрируют, как выполнять некоторые распространённые операции с электронными таблицами с помощью API Таблиц.
Эти примеры представлены в виде HTTP-запросов, чтобы не зависеть от языка. Чтобы узнать, как реализовать пакетное обновление на разных языках с помощью клиентских библиотек API Google, см. раздел Обновление электронных таблиц .
В этих примерах плейсхолдеры SPREADSHEET_ID и SHEET_ID указывают, где следует указать эти идентификаторы. Идентификатор таблицы можно найти в URL-адресе таблицы. Получить идентификатор листа можно с помощью метода spreadsheets.get . Диапазоны указываются в формате A1 . Пример диапазона: Sheet1!A1:D5.
Применить проверку данных к диапазону
В следующем примере кода spreadsheets.batchUpdate показано, как использовать SetDataValidationRequest для применения правила проверки данных, где «значение > 5», к каждой ячейке в диапазоне A1:D10.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"setDataValidation": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"rule": {
"condition": {
"type": "NUMBER_GREATER",
"values": [
{
"userEnteredValue": "5"
}
]
},
"inputMessage": "Value must be > 5",
"strict": true
}
}
}
]
}Копировать и вставить форматирование ячеек
В следующем примере кода spreadsheets.batchUpdate показано, как использовать CopyPasteRequest для копирования форматирования только из диапазона A1:D10 и вставки его в диапазон F1:I10 на том же листе. Метод использует перечисление PasteType с PASTE_FORMAT для вставки только форматирования и проверки данных. Исходные значения в диапазоне A1:D10 остаются неизменными.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"copyPaste": {
"source": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"destination": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 5,
"endColumnIndex": 9
},
"pasteType": "PASTE_FORMAT",
"pasteOrientation": "NORMAL"
}
}
]
}Вырезать и вставить ячейки
В следующем примере кода spreadsheets.batchUpdate показано, как использовать метод CutPasteRequest . Он вырезает диапазон A1:D10 и использует перечисление PasteType с параметром PASTE_NORMAL для вставки его значений, формул и форматирования, а затем объединяет их с диапазоном F1:I10 на том же листе. Содержимое ячеек исходного диапазона удаляется.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"cutPaste": {
"source": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"destination": {
"sheetId": SHEET_ID,
"rowIndex": 0,
"columnIndex": 5
},
"pasteType": "PASTE_NORMAL"
}
}
]
}Повторить формулу в диапазоне
В следующем примере кода spreadsheets.batchUpdate показано, как использовать RepeatCellRequest для копирования формулы =FLOOR(A1*PI()) в диапазон B1:D10. Диапазон формулы автоматически увеличивается для каждой строки и каждого столбца диапазона, начиная с левой верхней ячейки. Например, в ячейке B1 задана формула =FLOOR(A1*PI()) , а в ячейке D6 — =FLOOR(C6*PI()) .
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 1,
"endColumnIndex": 4
},
"cell": {
"userEnteredValue": {
"formulaValue": "=FLOOR(A1*PI())"
}
},
"fields": "userEnteredValue"
}
}
]
}Сортировка диапазона с несколькими параметрами сортировки
В следующем примере кода spreadsheets.batchUpdate показано, как использовать SortRangeRequest для сортировки диапазона A1:D10 сначала по столбцу B в порядке возрастания, затем по столбцу C в порядке убывания, затем по столбцу D в порядке убывания.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"sortRange": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"sortSpecs": [
{
"dimensionIndex": 1,
"sortOrder": "ASCENDING"
},
{
"dimensionIndex": 2,
"sortOrder": "DESCENDING"
},
{
"dimensionIndex": 3,
"sortOrder": "DESCENDING"
}
]
}
}
]
}