Method: presentations.batchUpdate

Sunuya bir veya daha fazla güncelleme uygular.

Her request, uygulanmadan önce doğrulanır. Geçersiz olan istekler reddedilir ve hiçbir işlem uygulanmaz.

Bazı isteklerde, nasıl uygulandıkları hakkında bilgi veren replies bulunur. Diğer isteklerin bilgi döndürmesi gerekmez. Bu isteklerin her biri boş bir yanıt döndürür. Yanıtların sırası, isteklerin sırasıyla eşleşir.

Örneğin, batchUpdate işlevini dört güncellemeyle çağırdığınızı ve yalnızca üçüncüsünün bilgi döndürdüğünü varsayalım. Yanıtta iki boş yanıt bulunur: üçüncü istek için yanıt ve bu sırayla başka bir boş yanıt.

Sunuyu diğer kullanıcılar da düzenleyebileceğinden, sunu değişikliklerinizi tam olarak yansıtmayabilir: Değişiklikleriniz, ortak çalışan değişikliklerine göre değiştirilebilir. Ortak çalışan yoksa sunu, yaptığınız değişiklikleri yansıtır. Her durumda, isteğinizde belirtilen güncellemelerin birlikte atomik olarak 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 metni aşağıdaki yapıyla birlikte verileri 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üncellemeyle gönderilen 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, güncellemelerle 1:1 eşleşir ancak bazı isteklerin yanıtları boş olabilir.
writeControl

object (WriteControl)

İstek uygulandıktan sonra güncellenen yazma denetimi.

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.

WriteControl

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 gerekli olan sununun revision ID. 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ülür.

Bir yanıtta gerekli düzeltme kimliği döndürüldüğünde, bu kimlik, istek uygulandıktan sonra dokümanın düzeltme kimliğini gösterir.