Interfejs Google Sheets API umożliwia dodawanie i usuwanie wierszy oraz kolumn w arkuszach oraz manipulowanie nimi. Przykłady na tej stronie pokazują, jak można wykonywać typowe operacje na wierszach i kolumnach za pomocą interfejsu Sheets API.
Przykłady te są przedstawione w formie żądań HTTP, aby były neutralne językowo. Aby dowiedzieć się, jak za pomocą bibliotek klienta interfejsu API Google wdrożyć zbiorcze aktualizowanie w różnych językach, przeczytaj artykuł Aktualizowanie arkuszy kalkulacyjnych.
W tych przykładach obiekty zastępcze SPREADSHEET_ID i SHEET_ID wskazują, gdzie należy podać te identyfikatory. Identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL arkusza. Identyfikator arkusza możesz uzyskać, korzystając z metody spreadsheets.get. Zakresy są określane za pomocą notacji A1. Przykładowy zakres to Arkusz1!A1:D5.
Dostosowywanie szerokości kolumny lub wysokości wiersza
Ten przykładowy kod spreadsheets.batchUpdate pokazuje, jak użyć funkcji UpdateDimensionPropertiesRequest, aby zaktualizować właściwość width kolumny A do 160 pikseli. Drugie żądanie aktualizuje właściwość wysokości wiersza w przypadku 3 pierwszych wierszy, ustawiając ją na 40 pikseli. Pole dimensionokreśla, czy operacja ma dotyczyć kolumn czy wierszy arkusza.
Protokół żądania przedstawiono 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"
}
}
]
}
Dodawanie pustych wierszy lub kolumn
Poniższy przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji AppendDimensionRequest dołączać wiersze i kolumny. Pierwsze żądanie dołącza 3 puste wiersze do końca arkusza, a drugie – jedną pustą kolumnę. Pole dimensionokreśla, czy operacja ma dotyczyć kolumn czy wierszy arkusza.
Protokół żądania przedstawiono 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
Ten przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji AutoResizeDimensionsRequestzmienić rozmiar kolumn A:C na podstawie rozmiaru zawartości kolumny. Pole dimension wskazuje, że operacja dotyczy kolumn arkusza.
Protokół żądania przedstawiono 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 użyć metody AutoResizeDimensionsRequest, aby usunąć wysokość trzech pierwszych wierszy. Następnie ich wysokość 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 przedstawiono 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
Ten przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji DeleteDimensionRequest usunąć 3 pierwsze wiersze arkusza. Drugie żądanie usuwa kolumny B:D.
Pole dimension określa, czy operacja ma dotyczyć kolumn czy wierszy arkusza.
Protokół żądania przedstawiono 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 pustej kolumny
Poniższy przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji InsertDimensionRequest wstawiać kolumny lub wiersze pod określonym indeksem (np. dodawać puste wiersze na początku arkusza). Pierwsze polecenie wstawia 2 puste kolumny w miejscu kolumny C.
Druga prośba wstawia 3 puste wiersze, zaczynając od wiersza 1.
Pole dimension określa, czy operacja ma dotyczyć kolumn czy wierszy arkusza.
Jeśli wartość to prawda, pole inheritFromBefore informuje interfejs Sheets API, aby nadać nowym kolumnom lub wierszom te same właściwości co poprzedni wiersz lub kolumna, a jeśli wartość to fałsz, dziedziczy właściwości z wymiarów po nowych kolumnach lub wierszach.
Warunek inheritFromBefore nie może być spełniony, jeśli wstawiasz wiersz w wierszu 1 lub kolumnę w kolumnie A.
Protokół żądania przedstawiono 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
Ten przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji MoveDimensionRequest przenieść kolumnę A do pozycji kolumny D. Druga prośba przenosi wiersze 5–10 na pozycję 20.
Pole dimension określa, czy operacja ma dotyczyć kolumn czy wierszy arkusza. Pole destinationIndex określa, gdzie należy przenieść dane źródłowe, używając indeksu początkowego opartego na 0.
Protokół żądania przedstawiono 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
}
},
],
}