Method: spreadsheets.values.batchGetByDataFilter

Restituisce uno o più intervalli di valori che corrispondono ai filtri dei dati specificati. Per saperne di più, consulta Leggere, scrivere ed eseguire ricerche nei metadati.

Il chiamante deve specificare l'ID foglio di lavoro e uno o più DataFilters. Verranno restituiti gli intervalli che corrispondono a uno qualsiasi dei filtri dei dati nella richiesta.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
spreadsheetId

string

L'ID del foglio di lavoro da cui recuperare i dati.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "majorDimension": enum (Dimension),
  "valueRenderOption": enum (ValueRenderOption),
  "dateTimeRenderOption": enum (DateTimeRenderOption)
}
Campi
dataFilters[]

object (DataFilter)

I filtri dei dati utilizzati per trovare le corrispondenze con gli intervalli di valori da recuperare. Gli intervalli che corrispondono a uno qualsiasi dei filtri dei dati specificati sono inclusi nella risposta.
majorDimension

enum (Dimension)

La dimensione principale che i risultati devono utilizzare.

Ad esempio, se i dati del foglio di lavoro sono: A1=1,B1=2,A2=3,B2=4, una richiesta che seleziona questo intervallo e imposta majorDimension=ROWS restituisce [[1,2],[3,4]], mentre una richiesta che imposta majorDimension=COLUMNS restituisce [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

Come devono essere rappresentati i valori nell'output. L'opzione di rendering predefinita è FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

Come devono essere rappresentati date, orari e durate nell'output. Questo valore viene ignorato se valueRenderOption è FORMATTED_VALUE. L'opzione di rendering predefinita per dateTime è SERIAL_NUMBER.

Corpo della risposta

La risposta quando vengono recuperati più intervalli di valori in un foglio di lavoro selezionato da DataFilters.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (MatchedValueRange)
    }
  ]
}
Campi
spreadsheetId

string

L'ID del foglio di lavoro da cui sono stati recuperati i dati.
valueRanges[]

object (MatchedValueRange)

I valori richiesti con l'elenco dei filtri dei dati che corrispondono.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

MatchedValueRange

Un intervallo di valori corrispondente a uno o più filtri dei dati.

Rappresentazione JSON 
{
  "valueRange": {
    object (ValueRange)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Campi
valueRange

object (ValueRange)

I valori corrispondenti a DataFilter.
dataFilters[]

object (DataFilter)

Il valore DataFilters della richiesta che corrisponde all'intervallo di valori.