- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- İstek
- UpdateFormInfoRequest
- UpdateSettingsRequest
- CreateItemRequest
- Konum
- MoveItemRequest
- DeleteItemRequest
- UpdateItemRequest
- WriteControl
- Yanıt
- CreateItemResponse
- Deneyin.
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 |
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 ( |
Alanlar | |
---|---|
includeFormInResponse |
Yanıtta modelin güncellenmiş bir sürümünün döndürülüp döndürülmeyeceği. |
requests[] |
Zorunlu. Bu grubun güncelleme istekleri. |
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 ( |
Alanlar | |
---|---|
form |
|
replies[] |
Güncellemelerin yanıtı. Bu, güncelleme istekleriyle 1:1'i eşleştirir, ancak bazı isteklere verilen yanıtlar boş olabilir. |
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 |
Alanlar | |
---|---|
kind alanı. İstek türü. kind şunlardan yalnızca biri olabilir: |
|
updateFormInfo |
Form Bilgilerini Güncelleyin. |
updateSettings |
Formun ayarlarını günceller. |
createItem |
Yeni bir öğe oluşturur. |
moveItem |
Bir öğeyi belirli bir konuma taşıyın. |
deleteItem |
Bir öğeyi silebilirsiniz. |
updateItem |
Bir öğeyi güncelleyin. |
UpdateFormInfoRequest
Form Bilgilerini Güncelleyin.
JSON gösterimi |
---|
{
"info": {
object ( |
Alanlar | |
---|---|
info |
Güncellenecek bilgi. |
updateMask |
Zorunlu. Yalnızca bu maskede adı geçen değerler değiştirilir. En az bir alan belirtilmelidir. Kök Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: |
UpdateSettingsRequest
Formun FormSettings
öğesini güncelleyin.
JSON gösterimi |
---|
{
"settings": {
object ( |
Alanlar | |
---|---|
settings |
Zorunlu. Güncelleme için kullanılacak ayarlar. |
updateMask |
Zorunlu. Yalnızca bu maskede adı geçen değerler değiştirilir. En az bir alan belirtilmelidir. Kök Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: |
CreateItemRequest
Formda bir öğe oluşturun.
JSON gösterimi |
---|
{ "item": { object ( |
Alanlar | |
---|---|
item |
Zorunlu. Oluşturulacak öğe. |
location |
Zorunlu. Yeni öğenin yerleştirileceği yer. |
Konum
Bir formdaki belirli bir konum.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
where alanı. Zorunlu. Formda bir konum belirtin. where şunlardan yalnızca biri olabilir: |
|
index |
Formdaki bir öğenin dizini. Bu, şu aralıkta olmalıdır:
burada N, formdaki öğelerin sayısıdır. |
MoveItemRequest
Formdaki bir öğeyi taşıyın.
JSON gösterimi |
---|
{ "originalLocation": { object ( |
Alanlar | |
---|---|
originalLocation |
Zorunlu. Taşınacak öğenin konumu. |
newLocation |
Zorunlu. Öğenin yeni konumu. |
DeleteItemRequest
Formdaki bir öğeyi silme.
JSON gösterimi |
---|
{
"location": {
object ( |
Alanlar | |
---|---|
location |
Zorunlu. Silinecek öğenin konumu. |
UpdateItemRequest
Formdaki bir öğeyi güncelleyin.
JSON gösterimi |
---|
{ "item": { object ( |
Alanlar | |
---|---|
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 |
location |
Zorunlu. Güncellenecek öğeyi tanımlayan konum. |
updateMask |
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: |
WriteControl
Yazma isteklerinin yürütülme şekli üzerinde kontrol sağlar.
JSON gösterimi |
---|
{ // Union field |
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 |
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 |
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 |
Alanlar | |
---|---|
kind alanı. Yanıtın türü. kind şunlardan yalnızca biri olabilir: |
|
createItem |
Bir öğe oluşturmanın sonucu. |
CreateItemResponse
Bir öğe oluşturmanın sonucu.
JSON gösterimi |
---|
{ "itemId": string, "questionId": [ string ] } |
Alanlar | |
---|---|
itemId |
Oluşturulan öğenin kimliği. |
questionId[] |
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). |