Operacje na wierszach i kolumnach

Interfejs Google Sheets API umożliwia dodawanie, usuwanie i manipulowanie wierszami oraz kolumnami 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 formie żądań HTTP, aby były niezależne od języka. Aby dowiedzieć się, jak zaimplementować aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsu API Google, przeczytaj artykuł Aktualizowanie arkuszy kalkulacyjnych.

W tych przykładach symbole zastępcze SPREADSHEET_ID i SHEET_ID wskazują miejsca, w których należy podać te identyfikatory. Identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL arkusza. Identyfikator arkusza możesz uzyskać za pomocą metody spreadsheets.get. Zakresy są określone za pomocą notacji A1. Przykładowy zakres to Arkusz1!A1:D5.

Dostosowywanie szerokości kolumny lub wysokości wiersza

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

Protokół żądania jest widoczny 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 przykładowy kod spreadsheets.batchUpdate pokazuje, jak używać metody AppendDimensionRequest do dodawania wierszy i kolumn. Pierwsze żądanie dodaje 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 widoczny 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 przykładowy kodspreadsheets.batchUpdate pokazuje, jak za pomocą funkcjiAutoResizeDimensionsRequest zmienić rozmiar kolumn A:C na podstawie rozmiaru zawartości kolumny. Pole dimension wskazuje, że operacja dotyczy kolumn arkusza.

Protokół żądania jest widoczny 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 przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą metody AutoResizeDimensionsRequest wyczyścić wysokości pierwszych 3 wierszy. Wysokość wierszy będzie 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 widoczny 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 przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą metody DeleteDimensionRequest usunąć pierwsze 3 wiersze w arkuszu. Drugie żądanie usuwa kolumny B:D. Pole dimension określa, czy operacja ma być zastosowana do kolumn czy wierszy arkusza.

Protokół żądania jest widoczny 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 przykładowy kodspreadsheets.batchUpdate pokazuje, jak za pomocą metody InsertDimensionRequest wstawiać kolumny lub wiersze w określonym indeksie (np. dodawać puste wiersze na początku arkusza). Pierwsze żądanie wstawia 2 puste kolumny w kolumnie C. Druga prośba wstawia 3 puste wiersze, zaczynając od wiersza 1.

Pole dimension określa, czy operacja ma być zastosowana do kolumn czy wierszy arkusza.

Jeśli ma wartość „true”, pole inheritFromBefore informuje interfejs Arkuszy, że nowe kolumny lub wiersze mają mieć takie same właściwości jak poprzedni wiersz lub kolumna. Jeśli ma wartość „false”, nowe kolumny lub wiersze dziedziczą właściwości z wymiarów po nowych kolumnach lub wierszach. inheritFromBefore nie może mieć wartości „prawda”, jeśli wstawiasz wiersz w wierszu 1 lub kolumnę w kolumnie A.

Protokół żądania jest widoczny 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 przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji MoveDimensionRequest przenieść kolumnę A na pozycję kolumny D. Drugie żądanie przenosi wiersze 5–10 do wiersza 20.

Pole dimension określa, czy operacja ma być zastosowana do 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 widoczny 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
      }
    },
  ],
}