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 URL fields w HTTP.

  • Ustaw parametr adresu URL includeGridData na wartość „true”. Jeśli ustawiona jest maska pola, parametr includeGridData jest ignorowany.

W przypadku dużych arkuszy kalkulacyjnych warto pobierać tylko te pola, które są potrzebne.

Aby pobrać tylko podzbiory danych z arkusza kalkulacyjnego, użyj parametru adresu URL ranges. Zakresy są podawane w notacji A1. Możesz zdefiniować jedną 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. Jeśli nie jest ustawiona, ma wartość „Fałsz”.
commentsViewMode

enum (CommentsViewMode)

Tryb widoku komentarzy, który ma być zastosowany do arkusza kalkulacyjnego. Umożliwia to wyświetlanie arkusza kalkulacyjnego 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.