- Referensi: Formulir
- Info
- FormSettings
- QuizSettings
- Item
- QuestionItem
- Pertanyaan
- ChoiceQuestion
- ChoiceType
- Opsi
- GoToAction
- Gambar
- MediaProperties
- Perataan
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- Penilaian
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Petak
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Video
- Metode
Referensi: Formulir
Dokumen Google Formulir. Formulir dibuat di Drive, dan menghapus formulir atau mengubah perlindungan aksesnya dilakukan melalui Drive API.
Representasi JSON |
---|
{ "formId": string, "info": { object ( |
Kolom | |
---|---|
formId |
Hanya output. ID formulir. |
info |
Wajib. Judul dan deskripsi formulir. |
settings |
Setelan formulir. Nama ini harus diperbarui dengan |
items[] |
Wajib. Daftar item formulir, yang dapat mencakup header bagian, pertanyaan, media tersemat, dll. |
revisionId |
Hanya output. ID revisi formulir. Digunakan di Format ID revisi dapat berubah seiring waktu, sehingga harus diperlakukan dengan jelas. ID revisi yang dikembalikan hanya dijamin valid selama 24 jam setelah dikembalikan dan tidak dapat dibagikan kepada pengguna lain. Jika ID revisi tidak berubah di antara panggilan, berarti formulir tidak berubah. Sebaliknya, ID yang diubah (untuk formulir dan pengguna yang sama) biasanya berarti formulir telah diperbarui; tetapi, perubahan ID juga dapat disebabkan oleh faktor internal seperti perubahan format ID. |
responderUri |
Hanya output. URI formulir yang akan dibagikan kepada responden. Tindakan ini akan membuka halaman yang memungkinkan pengguna untuk mengirimkan respons tetapi tidak dapat mengedit pertanyaan. |
linkedSheetId |
Hanya output. ID Spreadsheet Google tertaut yang mengumpulkan respons dari Formulir ini (jika Spreadsheet tersebut ada). |
Info
Informasi umum untuk formulir.
Representasi JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
Kolom | |
---|---|
title |
Wajib. Judul formulir yang dapat dilihat oleh responden. |
documentTitle |
Hanya output. Judul dokumen yang terlihat di Drive. Jika |
description |
Deskripsi formulir. |
FormSettings
Setelan formulir.
Representasi JSON |
---|
{
"quizSettings": {
object ( |
Kolom | |
---|---|
quizSettings |
Setelan yang terkait dengan formulir dan penilaian kuis. |
QuizSettings
Setelan yang terkait dengan formulir dan penilaian kuis. Setelan ini harus diperbarui dengan UpdateSettingsRequest.
Representasi JSON |
---|
{ "isQuiz": boolean } |
Kolom | |
---|---|
isQuiz |
Apakah formulir ini berupa kuis atau bukan. Jika benar, respons akan dinilai berdasarkan pertanyaan |
Item
Satu item dalam formulir. kind
menentukan jenis itemnya.
Representasi JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Kolom | |
---|---|
itemId |
ID item. Saat pembuatan, ID dapat diberikan, tetapi ID ini tidak boleh sudah digunakan dalam formulir. Jika tidak diberikan, ID baru akan ditetapkan. |
title |
Judul item. |
description |
Deskripsi item. |
Kolom union kind . Wajib. Jenis item ini. kind hanya dapat berupa salah satu dari yang berikut: |
|
questionItem |
Mengajukan pertanyaan kepada pengguna. |
questionGroupItem |
Memunculkan satu atau beberapa pertanyaan kepada pengguna dengan satu perintah utama. |
pageBreakItem |
Memulai halaman baru dengan judul. |
textItem |
Menampilkan judul dan deskripsi di halaman. |
imageItem |
Menampilkan gambar di halaman. |
videoItem |
Menampilkan video di halaman. |
QuestionItem
Item formulir yang berisi satu pertanyaan.
Representasi JSON |
---|
{ "question": { object ( |
Kolom | |
---|---|
question |
Wajib. Pertanyaan yang ditampilkan. |
image |
Gambar yang ditampilkan dalam pertanyaan. |
Question
Pertanyaan apa pun. Jenis pertanyaan tertentu diketahui dengan kind
-nya.
Representasi JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Kolom | |
---|---|
questionId |
Hanya baca. ID pertanyaan. Saat pembuatan, ID dapat diberikan, tetapi ID ini tidak boleh sudah digunakan dalam formulir. Jika tidak diberikan, ID baru akan ditetapkan. |
required |
Apakah pertanyaan tersebut harus dijawab agar responden mengirimkan responsnya. |
grading |
Penyiapan penilaian untuk pertanyaan. |
Kolom union kind . Wajib. Jenis pertanyaan yang ditawarkan kepada responden. kind hanya ada berupa salah satu diantara berikut: |
|
choiceQuestion |
Responden dapat memilih dari serangkaian opsi yang telah ditentukan. |
textQuestion |
Responden dapat memasukkan respons teks bebas. |
scaleQuestion |
Responden dapat memilih angka dari rentang. |
dateQuestion |
Responden dapat memasukkan tanggal. |
timeQuestion |
Responden dapat memasukkan waktu. |
fileUploadQuestion |
Responden dapat mengupload satu atau beberapa file. |
rowQuestion |
Baris |
ChoiceQuestion
Pertanyaan radio/kotak centang/{i>dropdown<i}.
Representasi JSON |
---|
{ "type": enum ( |
Kolom | |
---|---|
type |
Wajib. Jenis pertanyaan pilihan. |
options[] |
Wajib. Daftar opsi yang harus dipilih responden. |
shuffle |
Apakah opsi harus ditampilkan dalam urutan acak untuk berbagai instance kuis. Hal ini sering digunakan untuk mencegah kecurangan oleh responden yang mungkin melihat layar responden lain, atau untuk mengatasi bias dalam survei yang mungkin timbul dengan selalu menempatkan opsi yang sama di posisi pertama atau terakhir. |
ChoiceType
Jenis pilihan.
Enum | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Nilai default. Tidak digunakan. |
RADIO |
Tombol pilihan: Semua pilihan ditampilkan kepada pengguna, yang hanya dapat memilih salah satunya. |
CHECKBOX |
Kotak centang: Semua pilihan ditampilkan kepada pengguna, yang dapat memilih berapa pun jumlahnya. |
DROP_DOWN |
Menu drop-down: Pilihan hanya ditampilkan kepada pengguna sesuai permintaan, jika tidak, hanya pilihan saat ini yang akan ditampilkan. Hanya satu opsi yang dapat dipilih. |
Opsi
Opsi untuk pertanyaan Pilihan.
Representasi JSON |
---|
{ "value": string, "image": { object ( |
Kolom | |
---|---|
value |
Wajib. Pilihan seperti yang ditampilkan kepada pengguna. |
image |
Tampilkan gambar sebagai opsi. |
isOther |
Apakah opsi tersebut adalah "lainnya". Saat ini hanya berlaku untuk jenis pilihan |
Kolom union go_to_section . Bagian mana yang akan dibuka jika opsi ini dipilih. Saat ini hanya berlaku untuk jenis pilihan RADIO dan SELECT , tetapi tidak diizinkan di QuestionGroupItem . go_to_section hanya dapat berupa salah satu dari berikut: |
|
goToAction |
Jenis navigasi bagian. |
goToSectionId |
ID item dari header bagian yang akan dibuka. |
GoToAction
Konstanta untuk navigasi bagian.
Enum | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Nilai default. Tidak digunakan. |
NEXT_SECTION |
Buka bagian berikutnya. |
RESTART_FORM |
Kembali ke awal formulir. |
SUBMIT_FORM |
Segera kirim formulir. |
Gambar
Data yang mewakili gambar.
Representasi JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
Kolom | |
---|---|
contentUri |
Hanya output. URI tempat Anda dapat mendownload gambar; ini hanya berlaku untuk waktu terbatas. |
altText |
Deskripsi gambar yang ditampilkan saat kursor diarahkan dan dibaca oleh pembaca layar. |
properties |
Properti gambar. |
Kolom union image_source . Jenis sumber gambar. Hanya satu kolom sumber gambar yang harus ditetapkan saat membuat gambar baru. image_source hanya ada berupa salah satu diantara berikut: |
|
sourceUri |
Hanya input. URI sumber adalah URI yang digunakan untuk menyisipkan gambar. URI sumber dapat kosong saat diambil. |
MediaProperties
Properti media.
Representasi JSON |
---|
{
"alignment": enum ( |
Kolom | |
---|---|
alignment |
Posisi media. |
width |
Lebar media dalam piksel. Saat media ditampilkan, media itu akan diskalakan ke yang lebih kecil dari nilai ini atau lebar bentuk yang ditampilkan. Rasio aspek asli media dipertahankan. Jika lebar tidak ditentukan saat media ditambahkan ke formulir, lebar akan disetel ke lebar sumber media. Lebar harus antara 0 dan 740, inklusif. Menyetel lebar ke 0 atau tidak ditentukan hanya diizinkan saat memperbarui sumber media. |
Perataan
Perataan pada halaman.
Enum | |
---|---|
ALIGNMENT_UNSPECIFIED |
Nilai default. Tidak digunakan. |
LEFT |
Rata kiri. |
RIGHT |
Rata kanan. |
CENTER |
Tengah. |
TextQuestion
Pertanyaan berbasis teks.
Representasi JSON |
---|
{ "paragraph": boolean } |
Kolom | |
---|---|
paragraph |
Apakah pertanyaan tersebut berupa pertanyaan paragraf atau bukan. Jika tidak, pertanyaannya adalah pertanyaan teks singkat. |
ScaleQuestion
Sebuah pertanyaan skala. Pengguna memiliki rentang nilai numerik yang dapat dipilih.
Representasi JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Kolom | |
---|---|
low |
Wajib. Nilai serendah mungkin untuk skala. |
high |
Wajib. Nilai tertinggi yang memungkinkan untuk skala. |
lowLabel |
Label untuk ditampilkan yang menjelaskan titik terendah pada skala. |
highLabel |
Label untuk ditampilkan yang menjelaskan titik tertinggi pada skala. |
DateQuestion
Pertanyaan terkait tanggal. Default pertanyaan tanggal adalah hanya bulan + hari.
Representasi JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Kolom | |
---|---|
includeTime |
Apakah akan menyertakan waktu sebagai bagian dari pertanyaan. |
includeYear |
Apakah akan menyertakan tahun sebagai bagian dari pertanyaan. |
TimeQuestion
Pertanyaan tentang waktu.
Representasi JSON |
---|
{ "duration": boolean } |
Kolom | |
---|---|
duration |
|
FileUploadQuestion
Pertanyaan terkait upload file. API tersebut saat ini tidak mendukung pembuatan pertanyaan upload file.
Representasi JSON |
---|
{
"folderId": string,
"types": [
enum ( |
Kolom | |
---|---|
folderId |
Wajib. ID folder Drive tempat file yang diupload disimpan. |
types[] |
Jenis file yang diterima oleh pertanyaan ini. |
maxFiles |
Jumlah maksimum file yang dapat diupload untuk pertanyaan ini dalam satu respons. |
maxFileSize |
Jumlah maksimum byte yang diizinkan untuk satu file yang diupload ke pertanyaan ini. |
FileType
Jenis file yang dapat diupload ke pertanyaan upload file.
Enum | |
---|---|
FILE_TYPE_UNSPECIFIED |
Nilai default. Tidak digunakan. |
ANY |
Tidak ada batasan pada jenis. |
DOCUMENT |
Dokumen Google Dokumen. |
PRESENTATION |
Presentasi Google Slide. |
SPREADSHEET |
Spreadsheet Google Spreadsheet. |
DRAWING |
Gambar. |
PDF |
PDF. |
IMAGE |
Gambar. |
VIDEO |
Video. |
AUDIO |
File audio. |
RowQuestion
Konfigurasi untuk pertanyaan yang merupakan bagian dari grup pertanyaan.
Representasi JSON |
---|
{ "title": string } |
Kolom | |
---|---|
title |
Wajib. Judul untuk satu baris di |
Penilaian
Penilaian untuk satu pertanyaan
Representasi JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Kolom | |
---|---|
pointValue |
Wajib. Jumlah maksimum poin yang bisa didapatkan responden secara otomatis untuk jawaban yang benar. Nilai ini tidak boleh negatif. |
correctAnswers |
Wajib. Kunci jawaban dari pertanyaan. Respons akan dinilai secara otomatis berdasarkan kolom ini. |
whenRight |
Masukan ditampilkan untuk respons yang benar. Masukan ini hanya dapat ditetapkan untuk pertanyaan pilihan ganda yang memiliki jawaban yang benar. |
whenWrong |
Masukan ditampilkan untuk respons yang salah. Masukan ini hanya dapat ditetapkan untuk pertanyaan pilihan ganda yang memiliki jawaban yang benar. |
generalFeedback |
Masukan yang ditampilkan untuk semua jawaban. Pertanyaan seperti ini biasanya digunakan untuk pertanyaan dengan jawaban singkat ketika pemilik kuis ingin segera memberi responden beberapa pemahaman apakah mereka menjawab pertanyaan dengan benar sebelum diberi kesempatan untuk menilai respons secara resmi. Masukan umum tidak dapat ditetapkan untuk pertanyaan pilihan ganda yang dinilai secara otomatis. |
CorrectAnswers
Kunci jawaban untuk sebuah pertanyaan.
Representasi JSON |
---|
{
"answers": [
{
object ( |
Kolom | |
---|---|
answers[] |
Daftar jawaban yang benar. Respons kuis dapat dinilai secara otomatis berdasarkan jawaban ini. Untuk pertanyaan bernilai tunggal, respons ditandai sebagai benar jika cocok dengan nilai apa pun dalam daftar ini (dengan kata lain, beberapa jawaban yang benar dimungkinkan). Untuk pertanyaan bernilai banyak ( |
CorrectAnswer
Satu jawaban yang benar untuk sebuah pertanyaan. Untuk pertanyaan bernilai banyak (CHECKBOX
), beberapa CorrectAnswer
mungkin diperlukan untuk mewakili satu opsi respons yang benar.
Representasi JSON |
---|
{ "value": string } |
Kolom | |
---|---|
value |
Wajib. Nilai jawaban yang benar. Lihat dokumentasi |
QuestionGroupItem
Mendefinisikan pertanyaan yang terdiri dari beberapa pertanyaan yang dikelompokkan bersama.
Representasi JSON |
---|
{ "questions": [ { object ( |
Kolom | |
---|---|
questions[] |
Wajib. Daftar pertanyaan yang termasuk dalam grup pertanyaan ini. Pertanyaan hanya boleh dimiliki satu grup. |
image |
Gambar yang ditampilkan dalam grup pertanyaan di atas pertanyaan tertentu. |
Kolom union kind . Wajib. Jenis grup pertanyaan, yang menentukan jenis pertanyaan yang diizinkan dan bagaimana pertanyaan ditampilkan. kind hanya ada berupa salah satu diantara berikut: |
|
grid |
Grup pertanyaan adalah petak dengan baris pertanyaan pilihan ganda yang memiliki opsi yang sama. Jika |
Kisi
Petak pilihan (kotak radio atau centang) dengan setiap baris merupakan pertanyaan terpisah. Setiap baris memiliki pilihan yang sama, yang ditampilkan sebagai kolom.
Representasi JSON |
---|
{
"columns": {
object ( |
Kolom | |
---|---|
columns |
Wajib. Pilihan yang dibagikan oleh setiap pertanyaan dalam petak. Dengan kata lain, nilai pada kolom. Hanya pilihan |
shuffleQuestions |
Jika |
PageBreakItem
Batas halaman. Judul dan deskripsi item ini ditampilkan di bagian atas halaman baru.
TextItem
Item teks.
ImageItem
Item yang berisi gambar.
Representasi JSON |
---|
{
"image": {
object ( |
Kolom | |
---|---|
image |
Wajib. Gambar yang ditampilkan dalam item. |
VideoItem
Item yang berisi video.
Representasi JSON |
---|
{
"video": {
object ( |
Kolom | |
---|---|
video |
Wajib. Video yang ditampilkan dalam item. |
caption |
Teks yang ditampilkan di bawah video. |
Video
Data yang mewakili video.
Representasi JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
Kolom | |
---|---|
youtubeUri |
Wajib. URI YouTube. |
properties |
Properti video. |
Metode |
|
---|---|
|
Ubah formulir dengan batch pembaruan. |
|
Buat formulir baru menggunakan judul yang diberikan dalam pesan formulir yang disediakan dalam permintaan. |
|
Dapatkan formulir. |