Method: spreadsheets.values.batchUpdateByDataFilter

Bir elektronik tablonun bir veya daha fazla aralığındaki değerleri ayarlar. Daha fazla bilgi için Meta verileri okuma, yazma ve arama başlıklı makaleyi inceleyin.

Arayan, elektronik tablo kimliğini, 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

string

Güncellenecek e-tablonun kimliği.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (DataFilterValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Alanlar
valueInputOption

enum (ValueInputOption)

Giriş 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çermeyeceğini belirler. Varsayılan olarak, yanıtlarda güncellenen değerler yer almaz. BatchUpdateValuesResponse.responses öğelerinin her birindeki updatedData alanı, güncellenen değerleri içerir. Yazılacak aralık, gerçekten yazılan aralıktan büyükse yanıtta, istenen aralıktaki tüm değerler (sondaki boş satırlar ve sütunlar hariç) yer alır.
responseValueRenderOption

enum (ValueRenderOption)

Yanıtın değerlerinin nasıl oluşturulacağını belirler. Varsayılan oluşturma seçeneği FORMATTED_VALUE'dır.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Yanıtın tarih, saat ve sürelerinin nasıl oluşturulacağını belirler. responseValueRenderOption, FORMATTED_VALUE ise bu değer yoksayılır. Varsayılan dateTime oluşturma seçeneği SERIAL_NUMBER'dır.

Yanıt metni

E-tablodaki bir değer aralığı güncellenirken 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 hücrelerden en az birinin güncellendiği toplam satır sayısı.
totalUpdatedColumns

integer

Sütundaki hücrelerden en az birinin güncellendiği toplam sütun sayısı.
totalUpdatedCells

integer

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

integer

E-tablodaki en az bir hücrenin güncellendiği toplam sayfa sayısı.
responses[]

object (UpdateValuesByDataFilterResponse)

Her aralık için 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 (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şarsa 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 değer aralığı, veri filtresiyle güncellenirken 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österimi).
updatedRows

integer

Satırdaki hücrelerden en az birinin güncellendiği satır sayısı.
updatedColumns

integer

Sütundaki hücrelerden en az birinin 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ştirilen aralıktaki hücrelerin değerleri. Bu yalnızca isteğin includeValuesInResponse alanı true ise eklenir.