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