- 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 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 | |
---|---|
form |
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 ( |
Alanlar | |
---|---|
include |
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. |
write |
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 ( |
Alanlar | |
---|---|
form |
|
replies[] |
Güncellemelerin yanıtı. Bu, güncelleme istekleriyle 1:1 eşleşir ancak bazı isteklerin yanıtları boş olabilir. |
write |
İ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 |
Alanlar | |
---|---|
Birlik alanı kind . İsteğin türü. kind yalnızca aşağıdakilerden biri olabilir: |
|
update |
Formun bilgilerini güncelleyin. |
update |
Form ayarlarını günceller. |
create |
Yeni bir öğe oluşturur. |
move |
Bir öğeyi belirtilen bir konuma taşıma |
delete |
Bir öğeyi silin. |
update |
Bir öğeyi güncelleyin. |
UpdateFormInfoRequest
Formun bilgilerini güncelleyin.
JSON gösterimi |
---|
{
"info": {
object ( |
Alanlar | |
---|---|
info |
Güncellenecek bilgiler. |
update |
Zorunlu. Yalnızca bu maskede belirtilen değerler değiştirilir. En az bir alan belirtilmelidir. Kök Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: |
UpdateSettingsRequest
Formun FormSettings
değerini güncelleyin.
JSON gösterimi |
---|
{
"settings": {
object ( |
Alanlar | |
---|---|
settings |
Zorunlu. Güncellenecek ayarlar. |
update |
Zorunlu. Yalnızca bu maskede belirtilen değerler değiştirilir. En az bir alan belirtilmelidir. Kök Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: |
CreateItemRequest
Formda öğe oluşturun.
JSON gösterimi |
---|
{ "item": { object ( |
Alanlar | |
---|---|
item |
Zorunlu. Oluşturulacak öğe. |
location |
Zorunlu. Yeni öğenin yerleştirileceği yer. |
Konum
Formdaki belirli bir konum.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı where . Zorunlu. Formda bir konum belirtin. where yalnızca aşağıdakilerden biri olabilir: |
|
index |
Formdaki bir öğenin dizini. Bu, aralıkta olmalıdır
, burada N formdaki öğelerin sayısıdır. |
MoveItemRequest
Formdaki bir öğeyi taşıma
JSON gösterimi |
---|
{ "originalLocation": { object ( |
Alanlar | |
---|---|
original |
Zorunlu. Taşınacak öğenin konumu. |
new |
Zorunlu. Öğenin yeni konumu. |
DeleteItemRequest
Formdaki bir öğeyi silme
JSON gösterimi |
---|
{
"location": {
object ( |
Alanlar | |
---|---|
location |
Zorunlu. Silecek öğ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 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 |
location |
Zorunlu. Güncellenecek öğeyi tanımlayan konum. |
update |
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: |
WriteControl
Yazma isteklerinin nasıl yürütüleceği üzerinde kontrol sağlar.
JSON gösterimi |
---|
{ // Union field |
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: |
|
required |
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. |
target |
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 |
Alanlar | |
---|---|
Birlik alanı kind . Yanıtın türü. kind yalnızca aşağıdakilerden biri olabilir: |
|
create |
Bir öğe oluşturma işleminin sonucu. |
CreateItemResponse
Bir öğe oluşturma işleminin sonucu.
JSON gösterimi |
---|
{ "itemId": string, "questionId": [ string ] } |
Alanlar | |
---|---|
item |
Oluşturulan öğenin kimliği. |
question |
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. |