Oprócz danych wartości zawartych w komórkach arkusz kalkulacyjny zawiera wiele innych typów. danych, takich jak:
- 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
operacji w arkuszu kalkulacyjnym. Metoda spreadsheets.batchUpdate
umożliwia:
dowolnego z tych danych w arkuszu kalkulacyjnym. Zmiany są grupowane zbiorczo,
jeśli jedno żądanie nie powiedzie się, żadne inne (potencjalnie zależne)
zmiany są zapisywane.
Na tej stronie znajdują się podstawowe informacje na temat korzystania z
spreadsheets.batchUpdate
. Jeśli chcesz odczytać i zapisać dane wartości komórek, możesz też użyć funkcji
spreadsheets.values
zasób opisany w sekcji Odczyt i zapisz wartości komórek.
Kategorie działania
Konkretne operacje obsługiwane przez funkcję spreadsheets.batchUpdate
można grupować
można podzielić na następujące 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, |
Kategorie te są używane w następnej sekcji do opisania działania konkretnych operacji.
Operacje aktualizacji zbiorczej
Metoda spreadsheets.batchUpdate
działa, gdy
Wyślij prośbę
każdy z nich określa jeden rodzaj żądania do wykonania. Znaleziono
do zgłaszania wielu różnych rodzajów próśb. Oto podział na typy żądań:
pogrupowane według różnych kategorii.
Występują też dodatkowe żądania, które naśladują działania użytkowników związane z manipulacją dane:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Limity
Więcej informacji o limitach komórek i wierszy w Arkuszach Google znajdziesz w artykule Pliki, w których można przechowywać pliki Dysk Google.
Maski pola
Wiele „aktualizacji” żądania wymagają masek pól. Są one rozdzielane przecinkami
z listą pól do zaktualizowania tylko niektórych pól w obiekcie, pozostawiając pole
nie zmieniono innych pól. Maska pola *
jest traktowana jak
symbol zastępczy i jest skrótem do określania każdego pola w wiadomości (co oznacza,
pole może zostać przywrócone do stanu domyślnego, jeśli nie określisz jego wartości w
prośbę).
Więcej informacji na temat masek pól znajdziesz w sekcji Używanie pola
.
W przykładzie poniżej użyto
UpdateSpreadsheetPropertiesRequest
aby zaktualizować tylko tytuł 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. Te są zwracane w tablicy, przy czym każda odpowiedź zajmuje ten sam indeks odpowiednie żądanie. Niektóre żądania nie mają odpowiedzi. W przypadku odpowiedź jest pusta.
Zwykle „dodaj” żądania 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 za pomocą funkcji
find
ireplacement
zmiennych.