Method: spreadsheets.values.batchUpdate

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 ValueRanges belirtmesi gerekir.

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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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çerip içermeyeceğini belirler. Varsayılan olarak, yanıtlar güncellenmiş değerleri içermez. Her bir BatchUpdateValuesResponse.responses içindeki updatedData alanı güncellenmiş değerleri içerir. Yazılacak aralık gerçekte yazılan aralıktan büyükse yanıt, istenen aralıktaki tüm değerleri içerir (sondaki boş satırlar ve sütunlar hariç).
responseValueRenderOption

enum (ValueRenderOption)

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

enum (DateTimeRenderOption)

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

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 (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ütunda en az bir hücrenin güncellendiği sütunların toplam sayısı.
totalUpdatedCells

integer

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

integer

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

object (UpdateValuesResponse)

İstenen aralık başına, isteklerin göründüğü sırada 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ılavuzu'na bakın.