Interfejs API Arkuszy Google to interfejs typu REST, który umożliwia odczytywanie i modyfikowanie danych arkusza kalkulacyjnego. Typowe zastosowania tego interfejsu API to:
- 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 interfejsie Arkuszy 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. Zasób arkusza kalkulacyjnego reprezentuje każdy arkusz kalkulacyjny i ma unikalną wartość
spreadsheetId
zawierającą litery, cyfry, łączniki i podkreślenia. Identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL Arkuszy Google:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- Arkusz
Strona lub karta w arkuszu kalkulacyjnym. Zasób arkusza reprezentuje każdy arkusz i ma unikalny tytuł oraz wartość liczbową
sheetId
. Identyfikator arkusza znajdziesz w adresie URL arkusza 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 kolumnach oraz można je grupować jako zakres komórek. Zasób CellData reprezentuje każdą komórkę, ale nie ma unikalnej wartości identyfikatora. Zamiast tego identyfikatory wierszy i kolumn wskazują komórki.
- Zapis A1
Składnia używana do definiowania komórki lub zakresu komórek z ciągiem tekstowym zawierającym nazwę arkusza oraz współrzędne początkowej i końcowej komórki przy użyciu liter i numerów wierszy. Ta metoda jest najpopularniejsza i przydatna przy odwoływaniu się do bezwzględnego zakresu komórek.
Wyświetl przykłady
Sheet1!A1:B2
odnosi się do 2 pierwszych komórek w 2 górnych wierszach arkusza 1.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 2 pierwszych komórek w 2 górnych wierszach pierwszego widocznego arkusza.Sheet1
odnosi się do wszystkich komórek w arkuszu 1.'My Custom Sheet'!A:A
odnosi się do wszystkich komórek w pierwszej kolumnie arkusza o nazwie „Mój arkusz niestandardowy”. Pojedyncze cudzysłowy są wymagane w przypadku nazw arkuszy zawierających spacje, znaki specjalne lub kombinacje alfanumeryczne.'My Custom Sheet'
odnosi się do wszystkich komórek w „Moim arkuszu niestandardowym”.
Wskazówka: jeśli to możliwe, używaj różnych nazw obiektów w arkuszach kalkulacyjnych. Na przykład komórka A1 odnosi się do komórki A1 w pierwszym widocznym arkuszu, a „A1” do wszystkich komórek w arkuszu o nazwie A1. Analogicznie atrybut Arkusz1 odnosi się do wszystkich komórek w arkuszu 1. Jeśli jednak jest zakres nazwany „Arkusz1”, zakres Arkusz1 odnosi się do nazwanego zakresu, a „Arkusz1” do arkusza.
- Zapis R1C1
Składnia używana do definiowania komórki lub zakresu komórek z ciągiem tekstowym zawierającym nazwę arkusza oraz współrzędne początkowej i końcowej komórki przy użyciu numerów wierszy i kolumn. Ta metoda jest mniej popularna niż zapis A1, ale może być przydatna podczas odwoływania się do zakresu komórek względem pozycji danej 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 o niestandardowej nazwie w celu uproszczenia odwołań w aplikacji. ZasóbFilterView reprezentuje zakres nazwany.
- Zakres chroniony
Zdefiniowana komórka lub zakres komórek, których nie można modyfikować. Zasób ProtectedRange reprezentuje zakres chroniony.
Dalsze kroki
Więcej informacji o programowaniu z użyciem interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Programowanie w Google Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić prostą aplikację Arkusze API, przeczytaj krótkie wprowadzenia.