Method: spreadsheets.values.batchUpdate

Bir elektronik tablonun bir veya daha fazla aralığındaki değerleri ayarlar. Arayan, e-tablo kimliğini, bir valueInputOption ve bir veya daha fazla ValueRanges belirtmelidir.

HTTP isteği

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate

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 metni aşağıdaki yapıyla birlikte verileri içerir:

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

enum (ValueInputOption)

Giriş verilerinin nasıl yorumlanması gerektiği.

data[]

object (ValueRange)

E-tabloya uygulanacak yeni değerler.

includeValuesInResponse

boolean

Güncelleme yanıtının, güncellenen hücrelerin değerlerini içermesi gerekip gerekmediğini belirler. Yanıtlar varsayılan olarak güncellenmiş değerleri içermez. BatchUpdateValuesResponse.responses öğelerinin her biri içindeki updatedData alanı güncellenen 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 (sonraki boş satırlar ve sütunlar hariç) içerir.

responseValueRenderOption

enum (ValueRenderOption)

Yanıttaki değerlerin nasıl oluşturulacağını belirler. Varsayılan oluşturma seçeneği FORMATTED_VALUE'tür.

responseDateTimeRenderOption

enum (DateTimeRenderOption)

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

Yanıt gövdesi

E-tabloda bir değer aralığı güncellendiğinde 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 (UpdateValuesResponse)
    }
  ]
}
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ütunundaki en az bir hücrenin 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 e-tablo sayısı.

responses[]

object (UpdateValuesResponse)

İstekte bulunulan her aralık için, isteklerin göründüğü sırayla bir UpdateValuesResponse.

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.