Method: spreadsheets.values.batchGetByDataFilter

Belirtilen veri filtreleriyle eşleşen bir veya daha fazla değer aralığı döndürür. Arayanın e-tablo kimliğini ve bir veya daha fazla DataFilters belirtmesi gerekir. İstekteki veri filtrelerinden herhangi biriyle eşleşen aralıklar döndürülür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
spreadsheetId

string

Verilerin alınacağı e-tablonun kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "majorDimension": enum (Dimension),
  "valueRenderOption": enum (ValueRenderOption),
  "dateTimeRenderOption": enum (DateTimeRenderOption)
}
Alanlar
dataFilters[]

object (DataFilter)

Alınacak değer aralıklarını eşleştirmek için kullanılan veri filtreleri. Belirtilen veri filtrelerinden herhangi biriyle eşleşen aralıklar yanıta dahil edilir.
majorDimension

enum (Dimension)

Sonuçların kullanması gereken ana boyut.

Örneğin, e-tablo verileri A1=1,B1=2,A2=3,B2=4 ise bu aralığı seçip majorDimension=ROWS olarak ayarlayan bir istek [[1,2],[3,4]] değerini, majorDimension=COLUMNS değerini ayarlayan bir istek ise [[1,3],[2,4]] değerini döndürür.
valueRenderOption

enum (ValueRenderOption)

Değerlerin çıkışta nasıl gösterilmesi gerektiği. Varsayılan oluşturma seçeneği FORMATTED_VALUE'dir.
dateTimeRenderOption

enum (DateTimeRenderOption)

Tarihler, saatler ve sürelerin çıkışta nasıl temsil edilmesi gerektiği. valueRenderOption değeri FORMATTED_VALUE ise bu yoksayılır. Varsayılan dateTime oluşturma seçeneği: SERIAL_NUMBER.

Yanıt gövdesi

Bir e-tabloda DataFilters tarafından seçilen birden fazla değer aralığı alınırken alınan yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (MatchedValueRange)
    }
  ]
}
Alanlar
spreadsheetId

string

Verilerin alındığı e-tablonun kimliği.
valueRanges[]

object (MatchedValueRange)

İstenen değerler, kendileriyle eşleşen veri filtrelerinin listesiyle birlikte.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

MatchedValueRange

Bir veya daha fazla veri dosyalayıcı tarafından eşleştirilen değer aralığı.

JSON gösterimi 
{
  "valueRange": {
    object (ValueRange)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Alanlar
valueRange

object (ValueRange)

DataFilter ile eşleşen değerler.
dataFilters[]

object (DataFilter)

İstekteki değer aralığıyla eşleşen DataFilters.