- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Deneyin.
E-tablonun bir veya daha fazla aralığındaki değerleri ayarlar. Arayanın e-tablo kimliğini, valueInputOption
özelliğini ve bir veya daha fazla DataFilterValueRanges
belirtmesi gerekir.
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
İsteğin 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çerip içermeyeceğini belirler. Varsayılan olarak, yanıtlar güncellenmiş değerleri içermez. Her bir |
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
Bir e-tabloda 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ütunda en az bir hücrenin güncellendiği sütunların toplam sayısı. |
totalUpdatedCells |
Güncellenen toplam hücre sayısı. |
totalUpdatedSheets |
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ılavuzu'na bakın.
DataFilterValueRange
Konumu DataFilter
ile 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 filtresiyle eşleşen aralıklardan herhangi birini aşıyorsa istek başarısız olur. Sağlanan değerler eşleşen aralıklardan küçükse yalnızca belirtilen değerler yazılır. Eşleşen aralıklardaki mevcut değerler etkilenmez. |
UpdateValuesByDataFilterResponse
Bir e-tablodaki veri filtresiyle 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ütunda en az bir hücrenin güncellendiği sütunların sayısı. |
updatedCells |
Güncellenen hücre sayısı. |
dataFilter |
Güncellenen aralığı seçen veri filtresi. |
updatedData |
Aralıktaki hücrelerin, tüm güncellemeler uygulandıktan sonra dataFilter tarafından eşleştirilen değerleri. Bu yalnızca isteğin |