Interfejs Google Sheets API to interfejs REST, który umożliwia odczytywanie i modyfikowanie danych w arkuszu kalkulacyjnym. Interfejs Arkuszy 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 typowych terminów używanych w interfejsie Sheets API:
- Arkusz kalkulacyjny
Główny obiekt w Arkuszach Google. Może zawierać wiele elementów
Sheets
, każdy z uporządkowanymi informacjami zawartymi w elemencieCells
. Zasóbspreadsheets
reprezentuje arkusz kalkulacyjny. Zawiera unikalną wartośćspreadsheetId
.- Identyfikator arkusza kalkulacyjnego
- Unikalny identyfikator arkusza kalkulacyjnego. To określony 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ć utworzony na podstawie adresu URL arkusza. Identyfikatory arkuszy kalkulacyjnych są niezmienne nawet po zmianie nazwy arkusza kalkulacyjnego.
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ść numerycznąsheetId
i arkusztitle
jako część obiektuSheetProperties
.- Identyfikator arkusza
- Unikalny identyfikator określonego arkusza w arkuszu kalkulacyjnym. Jest to określony ciąg znaków zawierający litery, cyfry i niektóre znaki specjalne, który odwołuje się do arkusza i może być utworzony na podstawie adresu URL arkusza kalkulacyjnego. Identyfikatory arkuszy są stałe, nawet jeśli zmieni się nazwa arkusza. Przykład: Identyfikator arkusza kalkulacyjnego.
- Komórka
Pojedyncze pole tekstu lub danych na arkuszu. Komórki są uporządkowane w wiersze i kolumny oraz mogą być grupowane jako zakres komórek. Zasób
Cells
reprezentuje każdą komórkę, ale nie ma unikalnego identyfikatora. Zamiast tego komórki są identyfikowane przez współrzędne wiersza i kolumny.- Zapis A1
- Składnia używana do definiowania komórki lub zakresu komórek za pomocą ciągu znaków zawierającego nazwę arkusza oraz współrzędne komórki początkowej i końcowej z wykorzystaniem liter kolumn i numerów wierszy. Ta metoda jest najczęstsza i najbardziej przydatna w przypadku odwołań 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 Arkuszu1.'Jon's_Data'!A1:D5
odnosi się do wszystkich komórek w 5 pierwszych wierszach i 4 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 arkuszu „Mój arkusz niestandardowy”.
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 w arkuszach kalkulacyjnych różnych nazw obiektów. Na przykład A1 (bez cudzysłowów) odnosi się do komórki A1 na pierwszym widocznym arkuszu.
'A1'
odnosi się do arkusza o nazwie A1. Podobnie Sheet1 odnosi się do arkusza o nazwie Sheet1. Jeśli jednak istnieje zakres nazwany „Arkusz1”, to Arkusz1 odnosi się do zakresu nazwanego, a'Sheet1'
do arkusza.- Zapis R1C1
- Składnia używana do definiowania komórki lub zakresu komórek za pomocą ciągu zawierającego 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 w odniesieniu do pozycji danej komórki.
Wyświetl przykłady
Sheet1!R1C1:R2C2
odnosi się do dwóch pierwszych komórek w dwóch górnych wierszach arkusza 1.R1C1:R2C2
odnosi się do dwóch pierwszych komórek w 2 górnych wierszach pierwszego widocznego arkusza.Sheet1!R[3]C[1]
odnosi się do komórki znajdującej się 3 wiersze niżej i jedną kolumnę w prawo od bieżącej komórki.
- Zakres nazwany
- Zdefiniowana komórka lub zakres komórek o niestandardowej nazwie w celu uproszczenia odwołań w aplikacji. Zasób
FilterView
reprezentuje zakres nazwany. - Zakres chroniony
- Zdefiniowana komórka lub zakres komórek, których nie można modyfikować. Zasób
ProtectedRange
reprezentuje zakres chroniony.
Powiązane artykuły
Więcej informacji o tworzeniu aplikacji z interfejsami Google Workspace API, w tym o uwierzytelnianiu i autoryzacji, znajdziesz w artykule Tworzenie aplikacji w Google Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić aplikację do obsługi Arkuszy, zapoznaj się z krótkim wprowadzeniem do JavaScriptu.