Sample

W tej sekcji znajdziesz ćwiczenie, które pomoże Ci zapoznać się z interfejsem Google Sheets API. Znajduje się tu też zestaw przykładów „przepisów”, które pokazują, jak przetłumaczyć zamierzone działanie w Arkuszach Google na żądanie do interfejsu API.

Często istnieje więcej niż 1 sposób na wykonanie danego zadania za pomocą interfejsu API. Podczas podejmowania decyzji o tym, jak podejść do zadania, pamiętaj o tych kwestiach:

  • Jeśli musisz odczytać lub zapisać wartości komórek, lepszym wyborem niż kolekcja spreadsheets jest kolekcja spreadsheets.values. Interfejs tej pierwszej jest łatwiejszy w użyciu w przypadku prostych operacji odczytu i zapisu.

  • Tam, gdzie to możliwe, używaj metod zbiorczych (spreadsheet.batchUpdate, spreadsheet.values.batchGet, i spreadsheet.values.batchUpdate) aby łączyć wiele żądań w jedno wywołanie metody. Używanie tych metod zbiorczych zwiększa wydajność, ponieważ:

    • zmniejszają obciążenie HTTP klienta,
    • zmniejszają liczbę wykonywanych zapytań,
    • zmniejszają liczbę wersji dokumentu,
    • zapewniają atomowość wszystkich zmian w partii.

Przepisy

Przykłady wymienione w tej sekcji pokazują, jak wyrazić typowe działania w Arkuszach jako żądania interfejsu Sheets API w wersji 4.

Przykłady te są przedstawione w postaci żądań HTTP, aby były niezależne od języka. Aby dowiedzieć się, jak wdrożyć protokoły żądań interfejsu Sheets API w konkretnym języku za pomocą bibliotek klienta Google API, zapoznaj się z przewodnikami Odczytywanie i zapisywanie wartości komórek oraz Aktualizowanie arkuszy kalkulacyjnych.

Przepisy w tej sekcji są podzielone na te kategorie:

  • Podstawowe odczytywanie – przepisy, które pokazują, jak odczytywać wartości z arkusza.
  • Podstawowe zapisywanie – przepisy, które pokazują, jak zapisywać wartości w arkuszu.
  • Podstawowe formatowanie – przepisy które pokazują, jak zmieniać wygląd arkuszy i komórek.
  • Wykresy – przepisy, które pokazują, jak tworzyć i modyfikować 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 manipulować danymi w arkuszu kalkulacyjnym.
  • Nazwane i chronione zakresy – przepisy, które pokazują, jak tworzyć, aktualizować i usuwać nazwane i chronione zakresy w arkuszu kalkulacyjnym.
  • Tabele przestawne – przepisy , które pokazują, 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, a także kontrolować ich właściwości.