- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Deneyin.
Bir e-tablonun bir veya daha fazla aralığındaki değerleri ayarlar. Arayan, e-tablo kimliğini, bir valueInputOption
ve bir veya daha fazla DataFilterValueRanges
belirtmelidir.
HTTP isteği
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
spreadsheetId |
Güncellenecek e-tablonun kimliği. |
İstek içeriği
İstek gövdesi aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "valueInputOption": enum ( |
Alanlar | |
---|---|
valueInputOption |
Giriş verilerinin nasıl yorumlanması gerektiği. |
data[] |
E-tabloya uygulanacak yeni değerler. Belirtilen |
includeValuesInResponse |
Güncelleme yanıtının, güncellenen hücrelerin değerlerini içermesi gerekip gerekmediğini belirler. Varsayılan olarak, yanıtlar güncellenmiş değerleri içermez. |
responseValueRenderOption |
Yanıttaki değerlerin nasıl oluşturulması gerektiğini belirler. Varsayılan oluşturma seçeneği: |
responseDateTimeRenderOption |
Yanıttaki tarihlerin, saatlerin ve sürelerin nasıl oluşturulması gerektiğini belirler. |
Yanıt gövdesi
E-tablodaki bir değer aralığını güncellerken verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Alanlar | |
---|---|
spreadsheetId |
Güncellemelerin uygulandığı e-tablo. |
totalUpdatedRows |
Satırdaki en az bir hücrenin güncellendiği toplam satır sayısı. |
totalUpdatedColumns |
Sütundaki en az bir hücrenin güncellendiği toplam sütun sayısı. |
totalUpdatedCells |
Güncellenen toplam hücre sayısı. |
totalUpdatedSheets |
Sayfadaki en az bir hücrenin güncellendiği sayfaların toplam sayısı. |
responses[] |
Her aralığın yanıtı güncellendi. |
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ılavuzuna bakın.
Veri FiltresiDeğer Aralığı
Konumu DataFilter
tarafından belirtilen bir değer aralığı.
JSON gösterimi |
---|
{ "dataFilter": { object ( |
Alanlar | |
---|---|
dataFilter |
E-tablodaki değerlerin konumunu açıklayan veri filtresi. |
majorDimension |
Değerlerin ana boyutu. |
values[] |
Yazılacak veriler. Sağlanan değerler, veri filtresi tarafından eşleştirilen aralıklardan herhangi birini aşarsa istek başarısız olur. Sağlanan değerler, eşleşen aralıklardan azsa yalnızca belirtilen değerler yazılırsa eşleşen aralıklardaki mevcut değerler bu durumdan etkilenmez. |
Veri Filtrelerine Göre GüncellemeDeğerleri
Bir e-tablodaki veri aralığına göre değer aralığını güncellerken verilen yanıt.
JSON gösterimi |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Alanlar | |
---|---|
updatedRange |
Güncellemelerin uygulandığı aralık (A1 gösteriminde). |
updatedRows |
Satırdaki en az bir hücrenin güncellendiği satır sayısı. |
updatedColumns |
Sütundaki en az bir hücrenin güncellendiği sütun sayısı. |
updatedCells |
Güncellenen hücre sayısı. |
dataFilter |
Güncellenen aralığı seçen veri filtresi. |
updatedData |
Tüm güncellemeler uygulandıktan sonra, veri filtresiyle eşleşen aralıktaki hücrelerin değerleri. Bu yalnızca, isteğin |