Czytanie podstawowe

Interfejs API Arkuszy Google umożliwia odczytywanie wartości z komórek, zakresów, zbiorów zakresów, i całych arkuszy. Przykłady na tej stronie ilustrują niektóre powszechnie stosowane tematy za pomocą metody spreadsheets.values . Wartości komórek możesz też odczytać za pomocą funkcji spreadsheets.get, ale zwykle spreadsheets.values.get lub spreadsheets.values.batchGet jest łatwiejsze.

Przykłady te są przedstawione w formie żądań HTTP, które stanowią język. i nie mam zdania. Aby dowiedzieć się, jak zaimplementować czyta się w różnych językach za pomocą Google Biblioteki klienta API znajdziesz w sekcji Odczyt i zapisz komórkę .

W tych przykładach symbol zastępczy SPREADSHEET_ID wskazuje, gdzie podasz identyfikator arkusza kalkulacyjnego, które można znaleźć pod adresem URL arkusza kalkulacyjnego. Zakresy, z których odczytywane są, to określono za pomocą notacji A1 w żądaniu Adres URL. Przykładowy zakres to Arkusz1!A1:D5.

Dane źródłowe

W tych przykładach załóżmy, że odczytywany arkusz kalkulacyjny ma następujące źródło danych w pierwszym arkuszu („Arkusz1”). Ciągi w pierwszym wierszu to etykiety dla: poszczególnych kolumn. Aby zobaczyć przykłady odczytywania innych arkuszy w przeczytaj opis A1.

A B C D
1 Element Koszt W magazynie Data wysyłki
2 Diabelski młyn 20,50 PLN 4 01.03.2016 r.
3 Drzwi 15 2 15.03.2016 r.
4 Silnik 100 zł 1 20.03.2016 r.
5 Sumy 135,50 PLN 7 20.03.2016 r.

Odczytaj pojedynczy zakres

Poniżej spreadsheets.values.get przykładowy kod pokazuje, jak odczytywać wartości z zakresu Sheet1!A1:D5 i zwraca ich w odpowiedzi. Puste końcowe wiersze i kolumny są pomijane.

Tutaj jest widoczny protokół żądania.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5

Odpowiedź składa się z ValueRange opisujący wartości zakresu. Pole majorDimension wskazuje, że tablice są listami wartości uporządkowanych według wierszy.

{
  "range": "Sheet1!A1:D5",
  "majorDimension": "ROWS",
  "values": [
    ["Item", "Cost", "Stocked", "Ship Date"],
    ["Wheel", "$20.50", "4", "3/1/2016"],
    ["Door", "$15", "2", "3/15/2016"],
    ["Engine", "$100", "1", "30/20/2016"],
    ["Totals", "$135.5", "7", "3/20/2016"]
  ],
}

Odczytaj pojedynczy zakres pogrupowany według kolumny

Poniżej spreadsheets.values.get przykładowy kod pokazuje, jak odczytywać wartości z zakresu Sheet1!A1:D3 i zwraca je w odpowiedzi, ale pogrupowane według kolumny. Puste końcowe wiersze i kolumny są pominięto.

Tutaj jest widoczny protokół żądania.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS

Odpowiedź składa się z ValueRange opisujący wartości zakresu. Pole majorDimension wskazuje, że tablice są listami wartości uporządkowanych według kolumn.

{
  "range": "Sheet1!A1:D3",
  "majorDimension": "COLUMNS",
  "values": [
    ["Item", "Wheel", "Door"],
    ["Cost", "$20.50", "$15"],
    ["Stocked", "4", "2"],
    ["Ship Date", "3/1/2016", "3/15/2016"]
  ],
}

Odczytywanie pojedynczego zakresu z opcjami renderowania

Poniżej spreadsheets.values.get przykładowy kod pokazuje, jak odczytywać wartości z zakresu Sheet1!A1:D5 i zwraca ich w odpowiedzi, ale używa opcji renderowania, by zarządzać sposobem . Ustawienie ValueRenderOption funkcji FORMULA wskazuje, że zamiast funkcji obliczoną wartość oraz DateTimeRenderOption ustawienie SERIAL_NUMBER wskazuje, że daty mają być zwracane w postaci liczb. Dostępne są też inne ustawienia. Puste końcowe wiersze i kolumny są pominięto.

Tutaj jest widoczny protokół żądania.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?
            valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER

Odpowiedź składa się z ValueRange opisujący wartości zakresu. Pole majorDimension wskazuje, że tablice są listami wartości uporządkowanych według wierszy.

{
  "range": "Sheet1!A1:D5",
  "majorDimension": "ROWS",
  "values": [
    ["Item", "Cost", "Stocked", "Ship Date"],
    ["Wheel", "$20.50", "4", "42430"],
    ["Door", "$15", "2", "42444"],
    ["Engine", "$100", "1", "42449"],
    ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
  ],
}

Odczytuj wiele zakresów

Poniżej spreadsheets.values.batchGet przykładowy kod pokazuje, jak odczytywać wartości z zakresów Sheet1!B:B i Sheet1!D:D oraz zwraca je w odpowiedzi. Ustawienie ValueRenderOption z UNFORMATTED_VALUE oznacza, że wartości są obliczane, ale nie sformatowane w odpowiedzi. Puste końcowe wiersze i kolumny są pomijane.

Tutaj jest widoczny protokół żądania.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
            ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS

Odpowiedź na wywołanie metody składa się z obiektu o identyfikatorze arkusza kalkulacyjnego i tablica ValueRange obiekty odpowiadające każdemu żądanemu zakresowi, wymienione w kolejności, w jakiej poproszono o dostęp. Pole majorDimension wskazuje, że tablice są listami wartości uporządkowanych według kolumn. Na przykład:

{
  "spreadsheetId": SPREADSHEET_ID,
  "valueRanges": [
    {
      "range": "Sheet1!B1:B1000",
      "majorDimension": "COLUMNS",
      "values": [
        ["Cost",20.5,15,100,135.5]
      ]
    },
    {
      "range": "Sheet1!D1:D1000",
      "majorDimension": "COLUMNS",
      "values": [
        ["Ship Date",42430,42444,42449,42449]
      ]s
    }
  ]
}

Odczytuj dane z wielu zakresów w wielu arkuszach

Poniżej spreadsheets.values.batchGet przykładowy kod pokazuje, jak odczytywać wartości z zakresów w arkuszach Sheet1!A1:D5, Products!D1:D100 i Sales!E4:F6, a następnie zwraca je w odpowiedzi. Ustawienie ValueRenderOption z UNFORMATTED_VALUE oznacza, że wartości są obliczane, ale nie sformatowane w odpowiedzi. Puste końcowe wiersze i kolumny są pomijane.

Tutaj jest widoczny protokół żądania.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
            ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS

Odpowiedź na wywołanie metody składa się z obiektu o identyfikatorze arkusza kalkulacyjnego i tablica ValueRange obiekty odpowiadające każdemu żądanemu zakresowi, wymienione w kolejności, w jakiej poproszono o dostęp. Pole majorDimension wskazuje, że tablice są listami wartości uporządkowanych według kolumn. Na przykład:

{
  "spreadsheetId": SPREADSHEET_ID,
  "valueRanges": [
    {
      "range": "Sheet1!A1:D5",
      "majorDimension": "COLUMNS",
      "values": [
        [...],
        [...]
      ]
    },
    {
      "range": "Products!D1:D100",
      "majorDimension": "COLUMNS",
      "values": [
        [...]
      ]
    },
    {
      "range": "Sales!E4:F6",
      "majorDimension": "COLUMNS",
      "values": [
        [...],
        [...]
      ]
    }
  ]
}