Class Form

Formulir

Formulir yang berisi properti dan item secara keseluruhan. Properti mencakup judul, setelan, dan tempat respons disimpan. Item mencakup item pertanyaan seperti kotak centang atau item pilihan, sedangkan item tata letak merujuk pada hal-hal seperti jeda halaman. Formulir dapat diakses atau dibuat dari FormApp.

// Open a form by ID and create a new spreadsheet.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const ss = SpreadsheetApp.create('Spreadsheet Name');

// Update form properties via chaining.
form.setTitle('Form Name')
    .setDescription('Description of form')
    .setConfirmationMessage('Thanks for responding!')
    .setAllowResponseEdits(true)
    .setAcceptingResponses(false);

// Update the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
addCheckboxGridItem()	CheckboxGridItem	Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih beberapa pilihan per baris dari urutan kotak centang.
addCheckboxItem()	CheckboxItem	Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu atau beberapa kotak centang, serta kolom "lainnya" opsional.
addDateItem()	DateItem	Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal.
addDateTimeItem()	DateTimeItem	Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal dan waktu.
addDurationItem()	DurationItem	Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan durasi waktu.
addEditor(emailAddress)	Form	Menambahkan pengguna tertentu ke daftar editor untuk Form.
addEditor(user)	Form	Menambahkan pengguna tertentu ke daftar editor untuk Form.
addEditors(emailAddresses)	Form	Menambahkan array pengguna yang diberikan ke daftar editor untuk Form.
addGridItem()	GridItem	Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih satu pilihan per baris dari urutan tombol pilihan.
addImageItem()	ImageItem	Menambahkan item tata letak baru yang menampilkan gambar.
addListItem()	ListItem	Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar drop-down.
addMultipleChoiceItem()	MultipleChoiceItem	Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar tombol radio atau kolom "lainnya" opsional.
addPageBreakItem()	PageBreakItem	Menambahkan item tata letak baru yang menandai awal halaman.
addParagraphTextItem()	ParagraphTextItem	Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan blok teks.
addScaleItem()	ScaleItem	Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu opsi dari urutan tombol pilihan bernomor.
addSectionHeaderItem()	SectionHeaderItem	Menambahkan item tata letak baru yang secara visual menunjukkan awal bagian.
addTextItem()	TextItem	Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan satu baris teks.
addTimeItem()	TimeItem	Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan waktu.
addVideoItem()	VideoItem	Menambahkan item tata letak baru yang menampilkan video.
canEditResponse()	Boolean	Menentukan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya.
collectsEmail()	Boolean	Menentukan apakah formulir mengumpulkan alamat email responden.
createResponse()	FormResponse	Membuat respons baru ke formulir.
deleteAllResponses()	Form	Menghapus semua respons yang dikirimkan dari penyimpanan respons formulir.
deleteItem(index)	void	Menghapus item pada indeks tertentu di antara semua item dalam formulir.
deleteItem(item)	void	Menghapus item yang diberikan.
deleteResponse(responseId)	Form	Menghapus satu respons dari penyimpanan respons formulir.
getConfirmationMessage()	String	Mendapatkan pesan konfirmasi formulir.
getCustomClosedFormMessage()	String	Mendapatkan pesan kustom yang ditampilkan jika formulir tidak menerima respons, atau string kosong jika tidak ada pesan kustom yang ditetapkan.
getDescription()	String	Mendapatkan deskripsi formulir.
getDestinationId()	String	Mendapatkan ID tujuan respons formulir.
getDestinationType()	DestinationType	Mendapatkan jenis tujuan respons formulir.
getEditUrl()	String	Mendapatkan URL yang dapat digunakan untuk mengakses mode edit formulir.
getEditors()	User[]	Mendapatkan daftar editor untuk Form ini.
getId()	String	Mendapatkan ID formulir.
getItemById(id)	Item	Mendapatkan item dengan ID yang diberikan.
getItems()	Item[]	Mendapatkan array semua item dalam formulir.
getItems(itemType)	Item[]	Mendapatkan array dari semua item dari jenis tertentu.
getPublishedUrl()	String	Mendapatkan URL yang dapat digunakan untuk merespons formulir.
getResponse(responseId)	FormResponse	Mendapatkan satu respons formulir berdasarkan ID responsnya.
getResponses()	FormResponse[]	Mendapatkan array dari semua respons formulir.
getResponses(timestamp)	FormResponse[]	Mendapatkan array dari semua respons formulir setelah tanggal dan waktu tertentu.
getShuffleQuestions()	Boolean	Menentukan apakah urutan pertanyaan di setiap halaman formulir diacak.
getSummaryUrl()	String	Mendapatkan URL yang dapat digunakan untuk melihat ringkasan respons formulir.
getTitle()	String	Mendapatkan judul formulir.
hasLimitOneResponsePerUser()	Boolean	Menentukan apakah formulir hanya mengizinkan satu respons per responden.
hasProgressBar()	Boolean	Menentukan apakah formulir menampilkan status progres.
hasRespondAgainLink()	Boolean	Menentukan apakah formulir akan menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir.
isAcceptingResponses()	Boolean	Menentukan apakah formulir saat ini menerima respons.
isPublishingSummary()	Boolean	Menentukan apakah formulir akan menampilkan link untuk melihat ringkasan respons setelah responden menyelesaikan formulir.
isQuiz()	Boolean	Menentukan apakah formulir adalah kuis.
moveItem(from, to)	Item	Memindahkan item pada indeks tertentu di antara semua item dalam formulir ke indeks lain yang ditentukan.
moveItem(item, toIndex)	Item	Memindahkan item tertentu ke indeks tertentu di antara semua item dalam formulir.
removeDestination()	Form	Membatalkan tautan formulir dari tujuan respons saat ini.
removeEditor(emailAddress)	Form	Menghapus pengguna tertentu dari daftar editor untuk Form.
removeEditor(user)	Form	Menghapus pengguna tertentu dari daftar editor untuk Form.
setAcceptingResponses(enabled)	Form	Menetapkan apakah formulir saat ini menerima respons.
setAllowResponseEdits(enabled)	Form	Menetapkan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya.
setCollectEmail(collect)	Form	Menetapkan apakah formulir akan mengumpulkan alamat email responden.
setConfirmationMessage(message)	Form	Menetapkan pesan konfirmasi formulir.
setCustomClosedFormMessage(message)	Form	Menetapkan pesan yang akan ditampilkan jika formulir tidak menerima respons.
setDescription(description)	Form	Menetapkan deskripsi formulir.
setDestination(type, id)	Form	Menetapkan tujuan tempat respons formulir disimpan.
setIsQuiz(enabled)	Form	Menetapkan apakah formulir adalah kuis.
setLimitOneResponsePerUser(enabled)	Form	Menetapkan apakah formulir hanya mengizinkan satu respons per responden.
setProgressBar(enabled)	Form	Menetapkan apakah formulir memiliki status progres.
setPublishingSummary(enabled)	Form	Menetapkan apakah formulir akan menampilkan link untuk melihat ringkasan respons setelah responden mengirimkan formulir.
setShowLinkToRespondAgain(enabled)	Form	Menetapkan apakah formulir akan menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir.
setShuffleQuestions(shuffle)	Form	Menetapkan apakah urutan pertanyaan di setiap halaman formulir diacak.
setTitle(title)	Form	Menetapkan judul formulir.
shortenFormUrl(url)	String	Mengonversi URL panjang untuk formulir menjadi URL singkat.
submitGrades(responses)	Form	Mengirimkan nilai untuk FormResponses yang diberikan.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
requiresLogin()	Boolean	Menentukan apakah formulir mengharuskan responden untuk login ke akun di domain atau subdomain yang sama sebelum merespons.
setRequireLogin(requireLogin)	Form	Menetapkan apakah formulir mengharuskan responden untuk login ke akun di domain atau subdomain yang sama sebelum merespons.

Dokumentasi mendetail

addCheckboxGridItem()

Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih beberapa pilihan per baris dari urutan kotak centang.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a checkbox grid item.
const item = form.addCheckboxGridItem();

item.setTitle('Where did you celebrate New Year\'s?');

// Sets the grid's rows and columns.
item.setRows(['New York', 'San Francisco', 'London']).setColumns([
  '2014', '2015', '2016', '2017'
]);

Pulang pergi

CheckboxGridItem — Item yang baru dibuat.

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

---

addCheckboxItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu atau beberapa kotak centang, serta kolom "lainnya" opsional.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a checkbox item.
const item = form.addCheckboxItem();

// Sets the title of the checkbox item to 'Do you prefer cats or dogs?'
item.setTitle('Do you prefer cats or dogs?');

// Sets the choices.
item.setChoiceValues(['Cats', 'Dogs']);

Pulang pergi

CheckboxItem — Item yang baru dibuat.

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

---

addDateItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a date item.
const item = form.addDateItem();

// Sets the title to 'When were you born?'
item.setTitle('When were you born?');

// Sets the description for the date item.
item.setHelpText('Some helper text.');

Pulang pergi

DateItem — Item yang baru dibuat.

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

---

addDateTimeItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal dan waktu.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a question with date and time inputs.
const item = form.addDateTimeItem();

// Sets the title to 'When were you born?'
item.setTitle('When were you born?');

// Sets the question as required.
item.setRequired(true);

Pulang pergi

DateTimeItem — Item yang baru dibuat.

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

---

addDurationItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan durasi waktu.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a question with a duration input.
const item = form.addDurationItem();

// Sets the title to 'How long can you hold your breath?'
item.setTitle('How long can you hold your breath?');

// Sets the question as required.
item.setRequired(true);

Pulang pergi

DurationItem — Item yang baru dibuat.

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

---

addEditor(emailAddress)

Menambahkan pengguna tertentu ke daftar editor untuk Form. Jika pengguna sudah ada dalam daftar penonton, metode ini akan mempromosikan pengguna dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
emailAddress	String	Alamat email pengguna yang akan ditambahkan.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

addEditor(user)

Menambahkan pengguna tertentu ke daftar editor untuk Form. Jika pengguna sudah ada dalam daftar penonton, metode ini akan mempromosikan pengguna dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
user	User	Representasi pengguna yang akan ditambahkan.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

addEditors(emailAddresses)

Menambahkan array pengguna yang diberikan ke daftar editor untuk Form. Jika ada pengguna yang sudah ada dalam daftar penonton, metode ini akan mempromosikan mereka dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
emailAddresses	String[]	Array alamat email pengguna yang akan ditambahkan.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

addGridItem()

Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih satu pilihan per baris dari urutan tombol pilihan.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a multiple choice grid.
const item = form.addGridItem();

// Sets the title to 'Rate your interests.'
item.setTitle('Rate your interests');

// Sets the grid's rows and columns.
item.setRows(['Cars', 'Computers', 'Celebrities']).setColumns([
  'Boring', 'So-so', 'Interesting'
]);

Pulang pergi

GridItem — Item yang baru dibuat.

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

---

addImageItem()

Menambahkan item tata letak baru yang menampilkan gambar.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds an image item.
const item = form.addImageItem();

// Gets the Google icon to use as the image.
const img = UrlFetchApp.fetch(
    'https://fonts.gstatic.com/s/i/productlogos/googleg/v6/web-24dp/logo_googleg_color_1x_web_24dp.png',
);

// Sets the image, title, and description for the item.
item.setTitle('Google icon').setHelpText('Google icon').setImage(img);

Pulang pergi

ImageItem — Item yang baru dibuat.

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

---

addListItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar drop-down.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a dropdown list to the form.
const item = form.addListItem();

// Sets the title to 'Do you prefer cats or dogs?'
item.setTitle('Do you prefer cats or dogs?');

// Sets the description to 'This is description text...'
item.setHelpText('This is description text...');

// Creates and adds choices to the dropdown list.
item.setChoices([item.createChoice('dog'), item.createChoice('cat')]);

Pulang pergi

ListItem — Item yang baru dibuat.

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

---

addMultipleChoiceItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar tombol radio atau kolom "lainnya" opsional.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a multiple choice item to the form.
const item = form.addMultipleChoiceItem();

// Sets the title.
item.setTitle('What is your favorite ice cream flavor?');

// Creates some choice items.
const vanilla = item.createChoice('vanilla');
const chocolate = item.createChoice('chocolate');
const strawberry = item.createChoice('strawberry');

// Sets the choices.
item.setChoices([vanilla, chocolate, strawberry]);

Pulang pergi

MultipleChoiceItem — Item yang baru dibuat.

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

---

addPageBreakItem()

Menambahkan item tata letak baru yang menandai awal halaman.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds page break items to create a second and third page for the form.
const pageTwo = form.addPageBreakItem();
const pageThree = form.addPageBreakItem();

// Sets the titles for the pages.
pageTwo.setTitle('Page two');
pageThree.setTitle('Page three');

// Upon completion of the first page, sets the form to navigate to the third
// page.
pageTwo.setGoToPage(pageThree);

// Upon completion of the second page, sets the form to navigate back to the
// first page.
pageThree.setGoToPage(FormApp.PageNavigationType.RESTART);

Pulang pergi

PageBreakItem — Item yang baru dibuat.

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

---

addParagraphTextItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan blok teks.

// Opens the form by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds the paragraph text item.
const item = form.addParagraphTextItem();

// Sets the title to 'What is your address?'
item.setTitle('What is your address?');

Pulang pergi

ParagraphTextItem — Item yang baru dibuat.

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

---

addScaleItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu opsi dari urutan tombol pilihan bernomor.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds the scale item.
const item = form.addScaleItem();

// Sets the title of the scale item to 'Choose a number.'
item.setTitle('Choose a number');

// Sets the scale to 1-5.
item.setBounds(1, 5);

// Sets the label for the lower and upper bounds.
item.setLabels('Lowest', 'Highest');

Pulang pergi

ScaleItem — Item yang baru dibuat.

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

---

addSectionHeaderItem()

Menambahkan item tata letak baru yang secara visual menunjukkan awal bagian.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds the section heading item.
const item = form.addSectionHeaderItem();

// Sets the title to 'Title of new section.'
item.setTitle('Title of new section');

// Sets the description.
item.setHelpText('Description of new section');

Pulang pergi

SectionHeaderItem — Item yang baru dibuat.

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

---

addTextItem()

Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan satu baris teks.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a single-line text item.
const item = form.addTextItem();

// Sets the title to 'What is your name?'
item.setTitle('What is your name?');

Pulang pergi

TextItem — Item yang baru dibuat.

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

---

addTimeItem()

Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan waktu.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a question with a time input.
const item = form.addTimeItem();

// Sets the title to 'What time do you usually wake up in the morning?'
item.setTitle('What time do you usually wake up in the morning?');

Pulang pergi

TimeItem — Item yang baru dibuat.

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

---

addVideoItem()

Menambahkan item tata letak baru yang menampilkan video.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Adds a video item.
const item = form.addVideoItem();

// Sets the title, description, and video.
item.setTitle('YouTube video')
    .setHelpText('Send content automatically via Google Sheets and Apps Script')
    .setVideoUrl('https://youtu.be/xxgQr-jSu9o');

// Sets the alignment to the center.
item.setAlignment(FormApp.Alignment.CENTER);

Pulang pergi

VideoItem — Item yang baru dibuat.

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

---

canEditResponse()

Menentukan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya.

Terlepas dari setelan ini, metode FormResponse.getEditResponseUrl() memungkinkan penulis skrip yang memiliki akses edit ke formulir untuk membuat URL yang dapat digunakan untuk mengedit respons.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Checks if the form displays a link to edit a response after submitting it.
// The default is false. To let people edit their responses, use
// form.setAllowResponseEdits(true).
const edit = form.canEditResponse();

// If the form doesn't let people edit responses, logs false to the console.
console.log(edit);

Pulang pergi

Boolean — true jika formulir menampilkan link "Edit respons Anda"; false jika tidak.

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

---

collectsEmail()

Menentukan apakah formulir mengumpulkan alamat email responden.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form to not collect respondents' email addresses.
form.setCollectEmail(false);

// Checks whether the form collects respondents' email addresses and logs it to
// the console.
const bool = form.collectsEmail();

console.log(bool);

Pulang pergi

Boolean — true jika formulir mengumpulkan alamat email; false jika tidak.

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

---

createResponse()

Membuat respons baru ke formulir. Untuk menjawab item pertanyaan, buat ItemResponse dari item, lalu lampirkan ke respons formulir ini dengan memanggil FormResponse.withItemResponse(response). Untuk menyimpan respons yang telah dirakit, panggil FormResponse.submit().

Pulang pergi

FormResponse — Respons formulir yang baru dibuat.

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

---

deleteAllResponses()

Menghapus semua respons yang dikirimkan dari penyimpanan respons formulir. Metode ini tidak menghapus salinan respons yang disimpan di tujuan respons eksternal (seperti spreadsheet), tetapi menghapus tampilan ringkasan formulir.

Perhatian: metode ini tidak dapat diurungkan.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

deleteItem(index)

Menghapus item pada indeks tertentu di antara semua item dalam formulir. Menampilkan pengecualian skrip jika tidak ada item di indeks yang ditentukan.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets all the items from the form.
const items = form.getItems();

// Finds the index of a paragraph text item and deletes it by the item's index.
const index = items.findIndex(
    (item) => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT,
);
if (index !== -1) {
  form.deleteItem(index);
}

Parameter

Nama	Jenis	Deskripsi
index	Integer	Indeks item di antara semua item dalam formulir.

Menampilkan

Error — jika tidak ada item di indeks yang diberikan

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

---

deleteItem(item)

Menghapus item yang diberikan. Menampilkan pengecualian skrip jika item telah dihapus.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets all of the items from the form.
const items = form.getItems();

// Finds a paragraph text item and deletes it.
const item = items.find(
    (item) => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT,
);
if (item) {
  form.deleteItem(item);
}

Parameter

Nama	Jenis	Deskripsi
item	Item	Item yang akan dihapus.

Menampilkan

Error — jika item tidak ada dalam 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

---

deleteResponse(responseId)

Menghapus satu respons dari penyimpanan respons formulir. Metode ini tidak menghapus salinan respons yang disimpan di tujuan respons eksternal (seperti spreadsheet), tetapi menghapus respons dari tampilan ringkasan formulir. ID respons dapat diambil dengan FormResponse.getId().

Peringatan: Metode ini tidak dapat diurungkan.

Parameter

Nama	Jenis	Deskripsi
responseId	String	ID respons formulir yang akan dihapus.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

getConfirmationMessage()

Mendapatkan pesan konfirmasi formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the confirmation message to display after someone submits the form.
form.setConfirmationMessage('You successfully submitted the form.');

// Gets the confirmation message and logs it to the console.
const message = form.getConfirmationMessage();

console.log(message);

Pulang pergi

String — Pesan konfirmasi 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

---

getCustomClosedFormMessage()

Mendapatkan pesan kustom yang ditampilkan jika formulir tidak menerima respons, atau string kosong jika tidak ada pesan kustom yang ditetapkan.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets a custom closed form message to display to the user when the form
// no longer accepts responses.
form.setCustomClosedFormMessage('The form is no longer accepting responses.');

// Gets the custom message set for the form and logs it to the console.
const message = form.getCustomClosedFormMessage();

console.log(message);

Pulang pergi

String — Pesan kustom yang akan ditampilkan jika formulir tidak menerima respons, atau string kosong jika tidak ada pesan kustom yang ditetapkan.

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

---

getDescription()

Mendapatkan deskripsi formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form description.
form.setDescription('This is the form description.');

// Gets the form description and logs it to the console.
const description = form.getDescription();

console.log(description);

Pulang pergi

String — Deskripsi 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

---

getDestinationId()

Mendapatkan ID tujuan respons formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Creates a spreadsheet to use as the response destination.
const ss = SpreadsheetApp.create('Test_Spreadsheet');

// Updates the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

// Gets the ID of the form's response destination and logs it to the console.
const destinationId = form.getDestinationId();

console.log(destinationId);

Pulang pergi

String — ID tujuan 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

---

getDestinationType()

Mendapatkan jenis tujuan respons formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc1234556/edit',
);

// Gets the type of the form's response destination and logs it to the console.
const destinationType = form.getDestinationType().name();

console.log(destinationType);

Pulang pergi

DestinationType — Jenis tujuan 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

---

getEditUrl()

Mendapatkan URL yang dapat digunakan untuk mengakses mode edit formulir.

// Opens the form by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets the URL that accesses the form's edit mode and logs it to the console.
const url = form.getEditUrl();

console.log(url);

Pulang pergi

String — URL untuk mengedit 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

---

getEditors()

Mendapatkan daftar editor untuk Form ini.

Pulang pergi

User[] — Array pengguna dengan izin edit.

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

---

getId()

Mendapatkan ID formulir.

// Opens the form by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets the ID of the form and logs it to the console.
const id = form.getId();

console.log(id);

Pulang pergi

String — ID 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

---

getItemById(id)

Mendapatkan item dengan ID yang diberikan. Menampilkan null jika ID tidak sesuai dengan item dalam formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets the ID of the first item on the form.
const itemId = form.getItems()[0].getId();

// Gets the item from the ID.
const item = form.getItemById(itemId);

// Gets the name of the item type and logs it to the console.
const type = item.getType().name();

console.log(type);

Parameter

Nama	Jenis	Deskripsi
id	Integer	ID item.

Pulang pergi

Item — Item dengan ID yang diberikan, atau null jika item tidak ada dalam 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

---

getItems()

Mendapatkan array semua item dalam formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets the list of items in the form.
const items = form.getItems();

// Gets the type for each item and logs them to the console.
const types = items.map((item) => item.getType().name());

console.log(types);

Pulang pergi

Item[] — Array dari semua item dalam 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

---

getItems(itemType)

Mendapatkan array dari semua item dari jenis tertentu.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets a list of all checkbox items on the form.
const items = form.getItems(FormApp.ItemType.CHECKBOX);

// Gets the title of each checkbox item and logs them to the console.
const checkboxItemsTitle = items.map(
    (item) => item.asCheckboxItem().getTitle(),
);
console.log(checkboxItemsTitle);

Parameter

Nama	Jenis	Deskripsi
itemType	ItemType	Jenis item yang akan diambil.

Pulang pergi

Item[] — Array dari semua item dari jenis tersebut.

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

---

getPublishedUrl()

Mendapatkan URL yang dapat digunakan untuk merespons formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets the URL to respond to the form and logs it to the console.
const url = form.getPublishedUrl();
console.log(url);

Pulang pergi

String — URL untuk merespons 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

---

getResponse(responseId)

Mendapatkan satu respons formulir berdasarkan ID responsnya. ID respons dapat diambil dari FormResponse.getId().

Parameter

Nama	Jenis	Deskripsi
responseId	String	ID untuk respons formulir.

Pulang pergi

FormResponse — Respons formulir.

Menampilkan

Error — jika respons tidak ada

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

---

getResponses()

Mendapatkan array dari semua respons formulir.

Pulang pergi

FormResponse[] — Array dari semua 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

---

getResponses(timestamp)

Mendapatkan array dari semua respons formulir setelah tanggal dan waktu tertentu.

Parameter

Nama	Jenis	Deskripsi
timestamp	Date	Tanggal dan waktu paling awal untuk menampilkan respons formulir.

Pulang pergi

FormResponse[] — Daftar 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

---

getShuffleQuestions()

Menentukan apakah urutan pertanyaan di setiap halaman formulir diacak.

Pulang pergi

Boolean — true jika urutan pertanyaan di setiap halaman formulir diacak; false jika tidak.

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

---

getSummaryUrl()

Mendapatkan URL yang dapat digunakan untuk melihat ringkasan respons formulir. Kecuali jika setPublishingSummary(enabled) disetel ke true, hanya pengguna dengan izin edit ke formulir yang dapat mengakses URL.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// Opens the form by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets the URL to view a summary of the form's responses and logs it to the
// console.
const url = form.getSummaryUrl();
console.log(url);

Pulang pergi

String — URL untuk melihat ringkasan respons.

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

---

getTitle()

Mendapatkan judul formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the title of the form to 'For_Testing.'
form.setTitle('For_Testing');

// Gets the title of the form and logs it to the console.
const title = form.getTitle();
console.log(title);

Pulang pergi

String — Judul 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

---

hasLimitOneResponsePerUser()

Menentukan apakah formulir hanya mengizinkan satu respons per responden. Jika nilainya true, skrip tidak dapat mengirimkan respons formulir sama sekali.

Pulang pergi

Boolean — true jika formulir hanya mengizinkan satu respons per responden; false jika tidak.

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

---

hasProgressBar()

Menentukan apakah formulir menampilkan status progres.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// Opens the form by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Displays the progress bar on the form.
form.setProgressBar(true);

// Checks if the form displays a progress bar and logs it to the console.
console.log(form.hasProgressBar());

Pulang pergi

Boolean — true jika formulir menampilkan status progres; false jika tidak.

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

---

hasRespondAgainLink()

Menentukan apakah formulir akan menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form to display a link to submit another
// response after someone submits the form.
form.setShowLinkToRespondAgain(true);

// Checks if the form displays a 'Submit another response' link and logs it to
// the console.
console.log(form.hasRespondAgainLink());

Pulang pergi

Boolean — true jika formulir menampilkan link "Kirim respons lain"; false jika tidak.

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

---

isAcceptingResponses()

Menentukan apakah formulir saat ini menerima respons.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form to accept responses.
form.setAcceptingResponses(true);

// Checks if the form is accepting responses or not and logs it to the console.
const accepting = form.isAcceptingResponses();
console.log(accepting);

Pulang pergi

Boolean — true jika formulir menerima respons; false jika tidak.

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

---

isPublishingSummary()

Menentukan apakah formulir akan menampilkan link untuk melihat ringkasan respons setelah responden menyelesaikan formulir.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form to display a link to a summary of
// the responses after someone submits the form.
form.setPublishingSummary(true);

// Checks if the form displays a "See previous responses" link and logs it to
// the console.
const publishingLink = form.isPublishingSummary();
console.log(publishingLink);

Pulang pergi

Boolean — true jika formulir menampilkan link "Lihat respons sebelumnya"; false jika tidak.

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

---

isQuiz()

Menentukan apakah formulir adalah kuis.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form as a quiz.
form.setIsQuiz(true);

// Checks if the form is a quiz or not and logs it to the console.
console.log(form.isQuiz());

Pulang pergi

Boolean — true jika formulir menerima respons; false jika tidak.

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

---

moveItem(from, to)

Memindahkan item pada indeks tertentu di antara semua item dalam formulir ke indeks lain yang ditentukan. Menampilkan pengecualian skrip jika indeks to melebihi batas.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Moves the first item to be the last item.
form.moveItem(0, form.getItems().length - 1);

Parameter

Nama	Jenis	Deskripsi
from	Integer	Indeks item saat ini di antara semua item dalam formulir.
to	Integer	Indeks baru untuk item di antara semua item dalam formulir.

Pulang pergi

Item — Item yang dipindahkan.

Menampilkan

Error — jika salah satu indeks melebihi batas.

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

---

moveItem(item, toIndex)

Memindahkan item tertentu ke indeks tertentu di antara semua item dalam formulir. Menampilkan pengecualian skrip jika indeks yang diberikan melebihi batas.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Gets the first item.
const item = form.getItems()[0];

// Moves the item to be the last item.
form.moveItem(item, form.getItems().length - 1);

Parameter

Nama	Jenis	Deskripsi
item	Item	Item yang akan dipindahkan.
toIndex	Integer	Indeks baru untuk item di antara semua item dalam formulir.

Pulang pergi

Item — Item yang dipindahkan.

Menampilkan

Error — jika indeks melebihi batas.

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

---

removeDestination()

Membatalkan tautan formulir dari tujuan respons saat ini. Tujuan sebelumnya yang dibatalkan penautannya masih mempertahankan salinan semua respons sebelumnya. Semua formulir, termasuk formulir yang tidak memiliki tujuan yang ditetapkan secara eksplisit, menyimpan salinan respons di penyimpanan respons formulir. Jika formulir saat ini tidak memiliki tujuan respons, metode ini tidak akan berpengaruh.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Opens a spreadsheet to use for the response destination.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Updates the form's response destination to the spreadsheet.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

// Unlinks the form from the spreadsheet.
form.removeDestination();

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

removeEditor(emailAddress)

Menghapus pengguna tertentu dari daftar editor untuk Form. Metode ini tidak memblokir pengguna agar tidak mengakses Form jika mereka termasuk dalam class pengguna yang memiliki akses umum—misalnya, jika Form dibagikan ke seluruh domain pengguna, atau jika Form berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

Nama	Jenis	Deskripsi
emailAddress	String	Alamat email pengguna yang akan dihapus.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

removeEditor(user)

Menghapus pengguna tertentu dari daftar editor untuk Form. Metode ini tidak memblokir pengguna agar tidak mengakses Form jika mereka termasuk dalam class pengguna yang memiliki akses umum—misalnya, jika Form dibagikan ke seluruh domain pengguna, atau jika Form berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

Nama	Jenis	Deskripsi
user	User	Representasi pengguna yang akan dihapus.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setAcceptingResponses(enabled)

Menetapkan apakah formulir saat ini menerima respons. Default untuk formulir baru adalah true.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form to accept responses.
form.setAcceptingResponses(true);

// Checks whether the form is accepting responses or not and logs it to the
// console.
console.log(form.isAcceptingResponses());

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika formulir harus menerima respons; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setAllowResponseEdits(enabled)

Menetapkan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya. Default untuk formulir baru adalah false.

Terlepas dari setelan ini, metode FormResponse.getEditResponseUrl() memungkinkan penulis skrip yang memiliki izin edit ke formulir untuk membuat URL yang dapat digunakan untuk mengedit respons.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Shows "Edit your response" link after someone submits the form.
form.setAllowResponseEdits(true);

// Checks whether the option to edit the form after a user submits it is set to
// true or not and logs it to the console.
console.log(form.canEditResponse());

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika formulir harus menampilkan link "Edit respons Anda"; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setCollectEmail(collect)

Menetapkan apakah formulir akan mengumpulkan alamat email responden. Default untuk formulir baru adalah false.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form to collect respondents' email addresses.
form.setCollectEmail(true);

// Checks whether the value is set to true or false and logs it to the console.
const collect = form.collectsEmail();
console.log(collect);

Parameter

Nama	Jenis	Deskripsi
collect	Boolean	true jika formulir harus mengumpulkan alamat email; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setConfirmationMessage(message)

Menetapkan pesan konfirmasi formulir.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets a custom confirmation message to display after someone submits the form.
form.setConfirmationMessage('Your form has been successfully submitted.');

// Gets the confirmation message set for the form and logs it to the console.
const message = form.getConfirmationMessage();
console.log(message);

Parameter

Nama	Jenis	Deskripsi
message	String	Pesan konfirmasi baru formulir.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setCustomClosedFormMessage(message)

Menetapkan pesan yang akan ditampilkan jika formulir tidak menerima respons. Jika tidak ada pesan yang ditetapkan, formulir akan menggunakan pesan default.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form to not accept responses.
form.setAcceptingResponses(false);

// Sets a custom closed form message to display to the user.
form.setCustomClosedFormMessage('The form is no longer accepting responses.');

// Gets the custom message set for the form and logs it to the console.
const message = form.getCustomClosedFormMessage();
console.log(message);

Parameter

Nama	Jenis	Deskripsi
message	String	Pesan yang akan ditampilkan jika formulir tidak menerima respons.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setDescription(description)

Menetapkan deskripsi formulir.

Parameter

Nama	Jenis	Deskripsi
description	String	Deskripsi baru formulir.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setDestination(type, id)

Menetapkan tujuan tempat respons formulir disimpan. Semua formulir, termasuk formulir yang tidak memiliki tujuan yang ditetapkan secara eksplisit, menyimpan salinan respons di penyimpanan respons formulir.

Parameter

Nama	Jenis	Deskripsi
type	DestinationType	Jenis tujuan respons formulir.
id	String	ID tujuan respons formulir.

Pulang pergi

Form — Form ini, untuk perantaian.

Menampilkan

Error — jika ID tujuan yang diberikan tidak valid

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

---

setIsQuiz(enabled)

Menetapkan apakah formulir adalah kuis. Default untuk formulir baru adalah false.

Pertanyaan yang dinilai hanya diizinkan dalam Kuis, sehingga menetapkannya ke false akan menyebabkan semua opsi penilaian dihapus dari semua pertanyaan.

Setelan kuis hanya tersedia di UI Formulir baru; menjadikan formulir sebagai Kuis akan membuat formulir menggunakan UI baru.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Makes the form a quiz.
form.setIsQuiz(true);

// Checks whether the form is a quiz or not and logs it to the console.
console.log(form.isQuiz());

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika fitur kuis harus diaktifkan untuk formulir; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setLimitOneResponsePerUser(enabled)

Menetapkan apakah formulir hanya mengizinkan satu respons per responden. Default untuk formulir baru adalah false. Jika nilai disetel ke true, skrip tidak dapat mengirimkan respons formulir sama sekali.

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika formulir hanya boleh mengizinkan satu respons per responden; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setProgressBar(enabled)

Menetapkan apakah formulir memiliki status progres. Default untuk formulir baru adalah false.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Displays the progress bar on the form.
form.setProgressBar(true);

// Checks whether the form has a progress bar and logs it to the console.
console.log(form.hasProgressBar());

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika formulir menampilkan status progres; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setPublishingSummary(enabled)

Menetapkan apakah formulir akan menampilkan link untuk melihat ringkasan respons setelah responden mengirimkan formulir. Default untuk formulir baru adalah false.

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika formulir harus menampilkan link "Lihat respons sebelumnya"; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setShowLinkToRespondAgain(enabled)

Menetapkan apakah formulir akan menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir. Default untuk formulir baru adalah true.

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	true jika formulir harus menampilkan link "Kirim respons lain"; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setShuffleQuestions(shuffle)

Menetapkan apakah urutan pertanyaan di setiap halaman formulir diacak.

Parameter

Nama	Jenis	Deskripsi
shuffle	Boolean	true jika urutan pertanyaan di setiap halaman formulir harus diacak; false jika tidak.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

setTitle(title)

Menetapkan judul formulir.

Parameter

Nama	Jenis	Deskripsi
title	String	Judul baru formulir.

Pulang pergi

Form — Form ini, untuk perantaian.

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

---

shortenFormUrl(url)

Mengonversi URL panjang untuk formulir menjadi URL singkat. Menampilkan pengecualian jika URL panjang tidak milik Google Formulir.

Parameter

Nama	Jenis	Deskripsi
url	String	URL yang akan dipersingkat.

Pulang pergi

String — URL dalam bentuk http://goo.gl/forms/1234.

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

---

submitGrades(responses)

Mengirimkan nilai untuk FormResponses yang diberikan.

Jika kode Anda menyertakan pemicu onFormSubmit, memanggil submitGrades() akan memicu kondisi onFormSubmit dan menyebabkan loop tanpa batas. Untuk mencegah loop tanpa akhir, tambahkan kode yang memeriksa apakah nilai sudah ada sebelum memanggil submitGrades().

Parameter

Nama	Jenis	Deskripsi
responses	FormResponse[]	Array dari semua respons formulir.

Pulang pergi

Form — Form ini, untuk perantaian.

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

Metode yang tidak digunakan lagi

requiresLogin()

Tidak digunakan lagi. Fungsi ini tidak digunakan lagi dan tidak boleh digunakan dalam skrip baru.

Menentukan apakah formulir mengharuskan responden untuk login ke akun di domain atau subdomain yang sama sebelum merespons.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Checks if the form requires respondents to log in to a Google Workspace
// account before responding and logs it to the console.
const login = form.requiresLogin();
console.log(login);

Pulang pergi

Boolean — true jika formulir mengharuskan pengguna login; false jika tidak.

---

setRequireLogin(requireLogin)

Tidak digunakan lagi. Fungsi ini tidak digunakan lagi dan tidak boleh digunakan dalam skrip baru.

Menetapkan apakah formulir mengharuskan responden untuk login ke akun di domain atau subdomain yang sama sebelum merespons. Default untuk formulir baru adalah false, kecuali jika administrator domain mengubah default.

Fitur ini hanya tersedia untuk formulir yang dibuat oleh pengguna Google Workspace. Pengguna jenis Akun Google lain tidak dapat diwajibkan untuk login.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/abc123456/edit',
);

// Sets the form so that users must log in to their Google Workspace account.
form.setRequireLogin(true);

// Checks whether the form requires login or not and logs it to the console.
console.log(form.requiresLogin());

Parameter

Nama	Jenis	Deskripsi
requireLogin	Boolean	true jika formulir mengharuskan pengguna untuk login; false jika tidak.

Pulang pergi

Form — Bentuk saat ini (untuk penyambungan).

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