Method: spreadsheets.values.get

Zwraca zakres wartości z arkusza kalkulacyjnego. Element wywołujący musi określić identyfikator arkusza kalkulacyjnego i zakres.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego, z którego mają zostać pobrane dane.
range

string

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

Parametry zapytania

Parametry
majorDimension

enum (Dimension)

Główny wymiar, którego należy użyć w przypadku wyników.

Jeśli na przykład dane z arkusza kalkulacyjnego w Arkuszu1 to: A1=1,B1=2,A2=3,B2=4, żądanie range=Sheet1!A1:B2?majorDimension=ROWS zwraca wartość [[1,2],[3,4]], a range=Sheet1!A1:B2?majorDimension=COLUMNS zwraca wartość [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

Sposób przedstawiania wartości w danych wyjściowych. Domyślną opcją renderowania jest FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

Sposób przedstawiania dat, godzin i czasu trwania w danych wyjściowych. Ta wartość jest ignorowana, jeśli valueRenderOption ma wartość FORMATTED_VALUE. Domyślną opcją renderowania daty i godziny jest SERIAL_NUMBER.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ValueRange.

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 po autoryzacji.