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ıkları hakkında size bilgi vermesi için replies izni bulunuyor. Yanıtlar, istekleri yansıtır. Örneğin, 4 güncelleme uyguladıysanız ve üçüncüsünde yanıt aldıysanız, bu sırayla ilgili yanıtta 2 boş yanıt gösterilir: asıl yanıt ve başka bir boş yanıt.

E-tabloların ortak çalışmaya dayalı yapısı nedeniyle, bu tamamlandıktan sonra e-tablonun değişikliklerinizi tam olarak yansıtacağı garanti edilmez, ancak istekteki güncellemelerin birlikte temel düzeyde uygulanacağı garanti edilir. Değişiklikleriniz, ortak çalışan değişikliklerine bağlı olarak değiştirilebilir. 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

İstek gövdesi aşağıdaki yapıya sahip 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çerli olmayan isteklere hiçbir istek uygulanmaz.
includeSpreadsheetInResponse

boolean

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

string

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

boolean

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

Yanıt gövdesi

Bir e-tablonun toplu güncellenmesine ilişkin 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 özet, güncellemelerle bire bir eşleşir 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ılavuzunu inceleyin.