W tej sekcji znajdziesz laboratorium kodu, które pomoże Ci zapoznać się z interfejsem Google Sheets API. Dostępny jest też zestaw przykładów „przepisów”, które pokazują, jak przekształcić działanie w Arkuszach Google w żądanie interfejsu API.
Często istnieje więcej niż 1 sposób wykonania danego zadania za pomocą interfejsu API. Gdy decydujesz się, jak podejść do zadania, pamiętaj o tych kwestiach:
- Jeśli musisz odczytywać lub zapisywać wartości komórek, kolekcja
spreadsheets.valuesjest lepszym wyborem niż kolekcjaspreadsheets. Interfejs tego narzędzia jest łatwiejszy w użyciu w przypadku prostych operacji odczytu/zapisu. W miarę możliwości używaj metod zbiorczych (
spreadsheet.batchUpdate,spreadsheet.values.batchGetispreadsheet.values.batchUpdate), aby łączyć wiele żądań w jednym wywołaniu metody. Korzystanie z tych metod zbiorczych zwiększa wydajność, ponieważ:- Zmniejsz obciążenie HTTP klienta.
- Zmniejsz liczbę wysyłanych zapytań.
- Zmniejsz liczbę wersji dokumentu.
- Zapewnij atomistyczną naturę wszystkich zmian w zbiorze.
Przepisy
Przykłady podane w tej sekcji pokazują, jak wyrażać typowe działania w Arkuszach jako żądania interfejsu Sheets API w wersji 4.
Przykłady te są przedstawione w formie żądań HTTP, aby były neutralne językowo. Aby dowiedzieć się, jak stosować protokoły żądań interfejsu Sheets API w określonym języku za pomocą bibliotek klienta interfejsu API Google, zapoznaj się z przewodnikami Czytanie i zapisywanie wartości komórek oraz Aktualizowanie arkuszy.
Przepisy w tej sekcji są podzielone na te kategorie:
- Podstawowe odczytywanie – przepisy, które pokazują, jak odczytywać wartości z arkusza.
- Podstawowe zapisywanie danych – przepisy, które pokazują, jak zapisywać wartości w arkuszu.
- Formatowanie podstawowe – przepisy, które pokazują, jak zmieniać wygląd arkuszy i komórek.
- Wykresy – przepisy, które pokazują, jak tworzyć i zmieniać wykresy w arkuszu.
- Formatowanie warunkowe – przepisy, które pokazują, jak zmieniać wygląd komórek na podstawie warunków.
- Operacje na danych – przepisy, które pokazują, jak tworzyć, przenosić i modyfikować dane w arkuszu kalkulacyjnym.
- Zakresy nazwane i chronione – przepisy pokazujące, jak tworzyć, aktualizować i usuwać zakresy nazwane i chronione w arkuszu kalkulacyjnym.
- Tabele przestawne – przepisy pokazujące, jak tworzyć tabele przestawne w arkuszu.
- Operacje na wierszach i kolumnach – przepisy, które pokazują, jak dodawać, usuwać i przenosić wiersze i kolumny oraz aktualizować ich właściwości.
- Operacje na arkuszach – przepisy, które pokazują, jak tworzyć, czyścić, kopiować i usuwać arkusze oraz kontrolować ich właściwości.