Sample

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

Często istnieje więcej niż jeden sposób wykonania danego zadania za pomocą interfejsu API. Zastanawiając się, jak podejść do zadania, pamiętaj o tych kwestiach:

  • Jeśli chcesz odczytywać lub zapisywać wartości komórek, lepszym wyborem będzie kolekcja spreadsheets.values niż kolekcja spreadsheets. Interfejs pierwszego z nich jest łatwiejszy w użyciu w przypadku prostych operacji odczytu i zapisu.

  • W miarę możliwości używaj metod zbiorczych (spreadsheet.batchUpdate, spreadsheet.values.batchGet i spreadsheet.values.batchUpdate), aby łączyć wiele żądań w jedno wywołanie metody. Korzystanie z tych metod wsadowych zwiększa wydajność, ponieważ:

    • zmniejszenie obciążenia HTTP klienta;
    • Zmniejsz liczbę wykonywanych zapytań.
    • Zmniejsz liczbę wersji dokumentu.
    • Zapewnij niepodzielność wszystkich zmian w partii.

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 niezależne od języka. Aby dowiedzieć się, jak implementować protokoły żądań interfejsu Sheets API w konkretnym języku za pomocą bibliotek klienta interfejsu API Google, zapoznaj się z przewodnikami Odczytywanie i zapisywanie wartości komórek i 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 pisanie – przepisy, które pokazują, jak zapisywać wartości w arkuszu.
  • Podstawowe formatowanie – przepisy pokazujące, jak zmienić wygląd arkuszy i komórek.
  • Wykresy – przepisy pokazujące, jak tworzyć i modyfikować wykresy w arkuszu.
  • Formatowanie warunkowe – przepisy pokazujące, 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 pokazujące, jak dodawać, usuwać i przenosić wiersze oraz kolumny, a także 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.