Method: spreadsheets.get

Zwraca arkusz kalkulacyjny o podanym identyfikatorze. Wywołujący 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 z listą wybranych pól, używając parametru adresu URL fields w HTTP.

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

W przypadku dużych arkuszy kalkulacyjnych sprawdzoną metodą jest pobieranie tylko tych pól arkusza, które są 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 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ść „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 z zakresów pasmowych. Wartość „Fałsz”, jeśli nie jest ustawiona.
commentsViewMode

enum (CommentsViewMode)

Tryb wyświetlania komentarzy, który ma być zastosowany w arkuszu kalkulacyjnym. Dzięki temu możesz wyświetlać arkusz kalkulacyjny z pominiętymi lub uwzględnionymi komentarzami. Jeśli nie zostanie określony, użyta zostanie wartość COMMENTS_VIEW_MODE_OMITTED.

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.