- Kaynak: Form
- Bilgi
- FormSettings
- QuizSettings
- EmailCollectionType
- Öğe
- QuestionItem
- Soru
- ChoiceQuestion
- ChoiceType
- Seçenek
- GoToAction
- Resim
- MediaProperties
- Hizalamayı
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- RatingQuestion
- RatingIconType
- Notlandırma
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Izgara
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Video
- PublishSettings
- PublishState
- Yöntemler
Kaynak: Form
Google Formlar dokümanı. Formlar Drive'da oluşturulur ve formların silinmesi ya da erişim korumalarının değiştirilmesi 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 değer |
items[] |
Zorunlu. Bölüm başlıkları, sorular, yerleştirilmiş medya vb. öğelerin yer aldığı form öğelerinin listesi. |
revisionId |
Yalnızca çıkış. Formun düzeltme kimliği. Değişikliklerin temel aldığı düzeltmeyi tanımlamak için güncelleme isteklerinde Düzeltme kimliğinin biçimi zaman içinde değişebileceğinden, bu kimlik opak olarak ele alınmalıdır. İade edilen düzeltme kimliğinin yalnızca iade edildikten sonraki 24 saat boyunca geçerli olacağı garanti edilir ve kullanıcılar arasında paylaşılamaz. Düzeltme kimliği, çağrılar arasında değişmediyse content formu değişmemiştir. Buna karşılık, aynı form ve kullanıcı için değişen bir kimlik genellikle form içeriğinin güncellendiği anlamına gelir. Ancak kimlik biçimi değişiklikleri gibi dahili faktörler de kimliğin değişmesine neden olabilir. Form içeriği, aşağıdakiler dahil form meta verilerini hariç tutar:
|
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 formdan yanıt toplayan bağlı Google E-Tablosunun kimliği (varsa). |
publishSettings |
Yalnızca çıkış. Bir formun yayınlama ayarları.
|
Bilgi
Formla ilgili genel bilgiler.
JSON gösterimi |
---|
{ "title": string, "documentTitle": string, "description": string } |
Alanlar | |
---|---|
title |
Zorunlu. Katılımcılara gösterilen form başlığı. |
documentTitle |
Yalnızca çıkış. Drive'da görünen dokümanın başlığı. |
description |
Formun açıklaması. |
FormSettings
Form ayarları.
JSON gösterimi |
---|
{ "quizSettings": { object ( |
Alanlar | |
---|---|
quizSettings |
Test formları ve notlandırma ile ilgili ayarlar. |
emailCollectionType |
İsteğe bağlı. Formun katılımcılardan e-posta adresi toplayıp toplamayacağını belirleyen ayar. |
QuizSettings
Test formları ve notlandırmayla ilgili ayarlar. Bunlar UpdateSettingsRequest ile güncellenmelidir.
JSON gösterimi |
---|
{ "isQuiz": boolean } |
Alanlar | |
---|---|
isQuiz |
Bu formun test olup olmadığı. Doğru olduğunda yanıtlar |
EmailCollectionType
İsteğe bağlı. Formun katılımcılardan e-posta adresi toplayıp toplamayacağını ve e-posta adreslerinin nasıl toplanacağını belirleyen ayar. Formda e-posta adresleri toplanıyorsa değerler formResponse.respondentEmail
alanına doldurulur.
Sıralamalar | |
---|---|
EMAIL_COLLECTION_TYPE_UNSPECIFIED |
Belirtilmedi. Bu değer kullanılmamaktadır. |
DO_NOT_COLLECT |
Form, e-posta adreslerini toplamıyor. Form sahibi bir Google Hesabı kullanıyorsa varsayılan değer. |
VERIFIED |
Form, oturum açmış kullanıcının hesabına göre e-posta adreslerini otomatik olarak toplar. Form sahibi bir Google Workspace hesabı kullanıyorsa varsayılan değer. |
RESPONDER_INPUT |
Form, katılımcının formda doldurduğu bir alanı kullanarak e-posta adreslerini toplar. |
Öğe
Formun tek bir öğesi. kind
, öğenin türünü tanımlar.
JSON gösterimi |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Alanlar | |
---|---|
itemId |
Öğe kimliği. Oluşturulma sırasında sağlanabilir ancak kimlik formda zaten kullanılmamalıdır. Sağlanmazsa yeni bir kimlik atanır. |
title |
Öğenin başlığı. |
description |
Öğenin açıklaması. |
Birlik alanı kind . Zorunlu. Öğenin türü. kind yalnızca aşağıdakilerden biri olabilir: |
|
questionItem |
Kullanıcıya soru sorar. |
questionGroupItem |
Tek bir ana istemle kullanıcıya bir veya daha fazla soru sorar. |
pageBreakItem |
Başlık içeren yeni bir sayfa başlatır. |
textItem |
Sayfada bir başlık ve açıklama gösterilir. |
imageItem |
Sayfada bir resim gösterir. |
videoItem |
Sayfada bir video gösterilir. |
QuestionItem
Tek bir soru içeren bir form öğesi.
JSON gösterimi |
---|
{ "question": { object ( |
Alanlar | |
---|---|
question |
Zorunlu. Gösterilen soru. |
image |
Sorunun içinde gösterilen resim. |
Soru
Sorularınız varsa Soru türü, kind
ile bilinir.
JSON gösterimi |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Alanlar | |
---|---|
questionId |
Salt okunur. Soru kimliği. Oluşturulma sırasında sağlanabilir ancak kimlik formda zaten kullanılmamalıdır. Sağlanmazsa yeni bir kimlik atanır. |
required |
Katılımcıların yanıtlarını gönderebilmesi için sorunun yanıtlanması gerekip gerekmediği. |
grading |
Sorunun notlandırma ayarları. |
Birlik alanı kind . Zorunlu. Katılımcılara sunulan soru türü. kind yalnızca aşağıdakilerden biri olabilir: |
|
choiceQuestion |
Katılımcılar önceden tanımlanmış seçenekler arasından seçim yapabilir. |
textQuestion |
Katılımcılar, serbest metin yanıtı girebilir. |
scaleQuestion |
Katılımcılar bir aralıktaki bir sayıyı seçebilir. |
dateQuestion |
Katılımcılar tarih girebilir. |
timeQuestion |
Katılımcılar bir saat girebilir. |
fileUploadQuestion |
Katılımcılar bir veya daha fazla dosya yükleyebilir. |
rowQuestion |
Bir |
ratingQuestion |
Katılımcılar, önceden tanımlanmış bir simge grubundan derecelendirme seçebilir. |
ChoiceQuestion
Radyo düğmesi/onay kutusu/açılır liste sorusu.
JSON gösterimi |
---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Zorunlu. Seçmeli sorunun türü. |
options[] |
Zorunlu. Katılımcının aralarından seçim yapması gereken seçeneklerin listesi. |
shuffle |
Seçeneklerin, testin farklı örnekleri için rastgele sırada gösterilip gösterilmeyeceği. Bu yöntem, genellikle başka bir katılımcının ekranına bakabilecek katılımcıların hile yapmasını önlemek veya her zaman aynı seçenekleri ilk ya da sona ekleyerek ankete girilebilecek önyargıları gidermek için kullanılır. |
ChoiceType
Seçimin türü.
Sıralamalar | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Varsayılan değer. Kullanılmamış. |
RADIO |
Radyo düğmeleri: Tüm seçenekler kullanıcıya gösterilir ve kullanıcı bunlardan yalnızca birini seçebilir. |
CHECKBOX |
Onay kutuları: Tüm seçenekler kullanıcıya gösterilir ve kullanıcı bunlardan istediğini seçebilir. |
DROP_DOWN |
Açılır menü: Seçenekler kullanıcıya yalnızca talep üzerine gösterilir. Aksi takdirde yalnızca geçerli seçenek gösterilir. Yalnızca bir seçenek seçilebilir. |
Option
Seçim sorusuna yönelik bir seçenek.
JSON gösterimi |
---|
{ "value": string, "image": { object ( |
Alanlar | |
---|---|
value |
Zorunlu. Kullanıcıya sunulan seçenek. |
image |
Resmi seçenek olarak gösterin. |
isOther |
Seçeneğin "diğer" olup olmadığı. Şu anda yalnızca |
Birlik alanı go_to_section . Bu seçenek belirlenirse hangi bölüme gidileceği. Şu anda yalnızca RADIO ve SELECT seçim türü için geçerlidir ancak QuestionGroupItem için izin verilmez. go_to_section yalnızca aşağıdakilerden biri olabilir: |
|
goToAction |
Bölüm gezinme türü. |
goToSectionId |
Gitilecek bölüm başlığının öğe kimliği. |
GoToAction
Bölüm 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 URI. Bu URI yalnızca sınırlı bir süre için geçerlidir. |
altText |
Fareyle üzerine gelindiğinde gösterilen ve ekran okuyucular tarafından okunan resmin açıklaması. |
properties |
Bir resmin özellikleri. |
Birlik alanı image_source . Resim kaynağının türü. Yeni resimler oluştururken tam olarak bir resim kaynağı alanı ayarlanmalıdır. image_source yalnızca aşağıdakilerden biri olabilir: |
|
sourceUri |
Yalnızca giriş. Kaynak URI, resmi eklemek için kullanılan URI'dir. Kaynak URI'si 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österilirken bu değer veya görüntülenen formun genişliği arasından en küçük değere göre ölçeklendirilir. Medyanın orijinal en boy oranı korunur. Medya forma eklenirken genişlik belirtilmezse genişlik, medya kaynağının genişliğine ayarlanır. Genişlik 0 ile 740 arasında (bu değerler dahil) olmalıdır. Genişliğin 0 veya belirsiz olarak ayarlanmasına yalnızca medya kaynağı güncellenirken izin verilir. |
Uyum
Sayfadaki 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ığı. Aksi takdirde soru kısa metin sorusudur. |
ScaleQuestion
Derecelendirme sorusu. Kullanıcının aralarından seçim yapabileceği bir dizi sayısal değer vardır.
JSON gösterimi |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Alanlar | |
---|---|
low |
Zorunlu. Ölçek için mümkün olan en düşük değer. |
high |
Zorunlu. Ölçek için mümkün olan en yüksek değer. |
lowLabel |
Ölçekteki en düşük noktayı açıklayan etiket. |
highLabel |
Ölçekteki en yüksek noktayı açıklayan etiket. |
DateQuestion
Tarih sorusu. Tarih soruları varsayılan olarak yalnızca ay ve gün olarak ayarlanır.
JSON gösterimi |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Alanlar | |
---|---|
includeTime |
Saatin soruya dahil edilip edilmeyeceği. |
includeYear |
Yılın soruya dahil edilip edilmeyeceği. |
TimeQuestion
Zamanla ilgili bir soru.
JSON gösterimi |
---|
{ "duration": boolean } |
Alanlar | |
---|---|
duration |
|
FileUploadQuestion
Dosya yükleme sorusu. API şu anda dosya yükleme soruları oluşturmayı desteklemiyor.
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 tek bir 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 yoktur. |
DOCUMENT |
Google Dokümanlar dokümanı. |
PRESENTATION |
Google Slaytlar sunusu. |
SPREADSHEET |
Google E-Tablolar e-tablosu. |
DRAWING |
Bir çizim. |
PDF |
PDF. |
IMAGE |
Resim. |
VIDEO |
Video. |
AUDIO |
Ses dosyası. |
RowQuestion
Soru grubunun parçası olan bir sorunun yapılandırması.
JSON gösterimi |
---|
{ "title": string } |
Alanlar | |
---|---|
title |
Zorunlu. |
RatingQuestion
Derecelendirme sorusu. Kullanıcının aralarından seçim yapabileceği çeşitli simgeler vardır.
JSON gösterimi |
---|
{
"ratingScaleLevel": integer,
"iconType": enum ( |
Alanlar | |
---|---|
ratingScaleLevel |
Zorunlu. Derecelendirme sorusunun puan ölçeği seviyesi. |
iconType |
Zorunlu. Derecelendirme için kullanılacak simge türü. |
RatingIconType
Derecelendirme için kullanılacak simgenin türü.
Sıralamalar | |
---|---|
RATING_ICON_TYPE_UNSPECIFIED |
Varsayılan değer. Kullanılmamış. |
STAR |
Yıldız simgesi. |
HEART |
Kalp simgesi. |
THUMB_UP |
Beğenmeme simgesi. |
Not verme
Tek bir soru için 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 sayısı. Bu değer 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ıtları 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ıtları sağlanmış çoktan seçmeli sorular için ayarlanabilir. |
generalFeedback |
Tüm yanıtlar için gösterilen geri bildirim. Bu özellik, genellikle kısa yanıtlı sorularda kullanılır. Bu sayede, test sahibi, yanıtı resmi olarak notlandırmadan önce katılımcılara soruyu doğru yanıtlayıp yanıtlamadıklarını hızlıca bildirebilir. Otomatik olarak notlandırılan ç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 (yani birden fazla doğru yanıt olabilir). Birden çok değerli ( |
CorrectAnswer
Bir soru için tek bir doğru yanıt. Birden fazla değere sahip (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 |
Zorunlu. Doğru yanıt değeri. Çeşitli değer türlerinin nasıl biçimlendirildiğiyle ilgili ayrıntılar için |
QuestionGroupItem
Birlikte gruplandırılmış birden fazla 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 üzerinde gösterilen resim. |
Birlik alanı kind . Zorunlu. Hangi soru türlerine izin verileceğini ve bunların nasıl gösterileceğini belirleyen soru grubu türü. kind yalnızca aşağıdakilerden biri olabilir: |
|
grid |
Soru grubu, aynı seçenekleri paylaşan çoktan seçmeli soru satırlarının bulunduğu bir ızgaradır. |
Izgara
Her satırın ayrı bir soru oluşturduğu bir seçenek ızgarası (radyo düğmeleri 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 soru tarafından paylaşılan seçenekler. Diğer bir deyişle, sütunların değerleri. Yalnızca |
shuffleQuestions |
|
PageBreakItem
Bu türde alan yoktur.
Sayfa sonu. Bu öğenin başlığı ve açıklaması yeni sayfanın üst kısmında gösterilir.
TextItem
Bu türde alan yoktur.
Metin öğesi.
ImageItem
Resim içeren bir öğ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. |
PublishSettings
Bir formun yayınlama ayarları.
JSON gösterimi |
---|
{
"publishState": {
object ( |
Alanlar | |
---|---|
publishState |
İsteğe bağlı. Formun yayınlanma durumu.
|
PublishState
Formun yayınlanma durumu.
JSON gösterimi |
---|
{ "isPublished": boolean, "isAcceptingResponses": boolean } |
Alanlar | |
---|---|
isPublished |
Zorunlu. Formun yayınlanıp yayınlanmadığı ve diğer kullanıcılar tarafından görülebildiği. |
isAcceptingResponses |
Zorunlu. Formun yanıt kabul edip etmediği. |
Yöntemler |
|
---|---|
|
Formu bir grup güncellemeyle değiştirin. |
|
İstekte sağlanan form mesajında verilen başlığı kullanarak yeni bir form oluşturun. |
|
Form alın. |
|
Bir formun yayınlama ayarlarını günceller. |