Operacje na wierszach i kolumnach

Interfejs Google Sheets API umożliwia dodawanie, usuwanie i modyfikowanie wierszy i kolumn w arkuszach. Przykłady na tej stronie pokazują, jak za pomocą interfejsu Sheets API można wykonywać niektóre typowe operacje na wierszach i kolumnach.

Przykłady te są przedstawione w postaci żądań HTTP, aby były niezależne od języka. Więcej informacji o tym, jak zaimplementować aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta Google API, znajdziesz w artykule Aktualizowanie arkuszy kalkulacyjnych.

W tych przykładach symbole zastępcze SPREADSHEET_ID i SHEET_ID wskazują, gdzie należy podać te identyfikatory. Identyfikator arkusza kalkulacyjnego znajdziesz w jego adresie URL. Identyfikator arkusza możesz uzyskać za pomocą spreadsheets.get metody. Zakresy są określane za pomocą notacji A1. Przykład zakresu: Arkusz1!A1:D5.

Dostosowywanie szerokości kolumny lub wysokości wiersza

Poniższy spreadsheets.batchUpdate przykładowy kod pokazuje, jak za pomocą UpdateDimensionPropertiesRequest zaktualizować właściwość szerokości kolumny A do 160 pikseli. Drugie żądanie aktualizuje właściwość wysokości wiersza pierwszych 3 wierszy do 40 pikseli. Pole dimension określa, czy operacja dotyczy kolumn czy wierszy arkusza.

Protokół żądania jest pokazany poniżej.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "properties": {
          "pixelSize": 160
        },
        "fields": "pixelSize"
      }
    },
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "properties": {
          "pixelSize": 40
        },
        "fields": "pixelSize"
      }
    }
  ]
}

Dołączanie pustych wierszy lub kolumn

Poniższy spreadsheets.batchUpdate przykładowy kod pokazuje, jak za pomocą AppendDimensionRequest dołączyć wiersze i kolumny. Pierwsze żądanie dołącza 3 puste wiersze na końcu arkusza, a drugie – 1 pustą kolumnę. Pole dimension określa, czy operacja dotyczy kolumn czy wierszy arkusza.

Protokół żądania jest pokazany poniżej.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "ROWS",
        "length": 3
      }
    },
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "COLUMNS",
        "length": 1
      }
    }
  ]
}

Automatyczna zmiana rozmiaru kolumny

Poniższy spreadsheets.batchUpdate przykładowy kod pokazuje, jak za pomocą AutoResizeDimensionsRequest zmienić rozmiar kolumn A:C na podstawie rozmiaru ich zawartości. Pole dimension wskazuje, że operacja dotyczy kolumn arkusza.

Protokół żądania jest pokazany poniżej.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Automatyczna zmiana rozmiaru wiersza

Poniższy spreadsheets.batchUpdate przykładowy kod pokazuje, jak za pomocą AutoResizeDimensionsRequest wyczyścić wysokości pierwszych 3 wierszy. Wysokości wierszy będą się wtedy dynamicznie zwiększać w zależności od zawartości komórek w każdym wierszu. Pole dimension wskazuje, że operacja dotyczy wierszy arkusza.

Protokół żądania jest pokazany poniżej.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Usuwanie wierszy lub kolumn

Poniższy spreadsheets.batchUpdate przykładowy kod pokazuje, jak za pomocą DeleteDimensionRequest usunąć pierwsze 3 wiersze w arkuszu. Drugie żądanie usuwa kolumny B:D. Pole dimension określa, czy operacja dotyczy kolumn czy wierszy arkusza.

Protokół żądania jest pokazany poniżej.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    },
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 1,
          "endIndex": 4
        }
      }
    },
  ],
}

Wstawianie pustego wiersza lub kolumny

Poniższy spreadsheets.batchUpdate przykładowy kod pokazuje, jak za pomocą InsertDimensionRequest wstawić kolumny lub wiersze na określonym indeksie (np. dodać puste wiersze na początku arkusza). Pierwsze żądanie wstawia 2 puste kolumny w kolumnie C. Drugie żądanie wstawia 3 puste wiersze, zaczynając od wiersza 1.

Pole dimension określa, czy operacja dotyczy kolumn czy wierszy arkusza.

Jeśli pole inheritFromBefore ma wartość true, interfejs Sheets API przypisuje nowym kolumnom lub wierszom te same właściwości co poprzedni wiersz lub kolumna. Jeśli ma wartość false, właściwości są dziedziczone z wymiarów po nowych kolumnach lub wierszach. Wartość inheritFromBefore nie może być równa true, jeśli wstawiasz wiersz w wierszu 1 lub kolumnę w kolumnie A.

Protokół żądania jest pokazany poniżej.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 2,
          "endIndex": 4
        },
        "inheritFromBefore": true
      }
    },
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "inheritFromBefore": false
      }
    },
  ],
}

Przenoszenie wiersza lub kolumny

Poniższy spreadsheets.batchUpdate przykładowy kod pokazuje, jak za pomocą MoveDimensionRequest przenieść kolumnę A do pozycji kolumny D. Drugie żądanie przenosi wiersze 5–10 do pozycji wiersza 20.

Pole dimension określa, czy operacja dotyczy kolumn czy wierszy arkusza. Pole destinationIndex określa, gdzie przenieść dane źródłowe, używając indeksu początkowego opartego na zerze.

Protokół żądania jest pokazany poniżej.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "destinationIndex": 3
      }
    },
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 4,
          "endIndex": 10
        },
        "destinationIndex": 19
      }
    },
  ],
}