Method: spreadsheets.batchUpdate

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

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

Bazı isteklerde, nasıl uygulandıkları hakkında bilgi veren replies simgesi bulunur. Yanıtlar, isteklerle aynı olacak. Örneğin, 4 güncelleme uyguladıysanız ve 3. güncellemeye yanıt verildiyse yanıtta sırasıyla 2 boş yanıt, asıl yanıt ve başka bir boş yanıt yer alır.

E-tabloların ortak çalışma özelliğinden dolayı, bu işlem tamamlandıktan sonra e-tablonun değişikliklerinizi tam olarak yansıtacağı garanti edilmez. Ancak istekteki güncellemelerin atomik olarak birlikte uygulanacağı garanti edilir. Değişiklikleriniz, ortak çalışanların yaptığı değişikliklere göre 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 metni

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

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

object (Request)

E-tabloya uygulanacak güncellemelerin listesi. İstekler, belirtildikleri sırayla uygulanır. Herhangi bir istek geçerli değilse hiçbir istek 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" ise anlamlıdır.
responseIncludeGridData

boolean

Izgara verileri döndürülmelidirse doğru (true) değerini döndürür. Yalnızca includeSpreadsheetInResponse "true" ise anlamlıdır. İstek sırasında bir alan maskesi ayarlanmışsa bu parametre yoksayılır.
commentsViewMode

enum (CommentsViewMode)

E-tabloya uygulanacak yorum görüntüleme modu. Bu sayede, e-tabloyu yorumlar çıkarılmış veya eklenmiş şekilde görüntüleyebilirsiniz. Belirtilmezse COMMENTS_VIEW_MODE_OMITTED kullanılır. Yalnızca includeSpreadsheetInResponse "true" ise anlamlıdır.

Yanıt metni

E-tabloyu toplu olarak 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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Alanlar
spreadsheetId

string

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

object (Response)

Güncellemelerin yanıtı. Bazı isteklere verilen yanıtlar boş olsa da bu, güncellemelerle 1:1 eşleşir.
updatedSpreadsheet

object (Spreadsheet)

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

enum (CommentUpdateState)

Toplu istekte yorum güncellemelerinin uygulanıp uygulanmadığı.

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'nu inceleyin.

CommentUpdateState

Toplu istekteki yorum güncellemelerinin durumu.

Sıralamalar
COMMENT_UPDATE_STATE_UNSPECIFIED Yorum güncellemelerinin durumu belirtilmemiş.
NO_UPDATES_REQUESTED Toplu istekte yorum güncellemeleri istenmedi.
ALL_SAVED İstenen tüm yorum güncellemeleri toplu isteğe uygulandı.
ALL_FAILED_UNKNOWN_REASON İstenen yorum güncellemelerinin tümü başarısız oldu.