Method: spreadsheets.batchUpdate

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

Her request uygulanmadan önce doğrulanır. Herhangi bir istek geçerli değilse isteğin tamamı başarısız olur ve hiçbir şey uygulanmaz.

Bazı isteklerde, nasıl uygulandığıyla ilgili bilgi veren replies bulunur. Yanıtlar, istekleri yansıtır. Örneğin, 4 güncelleme uyguladıysanız ve 3. güncellemeye yanıt verdiyse, sırasıyla 2 boş yanıt, asıl yanıt ve boş bir başka yanıt olacaktır.

E-tabloların ortak çalışmaya dayalı yapısı nedeniyle, bu işlem tamamlandıktan sonra e-tablonun değişikliklerinizi tam olarak yansıtacağı garanti edilmez, ancak istekteki güncellemelerin birlikte atomik olarak uygulanacağı garanti edilir. Yaptığınız değişiklikler, ortak çalışan değişikliklerine bağlı olarak değişebilir. Ortak çalışan yoksa e-tablo değişikliklerinizi yansıtmalıdı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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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ıraya göre uygulanır. Geçerli olmayan istekler uygulanmaz.
includeSpreadsheetInResponse

boolean

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

string

Yanıt e-tablosuna dahil edilen aralıkları sınırlar. Yalnızca includeSpreadsheetInResponse "true" (doğru) olduğunda anlamlıdır.
responseIncludeGridData

boolean

Izgara verilerinin döndürülmesi gerekiyorsa doğru değerini alır. Yalnızca includeSpreadsheetInResponse "true" (doğru) olduğunda anlamlıdır. İstekte bir alan maskesi ayarlanmışsa bu parametre yoksayılır.

Yanıt gövdesi

E-tablonun toplu güncelleme 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 işlem, güncellemelerle bire bir eşler ancak bazı isteklere verilen yanıtlar boş olabilir.
updatedSpreadsheet

object (Spreadsheet)

Güncellemeler uygulandıktan sonraki e-tablo. Bu ayar 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ılavuzu'na bakın.