Omówienie interfejsu Google Sheets API

Interfejs API Arkuszy Google to interfejs typu REST, który umożliwia odczytywanie i modyfikowanie dane arkusza kalkulacyjnego. Oto najczęstsze zastosowania tego interfejsu API: zadania:

  • Tworzenie arkuszy kalkulacyjnych
  • Odczytywanie i zapisywanie wartości komórek arkusza kalkulacyjnego
  • Zaktualizuj formatowanie arkusza kalkulacyjnego
  • Zarządzanie połączonymi arkuszami

Poniżej znajduje się lista popularnych terminów używanych w tym interfejsie API:

Arkusz kalkulacyjny

Główny obiekt Arkuszy Google, który może zawierać wiele arkuszy, z których każdy z uporządkowanymi informacjami zawartymi w komórkach. Spreadsheet zasób reprezentuje każdy arkusza kalkulacyjnego i ma unikalny identyfikator spreadsheetId, zawierających litery, cyfry, łączniki i podkreślenia. Dodatkowe informacje na temat identyfikator arkusza kalkulacyjnego w adresie URL Arkuszy Google:

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

Arkusz

Strona lub karta w arkuszu kalkulacyjnym. Sheet zasób reprezentuje każdy arkusza i ma niepowtarzalny tytuł i numer sheetId. Ty może znaleźć identyfikator arkusza w adresie URL Arkuszy Google:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

Komórka

Pojedyncze pole tekstu lub danych w arkuszu. Komórki są ułożone w wierszach i kolumn, a także grupować je jako zakres komórek. CellData zasób reprezentuje każdy , ale nie ma ona wartości niepowtarzalnej identyfikatora. Zamiast tego wiersze i kolumny które wskazują komórki.

Zapis A1
Składnia używana do definiowania komórki lub zakresu komórek z ciągiem znaków, zawiera nazwę arkusza oraz początkową i końcową współrzędną komórki za pomocą funkcji litery kolumn i numery wierszy. Ta metoda jest najpopularniejsza i najbardziej przydatna w odniesieniu do bezwzględnego zakresu komórek.

Wyświetl przykłady

  • Sheet1!A1:B2 odnosi się do wszystkich komórek w pierwszych 2 wierszach i kolumnach arkusza1.
  • Sheet1!A:A odnosi się do wszystkich komórek w pierwszej kolumnie arkusza1.
  • Sheet1!1:2 odnosi się do wszystkich komórek w pierwszych 2 wierszach arkusza 1.
  • Sheet1!A5:A odnosi się do wszystkich komórek w pierwszej kolumnie arkusza 1, od wiersza 5 wzwyż.
  • A1:B2 odnosi się do wszystkich komórek w pierwszych 2 wierszach i kolumnach pierwszego widocznego arkusza.
  • Sheet1 odnosi się do wszystkich komórek w arkuszu 1.
  • 'Jon's_Data'!A1:D5 odnosi się do wszystkich komórek w pierwszych pięciu wierszach i czterech kolumnach arkusza o nazwie „Dane_Jana”.
  • 'My Custom Sheet'!A:A odnosi się do wszystkich komórek w pierwszej kolumnie arkusza o nazwie „Mój arkusz niestandardowy”.
  • 'My Custom Sheet' odnosi się do wszystkich komórek w „Moim arkuszu niestandardowym”.

Pojedyncze cudzysłowy są wymagane w przypadku nazw arkuszy zawierających spacje, znaki specjalne lub kombinacje alfanumeryczne.

Wskazówka: jeśli to możliwe, używaj różnych nazw obiektów w arkuszach kalkulacyjnych. Na przykład dyrektywa A1 odnosi się do komórki A1 w pierwszym widocznym arkuszu, a A1 – do wszystkich komórek w arkuszu o nazwie „A1”. Podobnie Sheet1 odnosi się do wszystkich komórek w arkuszu 1. Jeśli jednak istnieje zakres nazwany „Arkusz1”, zakres Arkusz1 odnosi się do nazwanego zakresu, a Sheet1 do arkusza.
Zapis R1C1
Składnia używana do definiowania komórki lub zakresu komórek z ciągiem znaków, zawiera nazwę arkusza oraz początkową i końcową współrzędną komórki za pomocą funkcji numerów wierszy i kolumn. Ta metoda jest rzadsza niż notacja A1, ale może być przydatne podczas odwoływania się do zakresu komórek względem danej pozycji komórki.

Wyświetl przykłady

  • Sheet1!R1C1:R2C2 odnosi się do 2 pierwszych komórek w 2 górnych wierszach arkusza 1.
  • R1C1:R2C2 odnosi się do 2 pierwszych komórek w 2 górnych wierszach pierwszego widocznego arkusza.
  • Sheet1!R[3]C[1] odnosi się do komórki znajdującej się w 3 wierszach poniżej i 1 kolumnie po prawej stronie bieżącej komórki.
Zakres nazwany
Zdefiniowana komórka lub zakres komórek z własną nazwą dla uproszczenia odwołań w aplikacji. FilterView zasób reprezentuje zakres nazwany.
Zakres chroniony
Zdefiniowana komórka lub zakres komórek, których nie można modyfikować. O ProtectedRange zasób reprezentuje zakres chroniony.

  • Aby dowiedzieć się więcej o programowaniu z użyciem interfejsów Google Workspace API, w tym o obsłudze Uwierzytelnianie i autoryzacja znajdziesz w artykule Programowanie Google Workspace.

  • Aby dowiedzieć się, jak skonfigurować i uruchomić aplikację do obsługi Arkuszy, przeczytaj Krótkie wprowadzenia