Method: spreadsheets.getByDataFilter

Belirtilen kimliğe sahip e-tabloyu döndürür. Arayan, e-tablo kimliğini belirtmelidir.

Bu yöntem, dataFilters parametresi belirterek döndürülecek e-tablo veri alt kümelerinin seçilmesine olanak tanıması bakımından spreadsheets.get yönteminden farklıdır. Birden fazla DataFilters belirtilebilir. Bir veya daha fazla veri filtresi belirtmek, e-tablonun filtrelerden herhangi biriyle eşleşen aralıklarını kesiştiren bölümlerini döndürür.

Varsayılan olarak, ızgaralardaki veriler döndürülmez. Izgara verilerini 2 şekilde ekleyebilirsiniz:

  • HTTP'de fields URL parametresini kullanarak istediğiniz alanları listeleyen bir alan maskesi belirtin

  • includeGridData parametresini true olarak ayarlayın. Alan maskesi ayarlanırsa includeGridData parametresi yoksayılır

Büyük e-tablolarda en iyi uygulama olarak yalnızca istediğiniz e-tablo alanlarını alın.

HTTP isteği

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

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

Yol parametreleri

Parametreler
spreadsheetId

string

İstenecek e-tablo.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "includeGridData": boolean,
  "excludeTablesInBandedRanges": boolean
}
Alanlar
dataFilters[]

object (DataFilter)

E-tablodan hangi aralıkların alınacağını seçmek için kullanılan DataFilters.
includeGridData

boolean

Izgara verileri döndürülecekse doğru değerini döndürür. İstekte bir alan maskesi ayarlandıysa bu parametre yoksayılır.
excludeTablesInBandedRanges

boolean

Tablolar bantlı aralıklardan hariç tutulacaksa doğru değerini alır. Ayarlanmamışsa yanlıştır.

Yanıt gövdesi

Başarılıysa yanıt metni, Spreadsheet öğesinin bir örneğini içerir.

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ılavuzuna bakın.