Method: spreadsheets.getByDataFilter

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

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

Varsayılan olarak, ızgaralardaki 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

İstenecek e-tablo.

İstek içeriği

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

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

object (DataFilter)

DataFilters, e-tablodan alınacak aralıkları seçmek için kullanılır.
includeGridData

boolean

Izgara verilerinin döndürülmesi gerekiyorsa doğru değerini alı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ılavuzu'na bakın.