Method: spreadsheets.get

Zwraca arkusz kalkulacyjny o podanym identyfikatorze. Wywołujący musi podać identyfikator arkusza kalkulacyjnego.

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

  • Określ maskę pola, podając odpowiednie pola za pomocą parametru adresu URL fields w HTTP.

  • Ustaw parametr adresu URL includeGridData na wartość „PRAWDA”. Jeśli ustawisz maskę pola, parametr includeGridData zostanie zignorowany.

W przypadku dużych arkuszy kalkulacyjnych zalecamy pobieranie tylko tych pól, które są Ci potrzebne.

Aby pobrać tylko podzbiory danych arkusza kalkulacyjnego, użyj parametru adresu URL ranges. Zakresy są określane za pomocą notacji A1. Możesz zdefiniować pojedynczą komórkę (np. A1) lub wiele komórek (np. A1:D5). Możesz też pobrać komórki z innych arkuszy w tym samym arkuszu kalkulacyjnym (np. Sheet2!A1:C4) lub pobrać wiele zakresów naraz (np. ?ranges=A1:D5&ranges=Sheet2!A1:C4). Ograniczenie zakresu zwraca tylko te części arkusza kalkulacyjnego, które pokrywają się z żądanymi zakresami.

Żą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, którego dotyczy prośba.

Parametry zapytania

Parametry
ranges[]

string

Zakresy do pobrania z arkusza kalkulacyjnego.
includeGridData

boolean

Wartość „prawda”, jeśli mają zostać zwrócone dane siatki. Ten parametr jest ignorowany, jeśli w żądaniu ustawiono maskę pola.
excludeTablesInBandedRanges

boolean

Wartość Prawda, jeśli tabele mają być wykluczone w zakresach zgrupowanych. Fałsz, jeśli nie jest ustawiony.

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 dotyczącym autoryzacji.