Method: spreadsheets.batchUpdate

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

Her request uygulanmadan önce doğrulanır. İsteklerden herhangi biri geçerli değilse isteğin tamamı başarısız olur ve hiçbir değişiklik uygulanmaz.

Bazı isteklerde, nasıl uygulandıkları hakkında bilgi veren replies simgesi bulunur. Yanıtlar, istekleri yansıtır. Örneğin, 4 güncelleme uyguladıysanız ve 3. güncellemeye yanıt verildiyse yanıt sırasıyla 2 boş yanıt, gerçek yanıt ve başka bir boş yanıt içerir.

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 değişikliklerine göre değiştirilebilir. Ortak çalışan yoksa e-tablo değişikliklerinizi yansıtı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. İsteklerden herhangi biri 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 içinde alan maskesi ayarlanmışsa bu parametre yoksayılır.
commentsViewMode

enum (CommentsViewMode)

E-tabloya uygulanacak yorum görünümü modu. Bu sayede, e-tablo yorumlar çıkarılarak veya eklenerek görüntülenebilir. Belirtilmezse COMMENTS_VIEW_MODE_OMITTED kullanılır. Yalnızca includeSpreadsheetInResponse "true" ise anlamlıdır.

Yanıt metni

E-tablonun toplu olarak güncellenmesiyle 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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
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ı isteklere verilen 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.
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'na bakın.

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.