Операции с данными

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"
          }
        ]
      }
    }
  ]
}