Oprócz danych wartości zawartych w komórkach a arkusz kalkulacyjny zawiera wiele innych typów danych, takich jak:
- Wymiary
- Formaty i obramowania komórek
- Zakresy nazwane
- Zakresy chronione
- Formatowanie warunkowe
To tylko niektóre z wielu rodzajów danych, które kontrolują wygląd i działanie arkusza kalkulacyjnego. Metoda spreadsheets.batchUpdate umożliwia aktualizowanie dowolnych szczegółów arkusza kalkulacyjnego. Zmiany są grupowane w pakiet, dzięki czemu jeśli jedno żądanie się nie powiedzie, żadne z pozostałych (potencjalnie zależnych) zmian nie zostaną zapisane.
Ta strona zawiera podstawowe informacje o korzystaniu z
spreadsheets.batchUpdate
metody. Jeśli musisz odczytywać i zapisywać dane wartości komórek, możesz też użyć zasobu
spreadsheets.values
opisanego w
Odczytywanie i zapisywanie wartości komórek.
Kategorie operacji
Operacje obsługiwane przez spreadsheets.batchUpdate można podzielić na te ogólne kategorie:
| Kategoria | Opis |
|---|---|
| Dodaj (i Duplikuj) | Dodawanie nowych obiektów (czasami na podstawie starych, jak w przypadku żądań duplikowania). |
| Aktualizuj (i Ustaw) | Aktualizowanie niektórych właściwości obiektu, zwykle bez zmiany starych właściwości (natomiast żądanie ustawienia zastępuje poprzednie dane). |
| Usuń | Usuwanie obiektów. |
Te kategorie są używane w następnej sekcji do opisania działania konkretnych operacji.
Operacje aktualizacji zbiorczej
Metoda spreadsheets.batchUpdate działa poprzez pobieranie co najmniej 1
obiektu żądania, z których każdy określa pojedynczy rodzaj żądania do wykonania. Istnieje wiele różnych rodzajów żądań. Oto zestawienie typów żądań pogrupowanych w różne kategorie.
Istnieją też dodatkowe żądania, które naśladują działania użytkownika 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 pól
Wiele żądań „aktualizacji” wymaga masek pól. Jest to rozdzielona przecinkami lista pól, które mają być aktualizowane, aby zmieniać tylko określone pola w obiekcie, a pozostałe pozostawić bez zmian. Maska pola * jest traktowana jak symbol wieloznaczny i jest skrótem do określenia każdego pola w wiadomości (co oznacza, że pole może powrócić do stanu domyślnego, jeśli nie określisz jego wartości w żądaniu).
Więcej informacji o maskach pól znajdziesz w artykule Używanie masek
pól.
Ten przykład używa
UpdateSpreadsheetPropertiesRequest
, aby zaktualizować tylko tytuł arkusza kalkulacyjnego:
Żądanie:
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 takich przypadkach odpowiedź jest pusta.
Zwykle żądania „dodawania” mają odpowiedzi, które zwracają informacje takie jak identyfikator dodanego obiektu. Listę obsługiwanych odpowiedzi znajdziesz w artykule Odpowiedzi.
Przykład
Ten przykładowy kod wykonuje te działania:
- Aktualizuje tytuł arkusza kalkulacyjnego za pomocą zmiennej
title. - Wyszukuje i zastępuje wartości komórek w arkuszu kalkulacyjnym za pomocą zmiennych
findireplacement.