Method: presentations.batchUpdate

Sunuya 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 size bilgi vermesi için replies izni bulunuyor. Diğer taleplerin bilgi döndürmesi gerekmez; bunların her biri boş bir yanıt döndürür. Yanıtların sırası isteklerin sıralamasıyla eşleşiyor.

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

Sunuyu başka kullanıcılar düzenliyor olabileceğinden, yaptığınız değişiklikler sunuya tam olarak yansımayabilir. Ortak çalışan değişikliklerine bağlı olarak sizin değişikliklerinizde değişiklik yapılabilir. Ortak çalışan yoksa yaptığınız değişiklikler sunuma yansıtılmalıdır. Her durumda, isteğinizdeki güncellemelerin atomik bir şekilde birlikte uygulanması 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 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ğini kontrol eder.

Yanıt gövdesi

Toplu güncellemeden 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 özet, güncellemelerle bire bir eşleşir ancak bazı isteklere verilen 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ılavuzunu inceleyin.

WriteControl

Yazma isteklerinin nasıl yürütüleceğini kontrol eder.

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

string

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

Gerekli düzeltme kimliği yanıtta döndürüldüğünde, istek uygulandıktan sonraki belgenin düzeltme kimliğini belirtir.