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 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ış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 göre değiştirilebilir. 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ç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 verileri döndürülecekse doğru değerini alı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ılavuzunu inceleyin.