Method: spreadsheets.values.batchUpdateByDataFilter

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

string

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 (ValueInputOption),
  "data": [
    {
      object (DataFilterValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Alanlar
valueInputOption

enum (ValueInputOption)

Girdi verilerinin nasıl yorumlanması gerektiği.
data[]

object (DataFilterValueRange)

E-tabloya uygulanacak yeni değerler. Belirtilen DataFilter ile birden fazla aralık eşleşirse belirtilen değerler, bu aralıkların tümüne uygulanır.
includeValuesInResponse

boolean

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. BatchUpdateValuesResponse.responses öğesinin her bir içindeki updatedData alanı güncellenmiş değerleri içerir. Yazılacak aralık gerçekte yazılan aralıktan daha büyükse yanıt, istenen aralıktaki tüm değerleri (sondaki boş satırlar ve sütunlar hariç) içerir.
responseValueRenderOption

enum (ValueRenderOption)

Yanıttaki değerlerin nasıl oluşturulması gerektiğini belirler. Varsayılan oluşturma seçeneği: FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Yanıttaki tarihlerin, saatlerin ve sürelerin nasıl oluşturulması gerektiğini belirler. responseValueRenderOption, FORMATTED_VALUE ise bu değer yoksayılır. Varsayılan dateTime oluşturma seçeneği SERIAL_NUMBER şeklindedir.

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 (UpdateValuesByDataFilterResponse)
    }
  ]
}
Alanlar
spreadsheetId

string

Güncellemelerin uygulandığı e-tablo.
totalUpdatedRows

integer

Satırdaki en az bir hücrenin güncellendiği toplam satır sayısı.
totalUpdatedColumns

integer

Sütunda en az bir hücrenin güncellendiği toplam sütun sayısı.
totalUpdatedCells

integer

Güncellenen toplam hücre sayısı.
totalUpdatedSheets

integer

Sayfada en az bir hücrenin güncellendiği sayfaların toplam sayısı.
responses[]

object (UpdateValuesByDataFilterResponse)

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 (DataFilter)
  },
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Alanlar
dataFilter

object (DataFilter)

E-tablodaki değerlerin konumunu açıklayan veri filtresi.
majorDimension

enum (Dimension)

Değerlerin ana boyutu.
values[]

array (ListValue format)

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 (DataFilter)
  },
  "updatedData": {
    object (ValueRange)
  }
}
Alanlar
updatedRange

string

Güncellemelerin uygulandığı aralık (A1 gösteriminde).
updatedRows

integer

Satırda en az bir hücrenin güncellendiği satır sayısı.
updatedColumns

integer

Sütunda en az bir hücrenin güncellendiği sütun sayısı.
updatedCells

integer

Güncellenen hücre sayısı.
dataFilter

object (DataFilter)

Güncellenen aralığı seçen veri filtresi.
updatedData

object (ValueRange)

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 includeValuesInResponse alanı true ise dahil edilir.