Class FormResponse

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
FormResponse

Respons terhadap formulir secara keseluruhan. FormResponse dapat digunakan dengan tiga cara: untuk mengakses jawaban yang dikirimkan oleh responden (lihat getItemResponses()), untuk mengirimkan respons ke formulir secara terprogram (lihat withItemResponse(response) dan submit()), dan untuk membuat URL untuk formulir yang sebelumnya mengisi kolom menggunakan jawaban yang diberikan. FormResponse dapat dibuat atau diakses dari Form.

// Open a form by ID and log the responses to each question.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var formResponses = form.getResponses();
for (var i = 0; i < formResponses.length; i++) {
  var formResponse = formResponses[i];
  var itemResponses = formResponse.getItemResponses();
  for (var j = 0; j < itemResponses.length; j++) {
    var itemResponse = itemResponses[j];
    Logger.log('Response #%s to the question "%s" was "%s"',
        (i + 1).toString(),
        itemResponse.getItem().getTitle(),
        itemResponse.getResponse());
  }
}

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getEditResponseUrl()StringMenghasilkan URL yang dapat digunakan untuk mengedit respons yang sudah dikirimkan.
getGradableItemResponses()ItemResponse[]Mendapatkan semua respons item yang terdapat dalam respons formulir, dalam urutan yang sama seperti item yang muncul dalam formulir.
getGradableResponseForItem(item)ItemResponseMendapatkan respons item yang dimuat dalam respons formulir untuk item tertentu.
getId()StringMendapatkan ID respons formulir.
getItemResponses()ItemResponse[]Mendapatkan semua respons item yang terdapat dalam respons formulir, dalam urutan yang sama seperti item yang muncul dalam formulir.
getRespondentEmail()StringMendapatkan alamat email orang yang mengirimkan respons, jika setelan Form.setCollectEmail(collect) diaktifkan.
getResponseForItem(item)ItemResponseMendapatkan respons item yang ada dalam respons formulir ini untuk item tertentu.
getTimestamp()DateMendapatkan stempel waktu untuk pengiriman respons formulir.
submit()FormResponseMengirim respons.
toPrefilledUrl()StringMenghasilkan URL untuk formulir yang jawabannya sudah diisi sebelumnya berdasarkan jawaban dalam respons formulir ini.
withItemGrade(gradedResponse)FormResponseTambahkan nilai respons item yang diberikan ke respons formulir.
withItemResponse(response)FormResponseMenambahkan respons item yang diberikan ke respons formulir.

Dokumentasi mendetail

getEditResponseUrl()

Menghasilkan URL yang dapat digunakan untuk mengedit respons yang sudah dikirimkan. Jika setelan Form.setAllowResponseEdits(enabled) dinonaktifkan, link tersebut akan mengarah ke halaman yang menjelaskan bahwa respons formulir pengeditan dinonaktifkan. Siapa pun yang mengunjungi link tersebut dapat mengedit respons, meskipun mereka memerlukan akun dengan akses ke formulir jika setelan Form.setRequireLogin(requireLogin) diaktifkan. Jika setelan Form.setCollectEmail(collect) diaktifkan, formulir akan mencatat alamat email pengguna yang mengedit respons, bukan alamat email responden asli.

Untuk respons formulir yang telah dibuat oleh skrip, tetapi belum dikirim, metode ini menampilkan null.

Return

String — URL untuk mengubah respons yang dikirimkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getGradableItemResponses()

Mendapatkan semua respons item yang terdapat dalam respons formulir, dalam urutan yang sama seperti item yang muncul dalam formulir. Metode ini berfungsi mirip dengan getItemResponses(), tetapi untuk memungkinkan penilaian jawaban yang tidak ada, metode ini tetap menampilkan ItemResponse jika Item yang sesuai dapat dinilai (yaitu memiliki nilai poin), meskipun tidak ada respons sebenarnya. Namun, jika Item tidak dapat dinilai, metode ini akan mengecualikan item tersebut dari array yang ditampilkan.

Return

ItemResponse[] — array respons untuk setiap item pertanyaan dalam formulir yang respondennya dapat menerima skor.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getGradableResponseForItem(item)

Mendapatkan respons item yang dimuat dalam respons formulir untuk item tertentu. Metode ini bekerja mirip dengan getResponseForItem(item), tetapi untuk memungkinkan penilaian jawaban yang tidak ada, metode ini tetap menampilkan ItemResponse jika Item yang sesuai dapat dinilai (yaitu memiliki nilai poin), meskipun tidak ada respons sebenarnya. Namun, jika Item tidak dapat dinilai, metode ini akan menampilkan null.

Parameter

NameJenisDeskripsi
itemItem

Return

ItemResponse — respons untuk item tertentu, atau null jika tidak ada dan item tersebut tidak dinilai


getId()

Mendapatkan ID respons formulir. Metode ini akan menampilkan null jika respons formulir belum dikirimkan.

Return

String — ID respons formulir, atau null jika respons formulir belum dikirim

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getItemResponses()

Mendapatkan semua respons item yang terdapat dalam respons formulir, dalam urutan yang sama seperti item yang muncul dalam formulir. Jika respons formulir tidak berisi respons untuk TextItem, DateItem, TimeItem, atau ParagraphTextItem tertentu, ItemResponse yang ditampilkan untuk item tersebut akan memiliki string kosong sebagai respons. Jika respons formulir menghilangkan respons untuk jenis item lain, metode ini akan mengecualikan item tersebut dari array yang ditampilkan.

Return

ItemResponse[] — array respons untuk setiap item pertanyaan dalam formulir yang respondennya memberikan jawaban

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getRespondentEmail()

Mendapatkan alamat email orang yang mengirimkan respons, jika setelan Form.setCollectEmail(collect) diaktifkan.

Untuk respons formulir yang telah dibuat oleh skrip, tetapi belum dikirim, metode ini menampilkan null.

Return

String — alamat email orang yang mengirim respons ini, jika tersedia, atau null jika skrip membuat respons ini tetapi belum mengirimkannya

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getResponseForItem(item)

Mendapatkan respons item yang ada dalam respons formulir ini untuk item tertentu.

Parameter

NameJenisDeskripsi
itemItem

Return

ItemResponse — respons untuk item tertentu, atau null jika tidak ada


getTimestamp()

Mendapatkan stempel waktu untuk pengiriman respons formulir.

Untuk respons formulir yang telah dibuat oleh skrip, tetapi belum dikirim, metode ini menampilkan null.

Return

Date — stempel waktu saat respons ini dikirim, atau null jika skrip membuat respons ini tetapi belum mengirimkannya

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

submit()

Mengirim respons. Menampilkan pengecualian skrip jika respons telah dikirimkan.

Return

FormResponse — respons yang baru dibuat yang disimpan ke penyimpanan respons formulir

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

toPrefilledUrl()

Menghasilkan URL untuk formulir yang jawabannya sudah diisi sebelumnya berdasarkan jawaban dalam respons formulir ini.

Return

String — URL untuk formulir dengan jawaban yang sudah diisi sebelumnya

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

withItemGrade(gradedResponse)

Tambahkan nilai respons item yang diberikan ke respons formulir. Metode ini hanya berlaku untuk respons formulir yang telah dikirimkan, dan hanya memengaruhi nilai yang disimpan setelah dikirim. Metode ini juga hanya memperbarui nilai respons item; tidak memengaruhi respons sebenarnya (karena respons sudah dikirim). Jika metode ini dipanggil beberapa kali untuk item yang sama, hanya nilai terakhir yang akan dipertahankan. Jika ItemResponse tidak berisi nilai, metode ini akan menghapus nilai untuk item tersebut.

// Programmatically award partial credit for a given response
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var formResponses = form.getResponses();
var formItems = form.getItems();
for (var i = 0; i < formResponses.length; i++) {
  var formResponse = formResponses[i];
  for (var j = 0; j < formItems.length; j++) {
    var item = formItems[j];
    var points = item.asMultipleChoiceItem().getPoints();
    var itemResponse = formResponse.getGradableResponseForItem(item);
    Logger.log('Award half credit for answers containing the word "Kennedy"');
    var answer = itemResponse.getResponse();
    if (answer != null && answer.includes('Kennedy')) {
      itemResponse.setScore(points / 2);
      formResponse.withItemGrade(itemResponse);
    }
  }
}
form.submitGrades(formResponses);

Parameter

NameJenisDeskripsi
gradedResponseItemResponse

Return

FormResponse — ini FormResponse, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

withItemResponse(response)

Menambahkan respons item yang diberikan ke respons formulir. Metode ini hanya berlaku untuk respons formulir yang telah dibuat skrip tetapi belum dikirim; metode ini tidak dapat memengaruhi respons yang disimpan. Jika metode ini dipanggil beberapa kali untuk item yang sama, hanya respons item terakhir yang akan dipertahankan.

Parameter

NameJenisDeskripsi
responseItemResponse

Return

FormResponse — ini FormResponse, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms