Interfejs Google Arkuszy API umożliwia dodawanie i usuwanie wierszy oraz kolumn w arkuszach oraz manipulowanie nimi. Przykłady na tej stronie pokazują, jak za pomocą interfejsu Arkuszy API można wykonywać niektóre typowe operacje na wierszach i kolumnach.
Przykłady te mają postać żądań HTTP, które nie wpływają na język. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsu API Google, przeczytaj artykuł o aktualizowaniu arkuszy kalkulacyjnych.
W tych przykładach obiekty zastępcze SPREADSHEET_ID i SHEET_ID wskazują, gdzie należy podać te identyfikatory. Ten identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL arkusza kalkulacyjnego. Identyfikator arkusza możesz uzyskać za pomocą metody spreadsheets.get. Zakresy określa się w notacji A1. Przykładowy zakres to Arkusz1!A1:D5.
Dostosowywanie szerokości kolumny i wysokości wiersza
Z przykładowego kodu spreadsheets.batchUpdate dowiesz się, jak za pomocą UpdateDimensionPropertiesRequest zaktualizować właściwość szerokości w kolumnie A na 160 pikseli. Drugie żądanie aktualizuje właściwość wysokości wierszy w pierwszych 3 wierszach do 40 pikseli. Pole dimension określa, czy operacja ma zastosowanie do 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łącz puste wiersze lub kolumny
Z przykładowego kodu spreadsheets.batchUpdate dowiesz się, jak za pomocą AppendDimensionRequest dołączać wiersze i kolumny. Pierwsze żądanie dołącza 3 puste wiersze na końcu arkusza, a drugie – jedną pustą kolumnę. Pole dimension określa, czy operacja ma zastosowanie do 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
}
}
]
}
Automatyczne zmienianie rozmiaru kolumny
Z przykładowego kodu spreadsheets.batchUpdate dowiesz się, jak za pomocą narzędzia AutoResizeDimensionsRequest zmieniać rozmiar kolumn A:C w zależności od rozmiaru zawartości kolumny. Pole dimension wskazuje, że operacja ma zastosowanie do kolumn w arkuszu.
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
}
}
}
]
}
Automatyczne zmienianie rozmiaru wiersza
Z przykładowego kodu spreadsheets.batchUpdate dowiesz się, jak za pomocą AutoResizeDimensionsRequest wyczyścić wysokość pierwszych 3 wierszy. Wysokość wierszy rośnie dynamicznie na podstawie zawartości komórek w każdym wierszu. Pole dimension wskazuje, że operacja ma zastosowanie do 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ą polecenia DeleteDimensionRequest usunąć pierwsze 3 wiersze arkusza. Drugie żądanie powoduje usunięcie kolumn B:D.
Pole dimension określa, czy operacja ma zastosowanie 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
Z przykładowego kodu spreadsheets.batchUpdate dowiesz się, jak używać InsertDimensionRequest do wstawiania kolumn lub wierszy w określonym indeksie (np. na początku pustych wierszy 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 ma zastosowanie do kolumn czy wierszy arkusza.
Jeśli wartość to prawda, pole inheritFromBefore informuje interfejs API Arkuszy, że ma nadać nowym kolumnom lub wierszom te same właściwości co poprzedni wiersz, a jeśli fałsz, to aby dziedziczyć je z wymiarów po nowych kolumnach lub wierszach.
inheritFromBefore nie może mieć wartości prawda, jeśli wstawisz 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ą parametru MoveDimensionRequest przenieść kolumnę A do pozycji D. Drugie żądanie przenosi wiersze 5–10 do pozycji 20.
Pole dimension określa, czy operacja ma zastosowanie do kolumn czy wierszy arkusza. Pole destinationIndex określa, dokąd przenieść dane źródłowe, korzystając z indeksu początkowego liczonego od zera.
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
}
},
],
}