Omówienie interfejsu Google Sheets API

Google Sheets API to interfejs REST, który umożliwia odczytywanie i modyfikowanie danych w arkuszach kalkulacyjnych. Interfejs Sheets API umożliwia:

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

Oto lista najczęstszych terminów używanych w interfejsie Sheets API:

Arkusz kalkulacyjny

Główny obiekt w Arkuszach Google. Może zawierać wiele elementów Sheets, z których każdy zawiera informacje strukturalne w elemencie Cells. Zasób spreadsheets reprezentuje arkusz kalkulacyjny. Zawiera unikalną wartość spreadsheetId.

Identyfikator arkusza kalkulacyjnego
Unikalny identyfikator arkusza kalkulacyjnego. Jest to ciąg znaków zawierający litery, cyfry i niektóre znaki specjalne, który odwołuje się do arkusza kalkulacyjnego i może być wyodrębniony z jego adresu URL. Identyfikatory arkuszy kalkulacyjnych są stałe, nawet jeśli nazwa arkusza ulegnie zmianie.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
Arkusze

Strona lub karta w arkuszu kalkulacyjnym. Zasób Sheets reprezentuje arkusz. Zawiera unikalną wartość liczbową sheetId i arkusz title jako część obiektu SheetProperties.

Identyfikator arkusza
Unikalny identyfikator konkretnego arkusza w arkuszu kalkulacyjnym. Jest to konkretna liczba całkowita zawierająca cyfry, które odwołują się do arkusza, i można ją uzyskać z adresu URL arkusza kalkulacyjnego. Identyfikatory arkuszy są stałe, nawet jeśli nazwa arkusza się zmieni. Przykład znajdziesz w sekcji Identyfikator arkusza kalkulacyjnego.
Komórka

Pojedyncze pole tekstu lub danych w arkuszu. Komórki są ułożone w wierszach i kolumnach i można je grupować w zakresy komórek. Zasób Cells reprezentuje każdą komórkę, ale nie ma unikalnej wartości identyfikatora. Zamiast tego komórki są identyfikowane za pomocą współrzędnych wierszy i kolumn.

Notacja A1
Składnia używana do definiowania komórki lub zakresu komórek za pomocą ciągu znaków, który zawiera nazwę arkusza oraz współrzędne komórki początkowej i końcowej z literami kolumn i numerami wierszy. Ta metoda jest najpopularniejsza i najbardziej przydatna, gdy odwołujesz się do bezwzględnego zakresu komórek.
  • Sheet1!A1:B2 odnosi się do wszystkich komórek w pierwszych dwóch wierszach i kolumnach arkusza Arkusz1.
  • Sheet1!A:A odnosi się do wszystkich komórek w pierwszej kolumnie arkusza Arkusz1.
  • Sheet1!1:2 odnosi się do wszystkich komórek w pierwszych dwóch wierszach arkusza Arkusz1.
  • Sheet1!A5:A odnosi się do wszystkich komórek w pierwszej kolumnie arkusza 1, od wiersza 5.
  • A1:B2 odnosi się do wszystkich komórek w pierwszych dwóch wierszach i kolumnach pierwszego widocznego arkusza.
  • Sheet1 odnosi się do wszystkich komórek w Arkuszu1.
  • 'Jon's_Data'!A1:D5 odnosi się do wszystkich komórek w pierwszych 5 wierszach i 4 kolumnach arkusza o nazwie „Dane_Jona”.
  • '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 arkuszu „Mój arkusz niestandardowy”.

W przypadku nazw arkuszy zawierających spacje lub znaki specjalne wymagane są cudzysłowy pojedyncze.

Wskazówka: w miarę możliwości używaj w arkuszach kalkulacyjnych różnych nazw obiektów. Na przykład A1 (bez cudzysłowu) odnosi się do komórki A1 w pierwszym widocznym arkuszu. 'A1' odnosi się do arkusza o nazwie A1. Podobnie Arkusz1 odnosi się do arkusza o nazwie Arkusz1. Jeśli jednak istnieje nazwany zakres o nazwie „Arkusz1”, to Arkusz1 odnosi się do nazwanego zakresu, a 'Sheet1' odnosi się do arkusza.

Notacja R1C1
Składnia używana do definiowania komórki lub zakresu komórek za pomocą ciągu znaków, który zawiera nazwę arkusza oraz współrzędne komórki początkowej i końcowej z numerami wierszy i kolumn. Ta metoda jest mniej popularna niż notacja A1, ale może być przydatna, gdy odwołujesz się do zakresu komórek względem pozycji danej komórki.
  • Sheet1!R1C1:R2C2 odnosi się do pierwszych dwóch komórek w dwóch górnych wierszach arkusza Arkusz1.
  • R1C1:R2C2 odnosi się do pierwszych dwóch komórek w pierwszych dwóch wierszach pierwszego widocznego arkusza.
  • Sheet1!R[3]C[1] odnosi się do komórki, która znajduje się 3 wiersze poniżej i 1 kolumnę na prawo od bieżącej komórki.
Zakres nazwany
Zdefiniowana komórka lub zakres komórek z niestandardową nazwą, która ułatwia odwoływanie się do nich w aplikacji. Zasób A FilterView reprezentuje nazwany zakres.
Zakres chroniony
Zdefiniowana komórka lub zakres komórek, których nie można modyfikować. Zasób A ProtectedRange reprezentuje zakres chroniony.

  • Więcej informacji o tworzeniu aplikacji z wykorzystaniem interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Tworzenie aplikacji w Google Workspace.

  • Aby dowiedzieć się, jak skonfigurować i uruchomić aplikację interfejsu Google Sheets API, wypróbuj szybki start w JavaScript.