Method: spreadsheets.batchUpdate

E-tabloya bir veya daha fazla güncelleme uygular.

Her request, uygulanmadan önce doğrulanır. Geçersiz bir istek varsa isteğin tamamı başarısız olur ve hiçbir işlem uygulanmaz.

Bazı isteklerde, nasıl uygulandıkları hakkında bilgi veren replies bulunur. Yanıtlar, isteklere paralel olur. Örneğin, 4 güncelleme uyguladıysanız ve 3. güncellemede bir yanıt varsa yanıtta 2 boş yanıt, asıl yanıt ve başka bir boş yanıt bulunur.

E-tabloların ortak çalışma özelliği nedeniyle, bu işlem tamamlandıktan sonra e-tablonun tam olarak değişikliklerinizi yansıtacağı garanti edilmez. Ancak istekteki güncellemelerin birlikte atomik olarak uygulanacağı garanti edilir. Ortak çalışan değişikliklerine bağlı olarak yaptığınız değişikliklerde değişiklik yapılabilir. Ortak çalışan yoksa e-tabloda değişiklikleriniz yansıtılır.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
spreadsheetId

string

Güncellemelerin uygulanacağı e-tablo.

İstek içeriği

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

JSON gösterimi 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
Alanlar
requests[]

object (Request)

E-tabloya uygulanacak güncellemelerin listesi. İstekler, belirtildikleri sırayla uygulanır. Geçersiz olan istekler uygulanmaz.
includeSpreadsheetInResponse

boolean

Güncelleme yanıtının e-tablo kaynağını içermesi gerekip gerekmediğini belirler.
responseRanges[]

string

Yanıt e-tablosuna dahil edilen aralıkları sınırlar. Yalnızca includeSpreadsheetInResponse "true" ise anlamlı olur.
responseIncludeGridData

boolean

Izgara verileri döndürülecekse doğru değerini döndürür. Yalnızca includeSpreadsheetInResponse "true" ise anlamlı olur. İstekte bir alan maskesi ayarlandıysa bu parametre yoksayılır.

Yanıt gövdesi

E-tabloyu toplu olarak güncellemeyle ilgili yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
Alanlar
spreadsheetId

string

Güncellemelerin uygulandığı e-tablo.
replies[]

object (Response)

Güncellemelerin yanıtı. Bu, güncellemelerle 1:1 eşleşir ancak bazı isteklerin yanıtları boş olabilir.
updatedSpreadsheet

object (Spreadsheet)

Güncellemeler uygulandıktan sonraki e-tablo. Bu yalnızca BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response true ise ayarlanır.

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.