Method: presentations.batchUpdate

Sunuya 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. Diğer isteklerin bilgi döndürmesi gerekmez. Bu istekler boş bir yanıt döndürür. Yanıtların sırası, isteklerin sırasıyla eşleşir.

Örneğin, batchUpdate'i dört güncelleme ile çağırdığınızı ve yalnızca üçüncü güncellemenin bilgi döndürdüğünü varsayalım. Yanıt, iki boş yanıttan oluşur: Üçüncü isteğe verilen yanıt ve başka bir boş yanıt.

Sunuyu başka kullanıcılar da düzenliyor olabileceğinden sunu, değişikliklerinizi tam olarak yansıtmayabilir. Değişiklikleriniz, ortak çalışanların değişikliklerine göre değiştirilebilir. Ortak çalışan yoksa sunu, değişikliklerinizi yansıtmalıdır. Her durumda, isteğinizdeki güncellemelerin atomik 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 metni

İstek içeriği 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 metni

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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Alanlar
presentationId

string

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

object (Response)

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

object (WriteControl)

İstek uygulandıktan sonra güncellenen yazma kontrolü.
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/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ılavuzu'nu inceleyin.

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 gereken sununun revision ID. Belirtilmişse 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ülür.

Bir yanıtta gerekli düzeltme kimliği döndürüldüğünde, bu kimlik isteğin uygulanmasından sonraki dokümanın düzeltme kimliğini gösterir.

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.