Method: forms.batchUpdate

Formu bir grup güncellemeyle değiştirin.

HTTP isteği

POST https://forms.googleapis.com/v1/forms/{formId}:batchUpdate

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

Yol parametreleri

Parametreler
formId

string

Zorunlu. Form kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

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

boolean

Yanıtta modelin güncellenmiş bir sürümünün döndürülüp döndürülmeyeceği.

requests[]

object (Request)

Zorunlu. Bu grubun güncelleme istekleri.

writeControl

object (WriteControl)

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

Yanıt gövdesi

BatchUpdateFormRequest için yanıt.

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

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

object (Form)

includeFormInResponse boole istek alanına bağlı olarak, uygulanan tüm mutasyonları/güncellemeleri içeren bir form döndürülür veya döndürülmez. Bu, bu değişiklikler tarafından oluşturulan düzeltme kimliğinden daha sonra olabilir.

replies[]

object (Response)

Güncellemelerin yanıtı. Bu, güncelleme istekleriyle 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/forms.body

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

İstek

Gönderilebilecek güncelleme isteği türleri.

JSON gösterimi
{

  // Union field kind can be only one of the following:
  "updateFormInfo": {
    object (UpdateFormInfoRequest)
  },
  "updateSettings": {
    object (UpdateSettingsRequest)
  },
  "createItem": {
    object (CreateItemRequest)
  },
  "moveItem": {
    object (MoveItemRequest)
  },
  "deleteItem": {
    object (DeleteItemRequest)
  },
  "updateItem": {
    object (UpdateItemRequest)
  }
  // End of list of possible types for union field kind.
}
Alanlar
Birlik alanı kind. İsteğin türü. kind yalnızca aşağıdakilerden biri olabilir:
updateFormInfo

object (UpdateFormInfoRequest)

Formun bilgilerini güncelleyin.

updateSettings

object (UpdateSettingsRequest)

Form ayarlarını günceller.

createItem

object (CreateItemRequest)

Yeni bir öğe oluşturur.

moveItem

object (MoveItemRequest)

Bir öğeyi belirtilen bir konuma taşıma

deleteItem

object (DeleteItemRequest)

Bir öğeyi silin.

updateItem

object (UpdateItemRequest)

Bir öğeyi güncelleyin.

UpdateFormInfoRequest

Formun bilgilerini güncelleyin.

JSON gösterimi
{
  "info": {
    object (Info)
  },
  "updateMask": string
}
Alanlar
info

object (Info)

Güncellenecek bilgiler.

updateMask

string (FieldMask format)

Zorunlu. Yalnızca bu maskede belirtilen değerler değiştirilir. En az bir alan belirtilmelidir. Kök info varsayılır ve belirtilmemelidir. Her alanı güncellemek için kısayol olarak tek bir "*" kullanılabilir.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

UpdateSettingsRequest

Formun FormSettings değerini güncelleyin.

JSON gösterimi
{
  "settings": {
    object (FormSettings)
  },
  "updateMask": string
}
Alanlar
settings

object (FormSettings)

Zorunlu. Güncellenecek ayarlar.

updateMask

string (FieldMask format)

Zorunlu. Yalnızca bu maskede belirtilen değerler değiştirilir. En az bir alan belirtilmelidir. Kök settings varsayılır ve belirtilmemelidir. Her alanı güncellemek için kısayol olarak tek bir "*" kullanılabilir.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

CreateItemRequest

Formda öğe oluşturun.

JSON gösterimi
{
  "item": {
    object (Item)
  },
  "location": {
    object (Location)
  }
}
Alanlar
item

object (Item)

Zorunlu. Oluşturulacak öğe.

location

object (Location)

Zorunlu. Yeni öğenin yerleştirileceği yer.

Konum

Formdaki belirli bir konum.

JSON gösterimi
{

  // Union field where can be only one of the following:
  "index": integer
  // End of list of possible types for union field where.
}
Alanlar
Birlik alanı where. Zorunlu. Formda bir konum belirtin. where yalnızca aşağıdakilerden biri olabilir:
index

integer

Formdaki bir öğenin dizini. Bu, aralıkta olmalıdır

[0..N)

, burada N formdaki öğelerin sayısıdır.

MoveItemRequest

Formdaki bir öğeyi taşıma

JSON gösterimi
{
  "originalLocation": {
    object (Location)
  },
  "newLocation": {
    object (Location)
  }
}
Alanlar
originalLocation

object (Location)

Zorunlu. Taşınacak öğenin konumu.

newLocation

object (Location)

Zorunlu. Öğenin yeni konumu.

DeleteItemRequest

Formdaki bir öğeyi silme

JSON gösterimi
{
  "location": {
    object (Location)
  }
}
Alanlar
location

object (Location)

Zorunlu. Silecek öğenin konumu.

UpdateItemRequest

Formdaki bir öğeyi güncelleyin.

JSON gösterimi
{
  "item": {
    object (Item)
  },
  "location": {
    object (Location)
  },
  "updateMask": string
}
Alanlar
item

object (Item)

Zorunlu. Öğe için yeni değerler. Öğe ve soru kimlikleri sağlanmışsa (ve alan maskesindeyse) kullanıldığını unutmayın. Bir kimlik boşsa (ve alan maskesindeyse) yeni bir kimlik oluşturulur. Bu, formu forms.get aracılığıyla alarak, bu öğenin yerel kopyasını istediğiniz şekilde değiştirerek ve UpdateItemRequest'u kullanarak aynı kimliklerle (veya alan maskesinde değil) geri yazarak bir öğeyi değiştirebileceğiniz anlamına gelir.

location

object (Location)

Zorunlu. Güncellenecek öğeyi tanımlayan konum.

updateMask

string (FieldMask format)

Zorunlu. Yalnızca bu maskede belirtilen değerler değiştirilir.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

WriteControl

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

JSON gösterimi
{

  // Union field control can be only one of the following:
  "requiredRevisionId": string,
  "targetRevisionId": string
  // End of list of possible types for union field control.
}
Alanlar
Birlik alanı control. Değişikliklerin uygulanacağı form düzeltmesini ve bu düzeltme formun mevcut düzeltmesi değilse isteğin nasıl davranması gerektiğini belirler. control yalnızca aşağıdakilerden biri olabilir:
requiredRevisionId

string

Yazma isteğinin uygulandığı formun düzeltme kimliği. Bu, formun en son düzeltmesi değilse istek işlenmez ve 400 hatalı istek hatası döndürülür.

targetRevisionId

string

Yazma isteğinin uygulandığı formun hedef düzeltme kimliği.

Bu düzeltmeden sonra değişiklikler yapıldıysa bu güncelleme isteğinde yapılan değişiklikler bu değişikliklere göre dönüştürülür. Bu işlem, formun hem istekteki hem de aradaki değişiklikleri içeren yeni bir düzeltilmesine neden olur. Sunucu, çelişen değişiklikleri çözer.

Hedef düzeltme kimliği yalnızca bir formun son sürümlerine yazmak için kullanılabilir. Hedef düzeltme, en son düzeltmeden çok gerideyse istek işlenmez ve 400 (Hatalı İstek Hatası) döndürülür. İstek, formun en son sürümü okunduktan sonra yeniden denenebilir. Hedef düzeltme kimliği, çoğu durumda okunduktan sonra birkaç dakika boyunca geçerli kalır ancak sık sık düzenlenen formlar için bu süre daha kısa olabilir.

Yanıt

Bir güncellemeden gelen tek bir yanıt.

JSON gösterimi
{

  // Union field kind can be only one of the following:
  "createItem": {
    object (CreateItemResponse)
  }
  // End of list of possible types for union field kind.
}
Alanlar
Birlik alanı kind. Yanıtın türü. kind yalnızca aşağıdakilerden biri olabilir:
createItem

object (CreateItemResponse)

Bir öğe oluşturma işleminin sonucu.

CreateItemResponse

Bir öğe oluşturma işleminin sonucu.

JSON gösterimi
{
  "itemId": string,
  "questionId": [
    string
  ]
}
Alanlar
itemId

string

Oluşturulan öğenin kimliği.

questionId[]

string

Bu öğe kapsamında oluşturulan sorunun kimliğidir. Soru grubu için bu öğe kapsamında oluşturulan tüm soruların kimlikleri listelenir.