Method: spreadsheets.getByDataFilter

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

Bu yöntem, bir dataFilters parametresi belirleyerek e-tablo verilerinin hangi alt kümelerinin döndürüleceğini seçmeye olanak tanıması nedeniyle e-tablolar.get yönteminden farklıdır. Birden çok DataFilters belirtilebilir. Bir veya daha fazla veri filtresi belirtildiğinde, e-tablonun filtrelerden herhangi biriyle eşleşen aralıkları kesişen bölümleri döndürülür.

Varsayılan olarak, ızgaralar içindeki veriler döndürülmez. Izgara verilerini 2 yöntemden birini kullanarak 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 gövdesi aşağıdaki yapıya sahip veriler içerir:

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

object (DataFilter)

E-tablodan hangi aralıkların alınacağını belirlemek için DataFilters kullanılır.
includeGridData

boolean

Tablo verileri döndürülmesi gerekiyorsa doğru değerini döndürür. İstekte bir alan maskesi ayarlanmışsa bu parametre yoksayılı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.