Interfejs API Arkuszy Google pozwala dodawać i usuwać wiersze oraz kolumny w arkuszach, a także nimi zarządzać. Przykłady na tej stronie pokazują, jak za pomocą interfejsu Sheets API można wykonywać niektóre typowe operacje na wierszach i kolumnach.
Mają one postać żądań HTTP, które mają być neutralne pod względem języka. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach przy użyciu bibliotek klienta interfejsu API Google, przeczytaj artykuł Aktualizowanie arkuszy kalkulacyjnych.
W tych przykładach obiekty zastępcze SPREADSHEET_ID
i SHEET_ID
wskazują, gdzie należy je umieścić. Identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL arkusza kalkulacyjnego. Identyfikator arkusza możesz uzyskać, korzystając z metody spreadsheets.get
. Zakresy są określane w notacji A1. Przykładowy zakres to Arkusz1!A1:D5.
Dostosowywanie szerokości kolumny lub wysokości wiersza
Poniższy przykładowy kod spreadsheets.batchUpdate
pokazuje, jak za pomocą UpdateDimensionPropertiesRequest
zmienić szerokość kolumny A na 160 pikseli. Drugie żądanie zmienia wartość wysokości wiersza w pierwszych 3 wierszach na 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łącz puste wiersze lub kolumny
Poniższy przykładowy kod spreadsheets.batchUpdate
pokazuje, jak za pomocą AppendDimensionRequest
dołączać wiersze i kolumny. 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 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 } } ] }
Automatyczne zmienianie rozmiaru kolumny
Poniższy przykładowy kod spreadsheets.batchUpdate
pokazuje, jak za pomocą komponentu AutoResizeDimensionsRequest
zmienić rozmiar kolumn A:C w zależności od rozmiaru zawartości kolumny. Pole dimension
wskazuje, że operacja dotyczy kolumn w arkuszu.
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
}
}
}
]
}
Automatycznie zmień rozmiar wiersza
Poniższy przykładowy kod spreadsheets.batchUpdate
pokazuje, jak za pomocą komponentu AutoResizeDimensionsRequest
wyczyścić wysokość pierwszych 3 wierszy. Wysokość wierszy zwiększa się dynamicznie
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 przykładowy kod spreadsheets.batchUpdate
pokazuje, jak za pomocą DeleteDimensionRequest
usunąć pierwsze 3 wiersze z arkusza. Drugie żądanie powoduje usunięcie kolumn 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 } } }, ], }
Wstaw pusty wiersz lub kolumnę
Poniższy przykładowy kod spreadsheets.batchUpdate
pokazuje, jak użyć InsertDimensionRequest
do wstawiania kolumn lub wierszy w określonym indeksie (np. do uzupełniania pustych wierszy u góry arkusza). Pierwsze żądanie powoduje wstawienie 2 pustych kolumn 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 ma wartość prawda, pole inheritFromBefore
informuje interfejs API Arkuszy, by nadać nowym kolumnom lub wierszom te same właściwości co poprzedni wiersz lub poprzedni wiersz, a w przypadku wartości fałsz – w przypadku dziedziczenia z wymiarów następujących po nowych kolumnach lub wierszach.
Funkcja inheritFromBefore
nie może mieć wartości prawda, jeśli wstawisz 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 przykładowy kod spreadsheets.batchUpdate
pokazuje, jak za pomocą MoveDimensionRequest
przenieść kolumnę A do pozycji w kolumnie D. Drugie żądanie przesuwa wiersze 5–10 na pozycję 20.
Pole dimension
określa, czy operacja dotyczy kolumn czy wierszy arkusza. Pole destinationIndex
określa, gdzie mają zostać przeniesione dane źródłowe, używając indeksu początkowego liczonego od zera.
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 } }, ], }