Interfejs API Arkuszy Google umożliwia dodawanie i usuwanie wierszy oraz kolumn oraz manipulowanie nimi w . Przykłady na tej stronie pokazują, jak niektóre popularne wiersze i kolumny Operacje można wykonać za pomocą interfejsu Arkuszy API.
Przykłady te są przedstawione w formie żądań HTTP, które stanowią język. i nie mam zdania. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsów API Google, przeczytaj artykuł Aktualizacja arkusze kalkulacyjne.
W tych przykładach zmienne SPREADSHEET_ID
i SHEET_ID
wskazuje, gdzie należy je podać. Arkusz kalkulacyjny można znaleźć
ID w adresie URL arkusza kalkulacyjnego. Możesz uzyskać
identyfikator arkusza za pomocą funkcji
spreadsheets.get
.
zakresy określa się w notacji A1. An
przykładowy zakres to Arkusz1!A1:D5.
Dostosowywanie szerokości kolumny i wysokości wiersza
Poniżej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak używać parametru
UpdateDimensionPropertiesRequest
zmień właściwość szerokości kolumny A na 160 pikseli. Aktualizacja drugiej prośby
ustawienie wysokości wiersza pierwszych 3 wierszy na 40 pikseli. dimension
określa, czy operacja ma zastosowanie do kolumn czy wierszy
arkusza kalkulacyjnego.
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
Poniżej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak używać parametru
AppendDimensionRequest
, aby dołączyć wiersze i kolumny. Pierwsze żądanie dołącza trzy puste wiersze do parametru
na końcu arkusza, a drugi – jedną pustą kolumnę. dimension
określa, czy operacja ma zastosowanie do kolumn czy wierszy
arkusza kalkulacyjnego.
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
Poniżej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak korzystać z
AutoResizeDimensionsRequest
aby zmienić rozmiar kolumn A:C w zależności od rozmiaru zawartości kolumny. dimension
wskazuje, że operacja ma zastosowanie do 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
}
}
}
]
}
Automatyczne zmienianie rozmiaru wiersza
Poniżej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak używać parametru
AutoResizeDimensionsRequest
aby wyczyścić wysokość pierwszych 3 wierszy. Wysokość wiersza rośnie,
dynamicznie na podstawie zawartości komórek w każdym wierszu. 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żej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak korzystać z
DeleteDimensionRequest
, aby 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
Poniżej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak używać parametru
InsertDimensionRequest
w celu wstawienia kolumn lub wierszy o określonym indeksie (np. na początku pustych wierszy
u góry 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 pole inheritFromBefore
ma wartość prawda, interfejs Arkuszy API ma przekazywać
nowe kolumny lub wiersze mają te same właściwości co poprzedni wiersz lub poprzedni wiersz oraz jeśli
false, aby dziedziczyć wymiary po nowych kolumnach lub wierszach.
inheritFromBefore
nie może mieć wartości prawda, jeśli wstawisz wiersz w wierszu 1 lub kolumnie na
kolumna 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żej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak używać parametru
MoveDimensionRequest
, aby przenieść kolumnę A do pozycji D. Druga prośba powoduje przeniesienie wierszy
5–10 do pozycji wiersza 20.
Pole dimension
określa, czy operacja ma zastosowanie do kolumn, czy
wierszy arkusza. Pole destinationIndex
określa, gdzie należy przenieść
za pomocą 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 } }, ], }