- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- MatchedValueRange
- Deneyin.
Belirtilen veri filtreleriyle eşleşen bir veya daha fazla değer aralığı döndürür. Arayan, e-tablo kimliğini ve bir veya daha fazla DataFilters
belirtmelidir. İstekteki veri filtrelerinden herhangi biriyle eşleşen aralıklar döndürülür.
HTTP isteği
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
spreadsheetId |
Verilerin alınacağı e-tablonun kimliği. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "dataFilters": [ { object ( |
Alanlar | |
---|---|
dataFilters[] |
Alınacak değer aralıklarını eşleştirmek için kullanılan veri filtreleri. Belirtilen veri filtrelerinden herhangi biriyle eşleşen aralıklar yanıta dahil edilir. |
majorDimension |
Sonuçlarda kullanılması gereken ana boyut. Örneğin, e-tablo verileri |
valueRenderOption |
Değerlerin çıkışta nasıl temsil edilmesi gerektiği. Varsayılan oluşturma seçeneği: |
dateTimeRenderOption |
Tarihlerin, saatlerin ve sürelerin çıkışta nasıl temsil edilmesi gerektiği. |
Yanıt gövdesi
DataFilters
tarafından seçilen bir e-tabloda birden fazla değer aralığı alınırken verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Alanlar | |
---|---|
spreadsheetId |
Verilerin alındığı e-tablonun kimliği. |
valueRanges[] |
İstenen değerler ve bunlarla eşleşen veri filtrelerinin listesi. |
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.
MatchedValueRange
Bir veya daha fazla veri dosyalayıcı tarafından eşleştirilen bir değer aralığı.
JSON gösterimi |
---|
{ "valueRange": { object ( |
Alanlar | |
---|---|
valueRange |
|
dataFilters[] |
İstekteki değer aralığıyla eşleşen |