Method: presentations.batchUpdate

Sunuya bir veya daha fazla güncelleme uygular.

Her request, uygulanmadan önce doğrulanır. Geçerli bir istek olmaması durumunda, 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. Diğer isteklerin bilgi döndürmesi gerekmez; her istek boş yanıt döndürecektir. Yanıtların sırası, isteklerin sırası ile eşleşir.

Örneğin, dört güncellemeyle toplu güncelleme aradığınızı ve yalnızca üçüncüsünün bilgi döndürdüğünü varsayalım. Yanıt iki boş yanıt içerir: üçüncü isteğe verilen yanıt ve bu sırayla başka bir boş yanıt.

Diğer kullanıcılar sunuyu düzenlediği için sunu, değişikliklerinizi tam olarak yansıtmayabilir: Ortak çalışan değişikliklerine göre değişiklikleriniz değiştirilebilir. Ortak çalışan yoksa sunu, değişikliklerinizi yansıtmalıdır. Her durumda, isteğinizdeki güncellemelerin atom olarak birlikte uygulanacağı garanti edilir.

HTTP isteği

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
presentationId

string

Güncellemelerin uygulanacağı sunu.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Alanlar
requests[]

object (Request)

Sunuya uygulanacak güncellemelerin listesi.
writeControl

object (WriteControl)

Yazma isteklerinin nasıl yürütüleceği üzerinde kontrol sağlar.

Yanıt gövdesi

Toplu güncellemeden gelen yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Alanlar
presentationId

string

Güncellemelerin uygulandığı sunu.
replies[]

object (Response)

Güncellemelerin yanıtı. Bu işlem, güncellemeleri 1:1 olarak eşler ancak bazı isteklere yanıt verilmeyebilir.
writeControl

object (WriteControl)

İstek uygulandıktan sonra güncellenmiş yazma kontrolü.

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/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.

Yazma Denetimi

Yazma isteklerinin nasıl yürütüleceği üzerinde kontrol sağlar.

JSON gösterimi 
{
  "requiredRevisionId": string
}
Alanlar
requiredRevisionId

string

Yazma isteği için sununun revision ID kadarı. Belirtilirse ve gerekli düzeltme kimliği sununun mevcut düzeltme kimliğiyle eşleşmezse istek işlenmez ve 400 hatalı istek hatası döndürür.

Yanıtta gerekli bir düzeltme kimliği döndürüldüğünde bu, istek uygulandıktan sonra dokümanın düzeltme kimliğini belirtir.