Method: forms.batchUpdate

Formu bir dizi güncellemeyle değiştirmek.

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ıya sahip 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ğini belirler.
requests[]

object (Request)

Zorunlu. Bu grubun güncelleme istekleri.
writeControl

object (WriteControl)

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

Yanıt gövdesi

BatchUpdateFormRequest 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 istek alanına göre, uygulanan tüm değişiklikleri/güncellemeleri içeren bir form döndürülüp döndürülmemektedir. Bu bilgi, söz konusu değişikliklerin oluşturduğu düzeltme kimliğinden daha sonra olabilir.
replies[]

object (Response)

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

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

İ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
Birleştirme alanı kind. İsteğin türü. kind şunlardan yalnızca biri olabilir:
updateFormInfo

object (UpdateFormInfoRequest)

Form'un Bilgilerini Güncelleyin.
updateSettings

object (UpdateSettingsRequest)

Formun ayarlarını günceller.
createItem

object (CreateItemRequest)

Yeni bir öğe oluşturur.
moveItem

object (MoveItemRequest)

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

object (DeleteItemRequest)

Öğe silme
updateItem

object (UpdateItemRequest)

Bir öğeyi güncelleyin.

UpdateFormInfoRequest

Form'un 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 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 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 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 yer.

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

integer

Formdaki bir öğenin dizini. Aralık içinde olmalıdır

[0..N)

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

MoveItemRequest

Formda öğe 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. Silinecek öğenin konumu.

UpdateItemRequest

Formdaki bir öğeyi güncelleme.

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ğlanması halinde (ve alan maskesinde yer alırlarsa) kullanıldığını unutmayın. Bir kimlik boşsa (ve alan maskesinde) yeni bir kimlik oluşturulur. Diğer bir deyişle, formu forms.get aracılığıyla alarak, öğenin yerel kopyasını istediğiniz şekilde değiştirerek ve UpdateItemRequest kullanarak (alan maskesinde değil) kimlikler aynı olacak şekilde bu öğeyi 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 nasıl yürütüleceğini kontrol eder.

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
Birleştirme alanı control. Değişikliklerin uygulanacağı formun düzeltmesini ve bu düzeltme formun geçerli düzeltmesi değilse isteğin nasıl davranması gerektiğini 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 olmuşsa bu güncelleme isteğindeki değişiklikler, söz konusu değişikliklere göre dönüştürülür. Bunun sonucunda formun, hem istekteki hem de müdahale edilen değişiklikleri içeren yeni bir revizyonu olur ve sunucu, çakışan değişiklikleri çözümler.

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. İstek, formun en son sürümü okunduktan sonra 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 formlar için 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
Birleştirme alanı kind. 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 kimliklerini listeler.