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 veren replies bulunur. Yanıtlar istekleri yansıtacak. Örneğin, 4 güncelleme uyguladıysanız ve 3. yanıta yanıt verildiyse yanıtta 2 boş yanıt, gerçek yanıt ve bu sırada başka bir boş yanıt olur.

E-tabloların ortak çalışmaya dayalı olması nedeniyle, e-tablonun bu işlem tamamlandıktan sonra yaptığınız değişiklikleri tam olarak yansıtacağı garanti edilmez, ancak istekteki güncellemelerin atom olarak birlikte uygulanacağı garanti edilir. Yaptığınız değişiklikler, ortak çalışan tarafından yapılan değişikliklere bağlı olarak değiştirilebilir. Ortak çalışan yoksa değişikliklerinizi e-tabloda yansıtmanız gerekir.

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 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, belirtildiği 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-tablosunda yer alan aralıkları sınırlar. Yalnızca includeSpreadsheetInResponse değeri "true" (doğru) olduğunda anlamlıdır.
responseIncludeGridData

boolean

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

Yanıt gövdesi

Bir e-tabloyu toplu güncellemenin 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üncellemeleri 1:1 olarak eşler ancak bazı isteklere yanıt verilmeyebilir.
updatedSpreadsheet

object (Spreadsheet)

E-tablo, güncellemeler uygulandıktan sonra. 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.