Method: spreadsheets.getByDataFilter

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

Ta metoda różni się od arkuszy kalkulacyjnych.get, ponieważ umożliwia wybranie podzbiorów danych do przesłania, określając parametr dataFilters. Można podać kilka wartości DataFilters. Wskazanie co najmniej jednego filtra danych zwraca części arkusza kalkulacyjnego, które przecinają się z którymiś z filtrów.

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.

Żądanie HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getByDataFilter

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Arkusz kalkulacyjny, o który chcesz poprosić.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "includeGridData": boolean
}
Pola
dataFilters[]

object (DataFilter)

Pole DataFilters służące do wybierania zakresów 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ść 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.file
  • https://www.googleapis.com/auth/spreadsheets

Więcej informacji znajdziesz w przewodniku po autoryzacji.