- HTTP isteği
- Yol parametreleri
- İstek metni
- 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ın e-tablo kimliğini ve bir veya daha fazla DataFilters
belirtmesi gerekir. İ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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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çların kullanması gereken ana boyut. Örneğin, e-tablo verileri |
valueRenderOption |
Değerlerin çıkışta nasıl gösterilmesi gerektiği. Varsayılan oluşturma seçeneği |
dateTimeRenderOption |
Tarihler, saatler ve sürelerin çıkışta nasıl temsil edilmesi gerektiği. |
Yanıt gövdesi
Bir e-tabloda DataFilters
tarafından seçilen birden fazla değer aralığı alınırken alınan 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, kendileriyle eşleşen veri filtrelerinin listesiyle birlikte. |
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.
MatchedValueRange
Bir veya daha fazla veri dosyalayıcı tarafından eşleştirilen değer aralığı.
JSON gösterimi |
---|
{ "valueRange": { object ( |
Alanlar | |
---|---|
valueRange |
|
dataFilters[] |
İstekteki değer aralığıyla eşleşen |