Method: forms.batchUpdate

Formu birden fazla 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 gövdesi, aşağıdaki yapıyla birlikte veriler 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 yürütülme şekli ü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 Bool isteği alanına bağlı olarak, uygulanan tüm değişiklikleri/güncellemeleri içeren bir form döndürülür veya döndürülmez. Bu tanımlayıcı, söz konusu 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'i eşleştirir, 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/forms.body

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.

İstek

Yapılabilecek 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
kind alanı. İstek türü. kind şunlardan yalnızca biri olabilir:
updateFormInfo

object (UpdateFormInfoRequest)

Form Bilgilerini Güncelleyin.
updateSettings

object (UpdateSettingsRequest)

Formun ayarlarını günceller.
createItem

object (CreateItemRequest)

Yeni bir öğe oluşturur.
moveItem

object (MoveItemRequest)

Bir öğeyi belirli bir konuma taşıyın.
deleteItem

object (DeleteItemRequest)

Bir öğeyi silebilirsiniz.
updateItem

object (UpdateItemRequest)

Bir öğeyi güncelleyin.

UpdateFormInfoRequest

Form Bilgilerini Güncelleyin.

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

object (Info)

Güncellenecek bilgi.
updateMask

string (FieldMask format)

Zorunlu. Yalnızca bu maskede adı geçen değerler değiştirilir. En az bir alan belirtilmelidir. Kök info örtülüdür ve belirtilmemelidir. Her alanı güncellemek için kısa bir ifade olarak tek bir "*" kullanılabilir.

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

UpdateSettingsRequest

Formun FormSettings öğesini güncelleyin.

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

object (FormSettings)

Zorunlu. Güncelleme için kullanılacak ayarlar.
updateMask

string (FieldMask format)

Zorunlu. Yalnızca bu maskede adı geçen değerler değiştirilir. En az bir alan belirtilmelidir. Kök settings örtülüdür ve belirtilmemelidir. Her alanı güncellemek için kısa bir ifade olarak tek bir "*" kullanılabilir.

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

CreateItemRequest

Formda bir öğ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

Bir 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
where alanı. Zorunlu. Formda bir konum belirtin. where şunlardan yalnızca biri olabilir:
index

integer

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

[0..N)

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

MoveItemRequest

Formdaki bir öğeyi taşıyın.

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. Silinecek öğ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 kimliklerinin sağlanmışsa (ve alan maskesindeyse) kullanıldığını unutmayın. Bir kimlik boşsa (ve alan maskesinde) yeni bir kimlik oluşturulur. Yani formu forms.get aracılığıyla alıp ilgili öğenin yerel kopyasını istediğiniz gibi değiştirerek ve UpdateItemRequest kullanarak öğeyi (kimlikler aynı (veya alan maskesinde değil) olacak şekilde) değiştirebilirsiniz.
location

object (Location)

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

string (FieldMask format)

Zorunlu. Yalnızca bu maskede adı geçen değerler değiştirilir.

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

WriteControl

Yazma isteklerinin yürütülme şekli ü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
control alanı. Değişikliklerin uygulanacağı formun düzeltmesini ve bu düzeltme formun mevcut düzeltmesi değilse isteğin nasıl davranacağını belirler. control şunlardan yalnızca 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ü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ğindeki değişiklikler, söz konusu değişikliklere göre dönüştürülür. Bu, formda hem istekteki değişiklikleri hem de aradaki değişiklikleri içeren yeni bir düzeltme yapılmasıyla sonuçlanır ve sunucu çakışan değişiklikleri çözer.

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

Yanıt

Bir güncellemeden 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
kind alanı. Yanıtın türü. kind şunlardan yalnızca biri olabilir:
createItem

object (CreateItemResponse)

Bir öğe oluşturmanın sonucu.

CreateItemResponse

Bir öğe oluşturmanın sonucu.

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

string

Oluşturulan öğenin kimliği.
questionId[]

string

Bu öğenin bir parçası olarak oluşturulan sorunun kimliği (soru grubu için bu öğe için oluşturulan tüm soruların kimlikleri).