- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
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 HTTPUstaw wartość parametru
includeGridData
na „true” (prawda). Jeśli jest ustawiona maska pola, parametrincludeGridData
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 |
Arkusz kalkulacyjny, o którego chcesz poprosić. |
Parametry zapytania
Parametry | |
---|---|
ranges[] |
Zakresy do pobrania z arkusza kalkulacyjnego. |
includeGridData |
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.