Method: spreadsheets.getByDataFilter

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

Bu yöntem, bir dataFilters parametresi belirterek e-tablo verilerinin hangi alt kümelerinin döndürüleceğinin seçilmesine olanak tanıması açısından spreadsheet.get yönteminden farklıdır. Birden çok DataFilters belirtilebilir. Bir veya daha fazla veri filtresi belirtilmesi, e-tablonun, filtrelerin herhangi biriyle eşleşen aralıklarla kesişen bölümlerini döndürür.

Varsayılan olarak, ızgaralar içindeki veriler döndürülmez. Izgara verilerini iki şekilde ekleyebilirsiniz:

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

  • includeGridData parametresini doğru değerine ayarlayın. Alan maskesi ayarlanırsa includeGridData parametresi yoksayılır

Büyük e-tablolarda 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

İstenecek e-tablo.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

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

object (DataFilter)

E-tablodan alınacak aralıkları seçmek için kullanılan DataFilters.
includeGridData

boolean

Izgara verilerinin 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ılavuzunu inceleyin.