- Kaynak: Form
- Bilgi
- FormSettings
- QuizSettings
- Öğe
- QuestionItem
- Soru
- ChoiceQuestion
- ChoiceType
- Seçenek
- GoToAction
- Resim
- MediaProperties
- Hizalama
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- Not verme
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Izgara
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Video
- Yöntemler
Kaynak: Form
Google Formlar dokümanı. Drive'da bir form oluşturulur. Formu silme veya erişim korumalarını değiştirme işlemleri Drive API aracılığıyla yapılır.
JSON gösterimi |
---|
{ "formId": string, "info": { object ( |
Alanlar | |
---|---|
formId |
Yalnızca çıkış. Form kimliği. |
info |
Zorunlu. Formun başlığı ve açıklaması. |
settings |
Formun ayarları. Bu parametre |
items[] |
Zorunlu. Form öğelerinin listesi (bölüm üstbilgileri, sorular, yerleştirilmiş medya vb. olabilir). |
revisionId |
Yalnızca çıkış. Formun düzeltme kimliği. Değişikliklerin temel aldığı düzeltmeyi tanımlamak için güncelleme isteklerindeki Düzeltme kimliğinin biçimi zaman içinde değişebileceği için opak bir şekilde ele alınmalıdır. Döndürülen bir düzeltme kimliği, iade edildikten sonra yalnızca 24 saat geçerli olur ve kullanıcılar arasında paylaşılamaz. Çağrılar arasında düzeltme kimliği değişmezse form değişmemiştir. Bunun aksine, değiştirilen kimlik (aynı form ve kullanıcı için) genellikle formun güncellendiği anlamına gelir; ancak değişen kimlik, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanabilir. |
responderUri |
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 vermeyen bir sayfa açar. |
linkedSheetId |
Yalnızca çıkış. Bu formdaki yanıtları toplayan bağlı Google E-Tablosunun kimliği (böyle bir e-tablo varsa). |
Bilgi
Bir formla ilgili genel bilgiler.
JSON gösterimi |
---|
{ "title": string, "documentTitle": string, "description": string } |
Alanlar | |
---|---|
title |
Zorunlu. Katılımcılara gösterilecek formun başlığı. |
documentTitle |
Yalnızca çıkış. Drive'da görünür olan dokümanın başlığı. |
description |
Formun açıklaması. |
FormSettings
Formun ayarları.
JSON gösterimi |
---|
{
"quizSettings": {
object ( |
Alanlar | |
---|---|
quizSettings |
Test formları ve not vermeyle ilgili ayarlar. |
QuizSettings
Test formları ve not vermeyle ilgili ayarlar. Bunlar UpdateSettingsRequest ile güncellenmelidir.
JSON gösterimi |
---|
{ "isQuiz": boolean } |
Alanlar | |
---|---|
isQuiz |
Bu formun test olup olmadığı. Yanıtlar doğru olduğunda |
Öğe
Formun tek bir öğesi. kind
, öğenin ne tür bir öğe olduğunu tanımlar.
JSON gösterimi |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Alanlar | |
---|---|
itemId |
Öğe kimliği. Kimlik, oluşturma sırasında sağlanabilir ancak formda daha önce kullanılmamalıdır. Sağlanmazsa yeni bir kimlik atanır. |
title |
Öğenin başlığı. |
description |
Öğenin açıklaması. |
kind alanı. Zorunlu. Bu öğenin türü. kind aşağıdakilerden yalnızca biri olabilir: |
|
questionItem |
Kullanıcıya bir soru sunar. |
questionGroupItem |
Kullanıcıya tek bir önemli istemle bir veya daha fazla soru sorar. |
pageBreakItem |
Başlığı olan yeni bir sayfa başlatır. |
textItem |
Sayfada bir başlık ve açıklama görüntüler. |
imageItem |
Sayfada bir resim görüntüler. |
videoItem |
Sayfada bir video gösterir. |
QuestionItem
Tek bir soru içeren form öğesi.
JSON gösterimi |
---|
{ "question": { object ( |
Alanlar | |
---|---|
question |
Zorunlu. Gösterilen soru. |
image |
Soruda gösterilen resim. |
Soru
Herhangi bir sorunuz var mı? Belirli bir soru türü kind
tarafından bilinir.
JSON gösterimi |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Alanlar | |
---|---|
questionId |
Salt okunur. Soru kimliği. Kimlik, oluşturma sırasında sağlanabilir ancak formda daha önce kullanılmamalıdır. Sağlanmazsa yeni bir kimlik atanır. |
required |
Bir katılımcının yanıtını göndermesi için sorunun yanıtlanıp cevaplanmayacağı. |
grading |
Sorunun notlandırma ayarları. |
kind alanı. Zorunlu. Katılımcılara sunulan sorunun türü. kind şunlardan yalnızca biri olabilir: |
|
choiceQuestion |
Katılımcılar önceden tanımlanmış bir seçenek grubundan seçim yapabilir. |
textQuestion |
Katılımcıları serbest metin şeklinde yanıtlayabilirler. |
scaleQuestion |
Katılımcılar bir aralıktan sayı seçebilir. |
dateQuestion |
Katılımcı tarih girebilir. |
timeQuestion |
Katılımcı bir saat girebilir. |
fileUploadQuestion |
Katılımcı bir veya daha fazla dosya yükleyebilir. |
rowQuestion |
|
ChoiceQuestion
Radyo/onay kutusu/açılır liste sorusu.
JSON gösterimi |
---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Zorunlu. Seçim sorusunun türü. |
options[] |
Zorunlu. Katılımcının seçmesi gereken seçeneklerin listesi. |
shuffle |
Seçeneklerin testin farklı örnekleri için rastgele sırada gösterilip gösterilmeyeceği. Bu yaklaşım genellikle, başka bir katılımcının ekranına bakan katılımcıların hile yapmasını önlemek veya bir ankette her zaman aynı seçenekleri ya da sonuncuya yer vererek yanlılığı gidermek için kullanılır. |
ChoiceType
Tercih edilen türdür.
Sıralamalar | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Varsayılan değer. Kullanılmamış. |
RADIO |
Radyo düğmeleri: Tüm seçenekler, yalnızca birini seçebilen kullanıcıya gösterilir. |
CHECKBOX |
Onay kutuları: Tüm seçenekler kullanıcıya gösterilir ve kullanıcılar istedikleri sayıda seçeneği işaretleyebilir. |
DROP_DOWN |
Açılır menü: Seçenekler kullanıcıya yalnızca 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 bir seçenek.
JSON gösterimi |
---|
{ "value": string, "image": { object ( |
Alanlar | |
---|---|
value |
Zorunlu. Kullanıcıya sunulan seçim. |
image |
Resim seçenek olarak gösterilir. |
isOther |
Seçeneğin "diğer" olup olmadığı. Şu anda yalnızca |
go_to_section alanı. Bu seçenek belirlenirse gideceğiniz bölüm. Şu anda yalnızca RADIO ve SELECT seçim türü için geçerlidir ancak QuestionGroupItem içinde izin verilmez. go_to_section şunlardan yalnızca biri olabilir: |
|
goToAction |
Bölüm gezinme türü. |
goToSectionId |
Gidilecek bölüm başlığının öğe kimliği. |
GoToAction
Bölüm bazında gezinme için sabitler.
Sıralamalar | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Varsayılan değer. Kullanılmamış. |
NEXT_SECTION |
Sonraki bölüme gidin. |
RESTART_FORM |
Formun başına geri dönün. |
SUBMIT_FORM |
Formu hemen gönderin. |
Resim
Bir resmi temsil eden veriler.
JSON gösterimi |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
Alanlar | |
---|---|
contentUri |
Yalnızca çıkış. Resmi indirebileceğiniz bir URI. Bu yalnızca sınırlı bir süre için geçerlidir. |
altText |
Resmin üzerine gelindiğinde gösterilen ve ekran okuyucular tarafından okunan bir açıklaması. |
properties |
Bir resmin özellikleri. |
image_source alanı. Resim kaynağının türü. Yeni resimler oluşturulurken tam olarak bir resim kaynağı alanı ayarlanmalıdır. image_source şunlardan yalnızca biri olabilir: |
|
sourceUri |
Yalnızca giriş. Kaynak URI, resmi eklemek için kullanılan URI'dır. Kaynak URI getirildiğinde boş olabilir. |
MediaProperties
Medyanın özellikleri.
JSON gösterimi |
---|
{
"alignment": enum ( |
Alanlar | |
---|---|
alignment |
Medyanın konumu. |
width |
Medyanın piksel cinsinden genişliği. Medya görüntülenirken bu değerden küçüğe veya görüntülenen formun genişliğine ölçeklendirilir. Medyanın orijinal en boy oranı korunur. Forma medya eklendiğinde 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 veya belirtilmedi değerine ayarlanmasına yalnızca medya kaynağı güncellenirken izin verilir. |
Uyum
Sayfada hizalama.
Sıralamalar | |
---|---|
ALIGNMENT_UNSPECIFIED |
Varsayılan değer. Kullanılmamış. |
LEFT |
Sola hizala. |
RIGHT |
Sağa hizala. |
CENTER |
Orta. |
TextQuestion
Metin tabanlı bir soru.
JSON gösterimi |
---|
{ "paragraph": boolean } |
Alanlar | |
---|---|
paragraph |
Sorunun paragraf sorusu olup olmadığı. Cevabınız hayırsa soru kısa metinli bir sorudur. |
ScaleQuestion
Ölçeklendirme sorusu. Kullanıcının seçebileceği bir sayısal değer aralığı vardır.
JSON gösterimi |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Alanlar | |
---|---|
low |
Zorunlu. Ölçekte olabilecek en düşük değerdir. |
high |
Zorunlu. Ölçek için mümkün olan en yüksek değer. |
lowLabel |
Ölçeğin en düşük noktasını açıklayan, görüntülenecek etiket. |
highLabel |
Ölçeğin en yüksek noktasını açıklayan, gösterilecek etiket. |
DateQuestion
Tarih sorusu. Tarih soruları varsayılan olarak yalnızca ay + gün şeklinde ayarlanır.
JSON gösterimi |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Alanlar | |
---|---|
includeTime |
Sorunun bir parçası olarak saatin eklenip eklenmeyeceğini belirtir. |
includeYear |
Yılın, sorunun bir parçası olarak eklenip eklenmeyeceğini belirtir. |
TimeQuestion
Zaman sorusu.
JSON gösterimi |
---|
{ "duration": boolean } |
Alanlar | |
---|---|
duration |
Soru geçen bir zamanla ilgiliyse |
FileUploadQuestion
Dosya yükleme sorusu. API şu anda dosya yükleme soruları oluşturmayı desteklememektedir.
JSON gösterimi |
---|
{
"folderId": string,
"types": [
enum ( |
Alanlar | |
---|---|
folderId |
Zorunlu. Yüklenen dosyaların depolandığı Drive klasörünün kimliği. |
types[] |
Bu soru tarafından kabul edilen dosya türleri. |
maxFiles |
Bu soru için tek bir yanıtta yüklenebilecek maksimum dosya sayısı. |
maxFileSize |
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ılmamış. |
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
Bir soru grubunun parçası olan bir sorunun yapılandırması.
JSON gösterimi |
---|
{ "title": string } |
Alanlar | |
---|---|
title |
Zorunlu. |
Not verme
Tek bir soruya not verme
JSON gösterimi |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Alanlar | |
---|---|
pointValue |
Zorunlu. Bir katılımcının doğru yanıt için otomatik olarak alabileceği maksimum puan. Bu negatif olmamalıdır. |
correctAnswers |
Zorunlu. Sorunun cevap anahtarı. Yanıtlar bu alana göre otomatik olarak notlandırılır. |
whenRight |
Doğru yanıtlar için gösterilen geri bildirim. Bu geri bildirim yalnızca doğru yanıtı sağlanmış çoktan seçmeli sorular için ayarlanabilir. |
whenWrong |
Yanlış yanıtlar için gösterilen geri bildirim. Bu geri bildirim yalnızca doğru yanıtı sağlanmış çoktan seçmeli sorular için ayarlanabilir. |
generalFeedback |
Tüm yanıtlar için gösterilen geri bildirim. Bu, genellikle bir test sahibi, yanıtı resmi olarak notlandırmadan önce soruyu doğru yanıtlayıp yanıtlamadıkları konusunda hızlı bir şekilde bir fikir vermek istediğinde, kısa cevaplı sorular için kullanılır. Otomatik olarak not verilen çoktan seçmeli sorular için genel geri bildirim ayarlanamaz. |
CorrectAnswers
Bir sorunun cevap anahtarı.
JSON gösterimi |
---|
{
"answers": [
{
object ( |
Alanlar | |
---|---|
answers[] |
Doğru yanıtların listesi. Test yanıtları, bu yanıtlara göre otomatik olarak notlandırılabilir. Tek değerli sorularda, bu listedeki herhangi bir değerle eşleşen yanıtlar doğru olarak işaretlenir (başka bir deyişle, birden fazla doğru yanıt mümkündür). Birden çok değerli ( |
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 etmesi için birkaç CorrectAnswer
gerekli olabilir.
JSON gösterimi |
---|
{ "value": string } |
Alanlar | |
---|---|
value |
Zorunlu. Doğru yanıt değeri. Çeşitli değer türlerinin nasıl biçimlendirildiği hakkında ayrıntılı bilgi için |
QuestionGroupItem
Bir arada gruplandırılmış birden çok sorudan oluşan bir soru tanımlar.
JSON gösterimi |
---|
{ "questions": [ { object ( |
Alanlar | |
---|---|
questions[] |
Zorunlu. Bu soru grubuna ait soruların listesi. Bir soru yalnızca bir gruba ait olmalıdır. Grubun |
image |
Soru grubunda, belirli soruların üst kısmında gösterilen resim. |
kind alanı. Zorunlu. Hangi soru türlerine izin verileceğini ve bu soruların nasıl gösterileceğini belirleyen soru grubu türü. kind şunlardan yalnızca biri olabilir: |
|
grid |
Soru grubu, aynı seçeneklerin paylaşıldığı çoktan seçmeli soruların yer aldığı bir ızgaradır. |
Tablo
Her satırın ayrı bir soruyu oluşturduğu bir seçenekler tablosu (radyo veya onay kutuları). Her satırda, sütun olarak gösterilen aynı seçenekler bulunur.
JSON gösterimi |
---|
{
"columns": {
object ( |
Alanlar | |
---|---|
columns |
Zorunlu. Tablodaki her bir soru tarafından paylaşılan seçenekler. Başka bir deyişle, sütunların değerleri. Yalnızca |
shuffleQuestions |
|
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 öğe.
JSON gösterimi |
---|
{
"image": {
object ( |
Alanlar | |
---|---|
image |
Zorunlu. Öğede gösterilen resim. |
VideoItem
Video içeren bir öğe.
JSON gösterimi |
---|
{
"video": {
object ( |
Alanlar | |
---|---|
video |
Zorunlu. Öğede gösterilen video. |
caption |
Videonun altında görüntülenen metin. |
Video
Bir videoyu temsil eden veriler.
JSON gösterimi |
---|
{
"youtubeUri": string,
"properties": {
object ( |
Alanlar | |
---|---|
youtubeUri |
Zorunlu. YouTube URI'si. |
properties |
Videonun özellikleri. |
Yöntemler |
|
---|---|
|
Formu birden fazla güncellemeyle değiştirin. |
|
İstekte sağlanan form mesajında verilen başlığı kullanarak yeni bir form oluşturun. |
|
Form alın. |