Method: spreadsheets.get

Zwraca arkusz kalkulacyjny o podanym identyfikatorze. Element wywołujący musi określić identyfikator arkusza kalkulacyjnego.

Domyślnie dane w siatkach nie są zwracane. Dane siatki możesz dołączyć na 2 sposoby:

  • Określ maskę pola z listą potrzebnych pól, używając parametru URL fields w HTTP

  • Ustaw wartość parametru includeGridData na „true” (prawda). Jeśli jest ustawiona maska pola, parametr includeGridData jest ignorowany

W przypadku dużych arkuszy kalkulacyjnych zgodnie ze sprawdzonymi metodami pobierz tylko wybrane pola.

Aby pobrać tylko podzbiory danych z arkusza kalkulacyjnego, użyj parametru adresu URL ranges. Zakresy są określane za pomocą notacji A1. Możesz zdefiniować jedną komórkę (na przykład A1) lub wiele komórek (na przykład A1:D5). Możesz też pobrać komórki z innych arkuszy w tym samym arkuszu kalkulacyjnym (na przykład Sheet2!A1:C4) lub jednocześnie pobrać wiele zakresów (na przykład ?ranges=A1:D5&ranges=Sheet2!A1:C4). Ograniczenie zakresu powoduje zwrócenie tylko tych części arkusza, które przecinają żądane zakresy.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Arkusz kalkulacyjny, o którego chcesz poprosić.

Parametry zapytania

Parametry
ranges[]

string

Zakresy do pobrania z arkusza kalkulacyjnego.

includeGridData

boolean

Prawda, jeśli powinny zostać zwrócone dane siatki. Ten parametr jest ignorowany, jeśli w żądaniu ustawiono maskę pola.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

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.