Method: spreadsheets.values.batchGet

Zwraca co najmniej 1 zakres wartości z arkusza kalkulacyjnego. Rozmówca musi podać identyfikator arkusza kalkulacyjnego i co najmniej 1 zakres.

Żądanie HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego, z którego chcesz pobrać dane.

Parametry zapytania

Parametry
ranges[]

string

Notacja A1 lub R1C1 zakresu, z którego mają być pobierane wartości.
majorDimension

enum (Dimension)

Główny wymiar, którego mają dotyczyć wyniki.

Jeśli na przykład dane w arkuszu kalkulacyjnym mają postać: A1=1,B1=2,A2=3,B2=4, to zapytanie ranges=["A1:B2"],majorDimension=ROWS zwraca wartość [[1,2],[3,4]], a zapytanie ranges=["A1:B2"],majorDimension=COLUMNS zwraca wartość [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

sposób wyświetlania wartości w wyniku. Domyślną opcją renderowania jest ValueRenderOption.FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

jak w wyniku powinny być reprezentowane daty, godziny i czas trwania; Jest on ignorowany, jeśli valueRenderOption ma wartość FORMATTED_VALUE. Domyślną opcją renderowania daty i czasu jest SERIAL_NUMBER.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź po pobraniu więcej niż 1 zakresu wartości w arkuszu kalkulacyjnym.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Pola
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego, z którego pobierane są dane.
valueRanges[]

object (ValueRange)

Żądane wartości. Kolejność zakresów wartości jest taka sama jak kolejność żądanych zakresów.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.