Method: spreadsheets.get

Zwraca arkusz kalkulacyjny o podanym identyfikatorze. Rozmówca musi podać identyfikator arkusza kalkulacyjnego.

Domyślnie dane w siatkach nie są zwracane. Dane siatki możesz uwzględnić na 2 sposoby:

  • Określ maskę pola, podając listę wymaganych pól, korzystając z parametru URL fields w protokole HTTP.

  • Ustaw wartość parametru includeGridData na „true”. Jeśli ustawisz maskę pola, parametr includeGridData jest ignorowany.

Sprawdzoną metodą w przypadku dużych arkuszy kalkulacyjnych jest pobieranie tylko odpowiednich pól arkusza kalkulacyjnego.

Aby pobrać tylko podzbiory danych arkusza kalkulacyjnego, użyj parametru adresu URL ranges. Zakresy są określane przy użyciu 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 pobrać wiele zakresów jednocześnie (na przykład ?ranges=A1:D5&ranges=Sheet2!A1:C4). Ograniczenie zakresu spowoduje wyświetlenie tylko tych części arkusza kalkulacyjnego, 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óry chcesz poprosić.

Parametry zapytania

Parametry
ranges[]

string

Zakresy do pobrania z arkusza kalkulacyjnego.

includeGridData

boolean

Wartość to „prawda”, jeśli mają być zwracane 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.