Interfejs API Arkuszy Google to interfejs typu REST, który umożliwia odczytywanie i modyfikowanie danych w arkuszu kalkulacyjnym. Ten interfejs API jest używany najczęściej do tych celów:
- Tworzenie arkuszy kalkulacyjnych
- Odczytywanie i zapisywanie wartości komórek arkusza kalkulacyjnego
- Aktualizowanie formatowania arkusza kalkulacyjnego
- Zarządzanie połączonymi arkuszami
Poniżej znajduje się lista typowych terminów używanych w interfejsie API Arkuszy:
- Arkusz kalkulacyjny
Podstawowy obiekt w Arkuszach Google, który może zawierać wiele arkuszy, z których każdy ma uporządkowane informacje zawarte w komórkach. Zasób arkusza kalkulacyjnego reprezentuje każdy arkusz kalkulacyjny i ma unikalną wartość
spreadsheetId
, która zawiera litery, cyfry, łączniki i podkreślenia. Identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL arkusza 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 Arkuszy Google:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- Komórka
Pojedyncze pole tekstowe lub dane w arkuszu. Komórki są ułożone w wiersze i kolumny oraz można je grupować jako zakresy komórek. Zasób CellData reprezentuje każdą komórkę, ale nie ma unikalnej wartości identyfikatora. Zamiast tego współrzędne wierszy i kolumn identyfikują komórki.
- Zapis A1
Składnia używana do definiowania komórki lub zakresu komórek z ciągiem znaków zawierającym nazwę arkusza oraz współrzędne początkowej i końcowej komórki za pomocą liter kolumny i numerów wierszy. Ta metoda jest najpopularniejsza i przydatna podczas określania bezwzględnego zakresu komórek.
Wyświetl przykłady
Sheet1!A1:B2
odnosi się do dwóch pierwszych komórek w dwóch górnych wierszach 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 Arkusz1.Sheet1!A5:A
odnosi się do wszystkich komórek w pierwszej kolumnie arkusza 1 (od wiersza 5).A1:B2
odnosi się do dwóch pierwszych komórek w dwóch górnych wierszach pierwszego widocznego arkusza.Sheet1
odnosi się do wszystkich komórek w Arkuszu1.'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 kombinację alfanumeryczną.'My Custom Sheet'
odnosi się do wszystkich komórek w „Moim arkuszu niestandardowym”.
Wskazówka: tam, gdzie 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. Podobnie arkusz1 odnosi się do wszystkich komórek w Arkuszu1. Jeśli jednak istnieje nazwany zakres o nazwie „Arkusz1”, wtedy „Arkusz1” odnosi się do zakresu nazwanego, a „Arkusz1” do arkusza.
- Zapis R1C1
Składnia używana do definiowania komórki lub zakresu komórek z ciągiem znaków zawierającym nazwę arkusza oraz współrzędne początkowej i końcowej komórki za pomocą numerów wierszy i numerów kolumn. Ta metoda jest mniej popularna niż notacja 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 dwóch pierwszych komórek w dwóch górnych wierszach Arkusza1.R1C1:R2C2
odnosi się do dwóch pierwszych komórek w dwóch górnych wierszach pierwszego widocznego arkusza.Sheet1!R[3]C[1]
odnosi się do komórki znajdującej się 3 wiersze poniżej i 1 kolumny po prawej stronie bieżącej komórki.
- Zakres nazwany
Zdefiniowana komórka lub zakres komórek z niestandardową nazwą w celu uproszczenia odwołań w całej aplikacji. ZasóbFilterView reprezentuje zakres nazwany.
- Zakres chroniony
Zdefiniowana komórka lub zakres komórek, których nie można zmodyfikować. 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 na temat programowania w Google Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić prostą aplikację interfejsu API Arkuszy, przeczytaj krótkie wprowadzenie.