REST Resource: forms

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

string

Hanya output. ID formulir.

object (Info)

Wajib diisi. Judul dan deskripsi formulir.

object (FormSettings)

Setelan formulir. Opsi ini harus diperbarui dengan UpdateSettingsRequest; elemen ini akan diabaikan selama forms.create dan UpdateFormInfoRequest.

object (Item)

Wajib diisi. Daftar item formulir, yang dapat mencakup header bagian, pertanyaan, media tersemat, dll.

string

Hanya output. ID revisi formulir. Digunakan dalam WriteControl dalam permintaan update untuk mengidentifikasi revisi yang menjadi dasar perubahan.

Format ID revisi dapat berubah dari waktu ke waktu, sehingga harus ditangani secara tidak transparan. ID revisi yang dikembalikan hanya dijamin valid selama 24 jam setelah ID tersebut dikembalikan dan tidak dapat dibagikan ke pengguna lain. Jika ID revisi tidak berubah di antara panggilan, formulir tidak berubah. Sebaliknya, ID yang berubah (untuk formulir dan pengguna yang sama) biasanya berarti formulir telah diperbarui; namun, perubahan ID juga dapat disebabkan oleh faktor internal seperti perubahan format ID.

string

Hanya output. URI formulir yang akan dibagikan kepada responden. Tindakan ini akan membuka halaman yang memungkinkan pengguna mengirimkan respons tetapi tidak mengedit pertanyaan.

string

Hanya output. ID Google Spreadsheet tertaut yang mengumpulkan respons dari Formulir ini (jika Spreadsheet tersebut ada).

{
  "title": string,
  "documentTitle": string,
  "description": string
}

string

Wajib diisi. Judul formulir yang dapat dilihat oleh responden.

string

Hanya output. Judul dokumen yang terlihat di Drive. Jika Info.title kosong, documentTitle dapat muncul sebagai penggantinya di UI Google Formulir dan dapat dilihat oleh responden. documentTitle dapat ditetapkan saat pembuatan, tetapi tidak dapat diubah oleh permintaan Removed. Gunakan Google Drive API jika Anda perlu mengupdate documentTitle secara terprogram.

string

Deskripsi formulir.

{
  "quizSettings": {
    object (QuizSettings)
  }
}

object (QuizSettings)

Setelan yang terkait dengan formulir dan penilaian kuis.

{
  "isQuiz": boolean
}

boolean

Apakah formulir ini berupa kuis atau bukan. Jika benar, respons akan dinilai berdasarkan pertanyaan Grading. Setelah disetel ke salah (false), semua pertanyaan Grading akan dihapus.

{
  "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.
}

string

ID item.

Saat pembuatan, ID ini dapat diberikan, tetapi ID belum boleh digunakan dalam formulir. Jika tidak diberikan, ID baru akan ditetapkan.

string

Judul item.

string

Deskripsi item.

object (QuestionItem)

Mengajukan pertanyaan kepada pengguna.

object (QuestionGroupItem)

Mengajukan satu atau beberapa pertanyaan kepada pengguna dengan satu perintah utama.

object (PageBreakItem)

Memulai halaman baru dengan judul.

object (TextItem)

Menampilkan judul dan deskripsi pada halaman.

object (ImageItem)

Menampilkan gambar di halaman.

object (VideoItem)

Menampilkan video di halaman.

{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}

object (Question)

Wajib diisi. Pertanyaan yang ditampilkan.

object (Image)

Gambar yang ditampilkan dalam pertanyaan.

{
  "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.
}

string

Hanya baca. ID pertanyaan.

Saat pembuatan, ID ini dapat diberikan, tetapi ID belum boleh digunakan dalam formulir. Jika tidak diberikan, ID baru akan ditetapkan.

boolean

Apakah pertanyaan harus dijawab agar responden mengirimkan responsnya.

object (Grading)

Konfigurasi penilaian untuk pertanyaan.

object (ChoiceQuestion)

Responden dapat memilih dari rangkaian opsi yang telah ditetapkan.

object (TextQuestion)

Responden dapat memasukkan respons teks bebas.

object (ScaleQuestion)

Responden dapat memilih angka dari rentang.

object (DateQuestion)

Responden dapat memasukkan tanggal.

object (TimeQuestion)

Responden dapat memasukkan waktu.

object (FileUploadQuestion)

Responden dapat mengupload satu atau beberapa file.

object (RowQuestion)

Baris QuestionGroupItem.

{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}

enum (ChoiceType)

Wajib diisi. Jenis pertanyaan pilihan.

object (Option)

Wajib diisi. Daftar opsi yang harus dipilih oleh responden.

boolean

Apakah opsi harus ditampilkan dalam urutan acak untuk berbagai contoh kuis. Hal ini sering digunakan untuk mencegah kecurangan oleh responden yang mungkin melihat layar responden lain, atau untuk mengatasi bias dalam survei yang mungkin muncul dengan selalu menempatkan opsi yang sama di urutan pertama atau terakhir.

{
  "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.
}

string

Wajib diisi. Pilihan seperti yang ditampilkan kepada pengguna.

object (Image)

Menampilkan gambar sebagai opsi.

boolean

Apakah opsinya "lainnya". Saat ini hanya berlaku untuk jenis pilihan RADIO dan CHECKBOX, tetapi tidak diizinkan di QuestionGroupItem.

enum (GoToAction)

Jenis navigasi bagian.

string

ID item dari header bagian yang akan dibuka.

{
  "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.
}

string

Hanya output. URI tempat Anda dapat mendownload gambar; ini hanya berlaku dalam waktu terbatas.

string

Deskripsi gambar yang ditampilkan saat kursor diarahkan ke atasnya dan dibaca oleh pembaca layar.

object (MediaProperties)

Properti gambar.

string

Input saja. URI sumber adalah URI yang digunakan untuk menyisipkan gambar. URI sumber boleh kosong saat diambil.

{
  "alignment": enum (Alignment),
  "width": integer
}

enum (Alignment)

Posisi media.

integer

Lebar media dalam piksel. Saat media ditampilkan, media akan diskalakan ke 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 mengupdate sumber media.

{
  "paragraph": boolean
}

boolean

Apakah pertanyaan tersebut berupa pertanyaan paragraf atau bukan. Jika tidak, pertanyaannya adalah pertanyaan teks singkat.

{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}

integer

Wajib diisi. Nilai serendah mungkin untuk timbangan.

integer

Wajib diisi. Nilai tertinggi untuk timbangan.

string

Label yang ditampilkan yang menjelaskan titik terendah pada skala.

string

Label yang akan ditampilkan, yang mendeskripsikan titik tertinggi pada skala.

{
  "includeTime": boolean,
  "includeYear": boolean
}

boolean

Apakah akan memasukkan waktu sebagai bagian dari pertanyaan.

boolean

Apakah akan menyertakan tahun sebagai bagian dari pertanyaan.

{
  "duration": boolean
}

boolean

true jika pertanyaannya tentang waktu berlalu. Jika tidak, ini tentang waktu dalam sehari.

{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}

string

Wajib diisi. ID folder Drive tempat file yang diupload disimpan.

enum (FileType)

Jenis file yang disetujui oleh pertanyaan ini.

integer

Jumlah maksimum file yang dapat diupload untuk pertanyaan ini dalam satu respons.

string (int64 format)

Jumlah byte maksimum yang diizinkan untuk setiap file yang diupload ke pertanyaan ini.

{
  "title": string
}

string

Wajib diisi. Judul untuk satu baris di QuestionGroupItem.

{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}

integer

Wajib diisi. Jumlah maksimum poin yang dapat diperoleh secara otomatis oleh responden untuk jawaban yang benar. Nilai ini tidak boleh negatif.

object (CorrectAnswers)

Wajib diisi. Kunci jawaban untuk pertanyaan. Jawaban akan dinilai secara otomatis berdasarkan kolom ini.

object (Feedback)

Masukan ditampilkan untuk respons yang benar. Masukan ini hanya dapat ditetapkan untuk pertanyaan pilihan ganda yang memiliki jawaban benar.

object (Feedback)

Masukan ditampilkan untuk respons yang salah. Masukan ini hanya dapat ditetapkan untuk pertanyaan pilihan ganda yang memiliki jawaban benar.

object (Feedback)

Masukan ditampilkan untuk semua jawaban. Pertanyaan ini biasanya digunakan untuk pertanyaan jawaban singkat ketika pemilik kuis ingin segera memberikan gambaran kepada responden tentang apakah mereka menjawab pertanyaan dengan benar sebelum mereka memiliki kesempatan untuk menilai respons secara resmi. Masukan umum tidak dapat ditetapkan untuk pertanyaan pilihan ganda yang dinilai secara otomatis.

{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}

object (CorrectAnswer)

Daftar jawaban yang benar. Respons kuis dapat dinilai secara otomatis berdasarkan jawaban tersebut. Untuk pertanyaan bernilai tunggal, respons ditandai sebagai benar jika cocok dengan nilai apa pun dalam daftar ini (dengan kata lain, beberapa jawaban benar juga dapat diajukan). Untuk pertanyaan yang bernilai ganda (CHECKBOX), respons ditandai sebagai benar jika berisi nilai yang ada dalam daftar ini.

{
  "value": string
}

string

Wajib diisi. Nilai jawaban yang benar. Lihat dokumentasi TextAnswer.value untuk mengetahui detail tentang pemformatan berbagai jenis nilai.

{
  "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.
}

object (Question)

Wajib diisi. Daftar pertanyaan yang termasuk dalam grup pertanyaan ini. Sebuah pertanyaan hanya boleh dimiliki oleh satu kelompok. kind grup dapat memengaruhi jenis pertanyaan apa yang diizinkan.

object (Image)

Gambar yang ditampilkan dalam grup pertanyaan di atas pertanyaan tertentu.

object (Grid)

Grup pertanyaan adalah petak dengan baris pertanyaan pilihan ganda yang memiliki opsi yang sama. Jika grid ditetapkan, semua pertanyaan di grup harus berjenis row.

{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}

object (ChoiceQuestion)

Wajib diisi. Pilihan yang dibagikan oleh setiap pertanyaan di petak. Dengan kata lain, nilai-nilai kolom. Hanya CHECK_BOX dan RADIO pilihan yang diizinkan.

boolean

Jika true, pertanyaan akan diurutkan secara acak. Dengan kata lain, baris akan muncul dalam urutan yang berbeda untuk setiap responden.

{
  "image": {
    object (Image)
  }
}

object (Image)

Wajib diisi. Gambar yang ditampilkan di item.

{
  "video": {
    object (Video)
  },
  "caption": string
}

object (Video)

Wajib diisi. Video yang ditampilkan di item.

string

Teks yang ditampilkan di bawah video.

{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}

string

Wajib diisi. URI YouTube.

object (MediaProperties)

Properti video.