Oprócz danych wartości znajdujących się w komórkach arkusz kalkulacyjny zawiera wiele innych typów danych, na przykład:
- Wymiary
- Formaty komórek i obramowanie
- Zakresy nazwane
- Zakresy chronione
- Formatowanie warunkowe
Oto niektóre z wielu rodzajów danych, które kontrolują wygląd i działanie arkusza kalkulacyjnego. Metoda spreadsheets.batchUpdate
pozwala zaktualizować szczegóły arkusza kalkulacyjnego. Zmiany są grupowane zbiorczo, tak aby w przypadku niepowodzenia jednego żądania nie zapisano żadnej (potencjalnie zależnej) zmiany.
Na tej stronie znajdziesz podstawowe informacje o korzystaniu z metody spreadsheets.batchUpdate
. Jeśli chcesz odczytywać i zapisywać dane wartości komórek, możesz też użyć zasobu spreadsheets.values
opisanego w artykule Odczyt i zapis wartości komórek.
Kategorie działania
Konkretne operacje obsługiwane przez spreadsheets.batchUpdate
można podzielić na te ogólne kategorie:
Kategoria | Opis |
---|---|
Dodaj (i Duplikuj) | Dodaj nowe obiekty (czasami na podstawie starych, np. w postaci żądań zduplikowanych). |
Aktualizuj (i Ustaw) | Aktualizują niektóre właściwości obiektu, zwykle pozostawiając stare właściwości bez zmian (podczas gdy żądanie Set zastępuje wcześniejsze dane). |
Usuń | usuwać obiekty, |
Te kategorie będą używane w następnej sekcji do opisywania zachowania określonych operacji.
Operacje aktualizacji zbiorczej
Metoda spreadsheets.batchUpdate
działa, gdy przyjmuje co najmniej 1 obiekt Request, z których każdy określa 1 rodzaj żądania do wykonania. Jest wiele różnych rodzajów wniosków. Oto podział na typy żądań podzielone na różne kategorie.
Występują też dodatkowe żądania, które naśladują działania użytkowników związane z manipulowaniem danymi:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Limity
Więcej informacji o limitach komórek i wierszy w Arkuszach Google znajdziesz w artykule Pliki, które możesz przechowywać na Dysku Google.
Maski pola
Wiele żądań aktualizacji wymaga masek pól. Jest to lista wartości rozdzielonych przecinkami, która służy do aktualizowania tylko niektórych pól w obiekcie, bez zmian w pozostałych. Maska pola *
jest traktowana jak symbole wieloznaczne i służy do określania każdego pola w wiadomości (co oznacza, że jeśli nie określisz wartości pola w żądaniu, może ono zostać przywrócone do stanu domyślnego).
Więcej informacji o maskach pól znajdziesz w artykule Używanie masek pól.
W tym przykładzie użyto właściwości UpdateSpreadsheetPropertiesRequest
do aktualizowania tylko tytułu arkusza kalkulacyjnego:
Prośba:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
Treść żądania:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
Zastąp TITLE nowym tytułem arkusza kalkulacyjnego.
Odpowiedzi
Podczas aktualizowania arkusza kalkulacyjnego niektóre rodzaje żądań mogą zwracać odpowiedzi. Są one zwracane w tablicy, a każda odpowiedź zajmuje ten sam indeks co odpowiadające jej żądanie. Niektóre żądania nie mają odpowiedzi, a w przypadku tych odpowiedzi jest pusta.
Zwykle żądania „dodania” zawierają odpowiedzi, które zwracają informacje, takie jak identyfikator dodanego obiektu. Listę obsługiwanych odpowiedzi znajdziesz w sekcji Odpowiedzi.
Przykład
Następujący przykładowy kod wykonuje te działania:
- Aktualizuje tytuł arkusza kalkulacyjnego za pomocą zmiennej
title
. - Znajduje i zastępuje wartości komórek w arkuszu kalkulacyjnym przy użyciu zmiennych
find
ireplacement
.