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 belirtinincludeGridData
parametresini true olarak ayarlayın. Alan maskesi ayarlanırsaincludeGridData
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 |
İ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 ( |
Alanlar | |
---|---|
dataFilters[] |
|
includeGridData |
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.