REST Resource: forms

Kaynak: Form

Google Formlar dokümanı. Drive'da bir form oluşturulur. Formun silinmesi veya erişim korumalarının değiştirilmesi Drive API üzerinden yapılır.

JSON gösterimi 
{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string
}
Alanlar
formId

string

Yalnızca çıkış. Form kimliği.
info

object (Info)

Zorunlu. Formun başlığı ve açıklaması.
settings

object (FormSettings)

Formun ayarları. Bu, UpdateSettingsRequest ile güncellenmelidir; forms.create ve UpdateFormInfoRequest sırasında yoksayılır.
items[]

object (Item)

Zorunlu. Bölüm üstbilgileri, sorular, yerleşik medya gibi öğeleri içerebilen form öğelerinin listesi.
revisionId

string

Yalnızca çıkış. Formun düzeltme kimliği. Güncelleme isteklerindeki WriteControl içinde, değişikliklerin temel aldığı düzeltmeyi tanımlamak için kullanılır.

Düzeltme kimliğinin biçimi zaman içinde değişebileceğinden opak şekilde ele alınmalıdır. Döndürülen düzeltme kimliğinin, yalnızca iade edildikten sonra 24 saat boyunca geçerli olacağı garanti edilir ve bu kimlik kullanıcılar arasında paylaşılamaz. Çağrılar arasında düzeltme kimliği değişmiyorsa form da değişmemiştir. Buna karşılık, kimliğin değiştirilmesi (aynı form ve kullanıcı için) genellikle formun güncellendiği anlamına gelir; ancak kimliğin değiştirilmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanabilir.
responderUri

string

Yalnızca çıkış. Katılımcılarla paylaşılacak form URI'si. Bu işlem, kullanıcının yanıt göndermesine izin veren ancak soruları düzenlemesine izin veren bir sayfa açar.
linkedSheetId

string

Yalnızca çıkış. Bu formdan yanıt toplayan bağlı Google E-Tablosu'nun kimliği (bu tür bir e-tablo varsa).

Bilgi

Formla ilgili genel bilgiler.

JSON gösterimi 
{
  "title": string,
  "documentTitle": string,
  "description": string
}
Alanlar
title

string

Zorunlu. Katılımcılara görünür olan form başlığı.
documentTitle

string

Yalnızca çıkış. Drive'da görünen doküman başlığı. Info.title boşsa Google Formlar kullanıcı arayüzündeki yerinde documentTitle görünebilir ve katılımcılar tarafından görülebilir. documentTitle, oluşturma sırasında ayarlanabilir ancak toplu güncelleme isteğiyle değiştirilemez. documentTitle sürümünü programatik olarak güncellemeniz gerekiyorsa lütfen Google Drive API'sini kullanın.
description

string

Formun açıklaması.

FormSettings

Formun ayarları.

JSON gösterimi 
{
  "quizSettings": {
    object (QuizSettings)
  }
}
Alanlar
quizSettings

object (QuizSettings)

Test formları ve notlandırmayla ilgili ayarlar.

QuizSettings

Test formları ve notlandırmayla ilgili ayarlar. Bunların UpdateSettingsRequest ile güncellenmesi gerekir.

JSON gösterimi 
{
  "isQuiz": boolean
}
Alanlar
isQuiz

boolean

Bu formun bir test olup olmadığı bilgisi. Doğru olduğunda yanıtlara Grading. soruya göre not verilir. Politika, yanlış değerine ayarlandığında Grading bölümündeki tüm sorular silinir.

Öğe

Formun tek bir öğesi. kind, öğenin türünü tanımlar.

JSON gösterimi 
{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}
Alanlar
itemId

string

Öğe kimliği.

Oluşturma sırasında sağlanabilir ancak kimlik, formda önceden kullanılmamış olmalıdır. Sağlanmazsa yeni bir kimlik atanır.
title

string

Öğenin başlığı.
description

string

Öğenin açıklaması.
Birleştirme alanı kind. Zorunlu. Bu öğenin türü. kind şunlardan yalnızca biri olabilir:
questionItem

object (QuestionItem)

Kullanıcıya soru sorar.
questionGroupItem

object (QuestionGroupItem)

Kullanıcıya tek bir ana istemle bir veya daha fazla soru sorar.
pageBreakItem

object (PageBreakItem)

Yeni bir sayfa bir başlıkla başlatır.
textItem

object (TextItem)

Sayfada başlık ve açıklama görüntüler.
imageItem

object (ImageItem)

Sayfada görsel görüntüler.
videoItem

object (VideoItem)

Sayfada bir video görüntüler.

QuestionItem

Tek bir soru içeren bir form öğesi.

JSON gösterimi 
{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}
Alanlar
question

object (Question)

Zorunlu. Gösterilen soru.
image

object (Image)

Soruda gösterilen resim.

Soru

İstediğiniz soruyu sorabilirsiniz. Belirli soru türü, kind tarafından bilinmektedir.

JSON gösterimi 
{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  }
  // End of list of possible types for union field kind.
}
Alanlar
questionId

string

Salt okunur. Soru kimliği.

Oluşturma sırasında sağlanabilir ancak kimlik, formda önceden kullanılmamış olmalıdır. Sağlanmazsa yeni bir kimlik atanır.
required

boolean

Katılımcının yanıtını gönderebilmesi için sorunun cevaplanmasının gerekip gerekmediği.
grading

object (Grading)

Soru için notlandırma ayarları.
Birleştirme alanı kind. Zorunlu. Katılımcıya sunulan sorunun türü. kind şunlardan yalnızca biri olabilir:
choiceQuestion

object (ChoiceQuestion)

Katılımcı, önceden tanımlanmış bir dizi seçenek arasından seçim yapabilir.
textQuestion

object (TextQuestion)

Katılımcılar serbest metin yanıtı girebilir.
scaleQuestion

object (ScaleQuestion)

Katılımcılar bir aralıktan sayı seçebilir.
dateQuestion

object (DateQuestion)

Katılımcılar tarih girebilir.
timeQuestion

object (TimeQuestion)

Katılımcılar zaman girebilir.
fileUploadQuestion

object (FileUploadQuestion)

Katılımcılar bir veya daha fazla dosya yükleyebilir.
rowQuestion

object (RowQuestion)

Bir QuestionGroupItem satırı.

ChoiceQuestion

Radyo/onay kutusu/açılır liste sorusu.

JSON gösterimi 
{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}
Alanlar
type

enum (ChoiceType)

Zorunlu. Seçilen sorunun türü.
options[]

object (Option)

Zorunlu. Katılımcının belirlemesi gereken seçeneklerin listesi.
shuffle

boolean

Seçeneklerin testin farklı örneklerinde rastgele sırayla gösterilip gösterilmeyeceği. Bu genellikle başka bir katılımcının ekranına bakan katılımcıların hile yapmasını önlemek veya ankette her zaman aynı seçenekleri en başta ya da sonuncuya yer vererek ortaya çıkabilecek yanlılığı gidermek için kullanılır.

ChoiceType

Seçimin türü.

Sıralamalar
CHOICE_TYPE_UNSPECIFIED Varsayılan değer. Kullanılmayan.
RADIO Radyo düğmeleri: Tüm seçenekler, yalnızca birini seçebilecek kullanıcıya gösterilir.
CHECKBOX Onay kutuları: Tüm seçenekler, istedikleri sayıda seçebilen kullanıcıya gösterilir.
DROP_DOWN Açılır menü: Seçenekler yalnızca kullanıcıya istek üzerine gösterilir. Aksi takdirde yalnızca geçerli seçenek gösterilir. Yalnızca bir seçenek belirtilebilir.

Option

Seçim sorusu için seçenek.

JSON gösterimi 
{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}
Alanlar
value

string

Zorunlu. Kullanıcıya sunulan seçim.
image

object (Image)

Resmi seçenek olarak görüntüleyin.
isOther

boolean

Seçeneğin "diğer" olup olmadığı. Şu anda yalnızca RADIO ve CHECKBOX seçenek türleri için geçerlidir ancak QuestionGroupItem seçeneklerinde izin verilmez.
Birleştirme alanı go_to_section. Bu seçenek belirlenmişse gidilecek bölüm. Şu anda yalnızca RADIO ve SELECT seçim türü için geçerlidir ancak QuestionGroupItem seçeneklerinde izin verilmez. go_to_section şunlardan yalnızca biri olabilir:
goToAction

enum (GoToAction)

Bölüm gezinme türü.
goToSectionId

string

Gidilecek bölüm başlığının öğe kimliği.

GoToAction

Bölümde gezinme sabitleri.

Sıralamalar
GO_TO_ACTION_UNSPECIFIED Varsayılan değer. Kullanılmayan.
NEXT_SECTION Sonraki bölüme gidin.
RESTART_FORM Formun başına dönün.
SUBMIT_FORM Formu hemen gönderin.

Resim

Bir resmi temsil eden veriler.

JSON gösterimi 
{
  "contentUri": string,
  "altText": string,
  "properties": {
    object (MediaProperties)
  },

  // Union field image_source can be only one of the following:
  "sourceUri": string
  // End of list of possible types for union field image_source.
}
Alanlar
contentUri

string

Yalnızca çıkış. Resmi indirebileceğiniz bir URI; sınırlı bir süre için geçerlidir.
altText

string

Fareyle üzerine gelindiğinde gösterilen ve ekran okuyucular tarafından okunan resmin açıklaması.
properties

object (MediaProperties)

Bir resmin özellikleri.
Birleştirme alanı image_source. Görsel kaynağının türü. Yeni resimler oluştururken tam olarak bir resim kaynağı alanı ayarlanmalıdır. image_source şunlardan yalnızca biri olabilir:
sourceUri

string

Yalnızca giriş. Kaynak URI, resmi eklemek için kullanılan URI'dir. Kaynak URI getirildiğinde boş olabilir.

MediaProperties

Medya özellikleri.

JSON gösterimi 
{
  "alignment": enum (Alignment),
  "width": integer
}
Alanlar
alignment

enum (Alignment)

Medyanın konumu.
width

integer

Medyanın piksel cinsinden genişliği. Medya görüntülendiğinde, bu değerden veya görüntülenen formun genişliğinden daha küçük olacak şekilde ölçeklendirilir. Medyanın orijinal en boy oranı korunur. Medya forma eklenirken genişlik belirtilmezse medya kaynağının genişliğine ayarlanır. Genişlik, 0 ile 740 arasında (0 ve 740 dahil) olmalıdır. Genişliğin 0 değerine veya belirtilmedi olarak ayarlanmasına yalnızca medya kaynağı güncellenirken izin verilir.

Uyum

Sayfada hizalama.

Sıralamalar
ALIGNMENT_UNSPECIFIED Varsayılan değer. Kullanılmayan.
LEFT Sola hizala.
RIGHT Sağa hizala.
CENTER Orta.

TextQuestion

Metin tabanlı bir sorudur.

JSON gösterimi 
{
  "paragraph": boolean
}
Alanlar
paragraph

boolean

Sorunun bir paragraf sorusu olup olmadığı. Yoksa soru, kısa bir metin sorusudur.

ScaleQuestion

Bir ölçek sorusu. Kullanıcı, aralarından seçim yapabileceği bir sayısal değer aralığına sahiptir.

JSON gösterimi 
{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}
Alanlar
low

integer

Zorunlu. Ölçek için mümkün olan en düşük değer.
high

integer

Zorunlu. Ölçek için mümkün olan en yüksek değer.
lowLabel

string

Ölçekteki en düşük noktayı açıklayan, görüntülenecek etiket.
highLabel

string

Ölçekteki en yüksek noktayı açıklamak için gösterilecek etiket.

DateQuestion

Tarihle ilgili bir soru. Tarih soruları varsayılan olarak yalnızca ay + gün şeklinde olur.

JSON gösterimi 
{
  "includeTime": boolean,
  "includeYear": boolean
}
Alanlar
includeTime

boolean

Zamanın soruya dahil edilip edilmeyeceğini belirtir.
includeYear

boolean

Soruya yılın eklenip eklenmeyeceğini belirtir.

TimeQuestion

Zamanla ilgili bir soru.

JSON gösterimi 
{
  "duration": boolean
}
Alanlar
duration

boolean

Soru, geçen bir süreyle ilgiliyse true. Aksi takdirde, günün belli bir saatidir.

FileUploadQuestion

Dosya yükleme sorusu. API şu anda dosya yükleme sorularının oluşturulmasını desteklememektedir.

JSON gösterimi 
{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}
Alanlar
folderId

string

Zorunlu. Yüklenen dosyaların depolandığı Drive klasörünün kimliği.
types[]

enum (FileType)

Bu soru tarafından kabul edilen dosya türleri.
maxFiles

integer

Bu soru için tek bir yanıtta yüklenebilecek maksimum dosya sayısı.
maxFileSize

string (int64 format)

Bu soruya yüklenen herhangi bir tek dosya için izin verilen maksimum bayt sayısı.

FileType

Dosya yükleme sorusuna yüklenebilecek dosya türleri

Sıralamalar
FILE_TYPE_UNSPECIFIED Varsayılan değer. Kullanılmayan.
ANY Türle ilgili kısıtlama yok.
DOCUMENT Google Dokümanlar dokümanı.
PRESENTATION Google Slaytlar sunusu.
SPREADSHEET Google E-Tablolar e-tablosu.
DRAWING Çizim.
PDF PDF.
IMAGE Bir resim.
VIDEO Video.
AUDIO Ses dosyası.

RowQuestion

Soru grubunun parçası olan bir sorunun yapılandırması.

JSON gösterimi 
{
  "title": string
}
Alanlar
title

string

Zorunlu. QuestionGroupItem içindeki tek satırın başlığı.

Not verme

Tek bir soru için notlandırma

JSON gösterimi 
{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}
Alanlar
pointValue

integer

Zorunlu. Katılımcının doğru yanıt için otomatik olarak alabileceği maksimum puan sayısı. Bu değer negatif olmamalıdır.
correctAnswers

object (CorrectAnswers)

Zorunlu. Sorunun cevap anahtarı. Yanıtlar, bu alana göre otomatik olarak notlandırılır.
whenRight

object (Feedback)

Doğru yanıtlar için görüntülenen geri bildirim. Bu geri bildirim yalnızca doğru yanıtları olan çoktan seçmeli sorular için ayarlanabilir.
whenWrong

object (Feedback)

Yanlış yanıtlar için görüntülenen geri bildirim. Bu geri bildirim yalnızca doğru yanıtları olan çoktan seçmeli sorular için ayarlanabilir.
generalFeedback

object (Feedback)

Tüm yanıtlar için gösterilen geri bildirim. Bu yöntem, kısa yanıtlı sorularda, anket sahibi katılımcılara, yanıta resmi olarak not vermeden önce soruyu doğru yanıtlayıp yanıtlamadıkları hakkında hızlı bir şekilde fikir vermek istediğinde kullanılır. Otomatik olarak not verilen çoktan seçmeli sorular için genel geri bildirim ayarlanamaz.

CorrectAnswers

Sorunun yanıt anahtarı.

JSON gösterimi 
{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}
Alanlar
answers[]

object (CorrectAnswer)

Doğru yanıtların listesi. Bir test yanıtı, bu yanıtlara göre otomatik olarak notlandırılabilir. Tek değerli sorular için yanıtlar, bu listedeki herhangi bir değerle eşleşirse (diğer bir deyişle, birden fazla doğru yanıt olması mümkündür) doğru olarak işaretlenir. Birden çok değerli (CHECKBOX) sorularda, bir yanıt tam olarak bu listedeki değerleri içeriyorsa doğru olarak işaretlenir.

CorrectAnswer

Bir soru için tek bir doğru yanıt. Birden çok değerli (CHECKBOX) sorularda tek bir doğru yanıt seçeneğini temsil etmek için birkaç CorrectAnswer gerekebilir.

JSON gösterimi 
{
  "value": string
}
Alanlar
value

string

Zorunlu. Doğru yanıt değeri. Çeşitli değer türlerinin nasıl biçimlendirildiğiyle ilgili ayrıntılar için TextAnswer.value dokümanlarına bakın.

QuestionGroupItem

Bir araya getirilmiş birden çok sorudan oluşan bir soruyu tanımlar.

JSON gösterimi 
{
  "questions": [
    {
      object (Question)
    }
  ],
  "image": {
    object (Image)
  },

  // Union field kind can be only one of the following:
  "grid": {
    object (Grid)
  }
  // End of list of possible types for union field kind.
}
Alanlar
questions[]

object (Question)

Zorunlu. Bu soru grubuna ait soruların listesi. Bir soru yalnızca bir gruba ait olmalıdır. Grubun kind ayarı, izin verilen soru türlerini etkileyebilir.
image

object (Image)

Belirli soruların üstündeki soru grubunda gösterilen resim.
Birleştirme alanı kind. Zorunlu. İzin verilen soru türlerini ve bunların nasıl gösterileceğini belirleyen soru grubunun türü. kind şunlardan yalnızca biri olabilir:
grid

object (Grid)

Soru grubu, aynı seçenekleri paylaşan çoktan seçmeli sorulardan oluşan bir tablodur. grid ayarlandığında gruptaki tüm sorular row türünde olmalıdır.

Izgara

Her satırın ayrı bir soru oluşturduğu bir seçenekler ızgarası (radyo düğmesi veya onay kutuları). Her satırda aynı seçenekler bulunur ve bunlar sütunlar olarak gösterilir.

JSON gösterimi 
{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}
Alanlar
columns

object (ChoiceQuestion)

Zorunlu. Tablodaki her soru tarafından paylaşılan seçenekler. Başka bir deyişle, sütunların değerleri. Yalnızca CHECK_BOX ve RADIO seçeneğe izin verilir.
shuffleQuestions

boolean

true ise sorular rastgele sıralanır. Diğer bir deyişle, satırlar her katılımcı için farklı bir sırada görünür.

PageBreakItem

Sayfa sonu. Bu öğenin başlığı ve açıklaması yeni sayfanın üst kısmında gösterilir.

TextItem

Metin öğesi.

ImageItem

Resim içeren bir öğe.

JSON gösterimi 
{
  "image": {
    object (Image)
  }
}
Alanlar
image

object (Image)

Zorunlu. Öğede gösterilen resim.

VideoItem

Video içeren öğe.

JSON gösterimi 
{
  "video": {
    object (Video)
  },
  "caption": string
}
Alanlar
video

object (Video)

Zorunlu. Öğede gösterilen video.
caption

string

Videonun altında gösterilen metin.

Video

Videoyu temsil eden veriler.

JSON gösterimi 
{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}
Alanlar
youtubeUri

string

Zorunlu. YouTube URI'si.
properties

object (MediaProperties)

Videonun özellikleri.

Yöntemler

batchUpdate

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

create

 İstekte sağlanan form iletisinde belirtilen başlığı kullanarak yeni bir form oluşturun.

get

 Form alın.