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 identyfikatorspreadsheetId
, 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 numersheetId
. 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”. PodobnieSheet1
odnosi się do wszystkich komórek w arkuszu 1. Jeśli jednak istnieje zakres nazwany „Arkusz1”, zakres Arkusz1 odnosi się do nazwanego zakresu, aSheet1
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.
Powiązane artykuły
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