Sample

W tej sekcji przedstawiamy ćwiczenie z programowania, dzięki któremu zapoznasz się z interfejsem Google Arkusze 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 kilka sposobów 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.values jest lepszym wyborem niż kolekcja spreadsheets. Poprzedni interfejs jest łatwiejszy w użyciu do prostych operacji odczytu i zapisu.
  • W miarę możliwości używaj metod zbiorczych (spreadsheet.batchUpdate, spreadsheet.values.batchGetspreadsheet.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 wymienione w tej sekcji pokazują, jak wyrażać typowe działania w Arkuszach jako żądania interfejsu Sheets API v4.

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.
  • Nazwane i chronione zakresy – przepisy pokazujące, jak tworzyć, aktualizować i usuwać nazwane i chronione zakresy 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.