Method: spreadsheets.getByDataFilter

Belirtilen kimliğe sahip e-tabloyu döndürür. Arayan, e-tablo kimliğini belirtmelidir. Daha fazla bilgi için Meta verileri okuma, yazma ve arama başlıklı makaleyi inceleyin.

Bu yöntem, dataFilters parametresi belirtilerek döndürülecek e-tablo verilerinin alt kümelerinin seçilmesine olanak tanıdığı için 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ıklarla kesişen kısımlarını döndürür.

Varsayılan olarak, kılavuzlardaki veriler döndürülmez. Izgara verilerini iki ş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-tablolar için en iyi uygulama olarak yalnızca istediğiniz belirli 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

İstek yapılacak e-tablo.

İstek metni

İstek içeriği 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 DataFilters kullanılır.
includeGridData

boolean

Izgara verileri döndürülmelidirse doğru (true). İstek içinde alan maskesi ayarlandıysa bu parametre yoksayılır.
excludeTablesInBandedRanges

boolean

Tabloların bantlı aralıklara dahil edilmemesi gerekiyorsa doğru değerini alır. Ayarlanmamışsa yanlış değerini alır.

Yanıt metni

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ılavuzu'na bakın.