Toplu istekler

Bu belgede, daha fazla bilgi edindiniz. Toplu işlem, bir uygulamanın verimi artırır.

Genel Bakış

İstemcinizin yaptığı her bağlantı, belirli miktarda ek yüke neden olur. Google Slaytlar API'si, müşterinizin birden fazla dosya yerleştirmesini sağlamak için toplu işlemeyi destekler. istek nesnelerinden her biri gerçekleştirilecek tek bir istek türünü belirtir. tek bir toplu istek haline getirilebilir. Toplu istek, performansı tek bir çağrıda sunucuya çağrıda bulunarak veya tek bir cevap verebilirsiniz.

Kullanıcıların, birden fazla isteği her zaman aynı grupta toplamasını öneririz. Aşağıda bazı örnekler verilmiştir: Toplu işlemeyi kullanabileceğiniz durumlara ilişkin örnekler:

  • API'yi kullanmaya yeni başladınız ve yüklemeniz gereken çok fazla veri var.
  • Meta veri veya biçimlendirme gibi özellikleri, birden fazla nesneler'i tıklayın.
  • Çok sayıda nesneyi silmeniz gerekir.

Sınırlar, yetkilendirme ve bağımlılıkla ilgili dikkat edilmesi gereken noktalar

Toplu güncellemeyi uygularken göz önünde bulundurulması gereken diğer öğelerin bir listesini aşağıda bulabilirsiniz:

  • Tüm alt istekler dahil olmak üzere her toplu istek, bir API olarak sayılır kullanım sınırınız için istekte bulunabilirsiniz.
  • Bir toplu isteğin kimliği bir kez doğrulanır. Bu tek kimlik doğrulama yöntemi tüm toplu güncelleme nesnelerini otomatik olarak değiştirir.
  • Sunucu, alt istekleri toplu istek. Sonraki alt istekler, dönüşüm sırasında gerçekleştirilen için geri bildirim alabilirsiniz. Örneğin, aynı toplu istekte, kullanıcılar metin ekleyin ve stilini belirleyin.

Grup ayrıntıları

Toplu istek bir batchUpdate yöntem çağrısından oluşur ekleme ve biçimlendirme gibi işlemler yapabilir.

Her istek, uygulanmadan önce doğrulanır. Gruptaki tüm alt istekler otomatik olarak uygulanır. Yani herhangi bir istek geçerli değilse güncellemenin tamamı başarısız olur ve şunlardan hiçbiri (potansiyel olarak bağımlı değildir) emin olun.

Bazı taleplerde, geçerli taleplerle ilgili bilgiler içeren yanıtlar bulunur. Örneğin, nesne eklemek için yapılan tüm toplu güncelleme istekleri yanıt döndürür. yeni eklenen nesnenin meta verilerine (ör. kimlik veya başlığı ekleyin.

Bu yaklaşımla, tek bir API kullanarak tüm bir Google belgesini oluşturabilirsiniz birden fazla alt istek içeren toplu güncelleme isteği.

Toplu isteğin biçimi

İstek; birden fazla etiket içeren tek bir JSON isteğidir. bir zorunlu özelliğe sahip iç içe yerleştirilmiş alt istekler: requests. İlgili içeriği oluşturmak için kullanılan istekler bağımsız bir dizi istek halinde oluşturulur. Her istekte İstek nesnesini temsil edecek ve özelliklerini içerecek JSON.

Toplu yanıt biçimi

Bir toplu isteğin yanıt biçimi şuna benzerdir: istek biçimine dönüştürülecektir. Sunucunun yanıtı teklinin tam yanıtını içerir yanıt nesnesini tanımlayın.

Ana JSON nesnesinin özelliği replies olarak adlandırılır. Yanıtlar isteklerinden birine verilen her yanıt ile bir dizi içinde döndürülür. aynı dizin sıralamasına sahiptir. Bazı isteklerde ve bu dizi dizinindeki yanıtın boş olduğu anlamına gelir.

Örnek

Aşağıdaki kod örneğinde, Slaytlar API'si.

İstek

Bu örnek toplu istekte aşağıdakilerin nasıl yapılacağı gösterilmektedir:

{
   "requests":[
      {
         "createSlide":{
            "insertionIndex":1,
            "objectId":"newSlide"
         }
      },
      {
         "createShape":{
            "elementProperties":{
               "pageObjectId":"newSlide",
               "size":{
                  "height":{
                     "magnitude":50,
                     "unit":"PT"
                  },
                  "width":{
                     "magnitude":200,
                     "unit":"PT"
                  }
               }
            },
            "shapeType":"TEXT_BOX",
            "objectId":"newTextBox"
         }
      },
      {
         "insertText":{
            "objectId":"newTextBox",
            "text":"Hello World"
         }
      }
   ]
}

Yanıt

Bu örnek toplu yanıt, toplu istek uygulandı. Not: InsertTextRequest yöntemi bir yanıt içermediğinden, [2] dizininin dizin değeri boş küme parantezlerinden oluşur. Toplu istek WriteControl özelliğini kullanmanızı öneririz.

{
   "requiredRevisionId": ID
   "presentationId": "",
   "replies":[
      {
         "createSlide":{
            "objectId":"newSlide"
         }
      },
      {
         "createShape":{
            "objectId":"newTextBox"
         }
      },
      {
         
      }
   ],
   "writeControl":{
      "requiredRevisionId": REVISION_ID
   }
}