- 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ın e-tablo kimliği, valueInputOption
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
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "valueInputOption": enum ( |
Alanlar | |
---|---|
valueInputOption |
Girdi 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çermediğini belirler. Varsayılan olarak, yanıtlar güncellenen 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
Bir e-tablodaki 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 toplam sütun sayısı. |
totalUpdatedCells |
Güncellenen toplam hücre sayısı. |
totalUpdatedSheets |
Sayfada en az bir hücrenin güncellendiği sayfaların toplam sayısı. |
responses[] |
Her bir aralıkla ilgili yanıtlar 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ılavuzunu inceleyin.
DataFilterValueRange
Konumu DataFilter
ile belirtilen 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 azsa yalnızca belirtilen değerler yazılırsa eşleşen aralıklardaki mevcut değerler bundan etkilenmez. |
UpdateValuesByDataFilterResponse
Bir e-tablodaki veri filtresine göre bir 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ırda en az bir hücrenin güncellendiği satır sayısı. |
updatedColumns |
Sütunda 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 dataFilter tarafından eşleşen aralıktaki hücrelerin değerleri. Bu değer, yalnızca isteğin |