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 Form
.
// 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 |
---|---|---|
add | Checkbox | Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih beberapa pilihan per baris dari urutan kotak centang. |
add | Checkbox | Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu atau beberapa kotak centang, serta kolom "lainnya" opsional. |
add | Date | Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal. |
add | Date | Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan tanggal dan waktu. |
add | Duration | Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan durasi waktu. |
add | Form | Menambahkan pengguna tertentu ke daftar editor untuk Form . |
add | Form | Menambahkan pengguna tertentu ke daftar editor untuk Form . |
add | Form | Menambahkan array pengguna yang diberikan ke daftar editor untuk Form . |
add | Grid | Menambahkan item pertanyaan baru, yang ditampilkan sebagai petak kolom dan baris, yang memungkinkan responden memilih satu pilihan per baris dari urutan tombol pilihan. |
add | Image | Menambahkan item tata letak baru yang menampilkan gambar. |
add | List | Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar drop-down. |
add | Multiple | Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu pilihan dari daftar tombol radio atau kolom "lainnya" opsional. |
add | Page | Menambahkan item tata letak baru yang menandai awal halaman. |
add | Paragraph | Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan blok teks. |
add | Rating | Menambahkan item pertanyaan baru yang memungkinkan responden memberikan rating. |
add | Scale | Menambahkan item pertanyaan baru yang memungkinkan responden memilih satu opsi dari urutan tombol pilihan bernomor. |
add | Section | Menambahkan item tata letak baru yang secara visual menunjukkan awal bagian. |
add | Text | Menambahkan item pertanyaan baru yang memungkinkan responden memasukkan satu baris teks. |
add | Time | Menambahkan item pertanyaan baru yang memungkinkan responden menunjukkan waktu. |
add | Video | Menambahkan item tata letak baru yang menampilkan video. |
can | Boolean | Menentukan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya. |
collects | Boolean | Menentukan apakah formulir mengumpulkan alamat email responden. |
create | Form | Membuat respons baru ke formulir. |
delete | Form | Menghapus semua respons yang dikirimkan dari penyimpanan respons formulir. |
delete | void | Menghapus item pada indeks tertentu di antara semua item dalam formulir. |
delete | void | Menghapus item yang diberikan. |
delete | Form | Menghapus satu respons dari penyimpanan respons formulir. |
get | String | Mendapatkan pesan konfirmasi formulir. |
get | String | Mendapatkan pesan kustom yang ditampilkan jika formulir tidak menerima respons, atau string kosong jika tidak ada pesan kustom yang ditetapkan. |
get | String | Mendapatkan deskripsi formulir. |
get | String | Mendapatkan ID tujuan respons formulir. |
get | Destination | Mendapatkan jenis tujuan respons formulir. |
get | String | Mendapatkan URL yang dapat digunakan untuk mengakses mode edit formulir. |
get | User[] | Mendapatkan daftar editor untuk Form ini. |
get | String | Mendapatkan ID formulir. |
get | Item | Mendapatkan item dengan ID yang diberikan. |
get | Item[] | Mendapatkan array semua item dalam formulir. |
get | Item[] | Mendapatkan array dari semua item dari jenis tertentu. |
get | String | Mendapatkan URL yang dapat digunakan untuk merespons formulir. |
get | Form | Mendapatkan satu respons formulir berdasarkan ID responsnya. |
get | Form | Mendapatkan array dari semua respons formulir. |
get | Form | Mendapatkan array dari semua respons formulir setelah tanggal dan waktu tertentu. |
get | Boolean | Menentukan apakah urutan pertanyaan di setiap halaman formulir diacak. |
get | String | Mendapatkan URL yang dapat digunakan untuk melihat ringkasan respons formulir. |
get | String | Mendapatkan judul formulir. |
has | Boolean | Menentukan apakah formulir hanya mengizinkan satu respons per responden. |
has | Boolean | Menentukan apakah formulir menampilkan status progres. |
has | Boolean | Menentukan apakah formulir akan menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir. |
is | Boolean | Menentukan apakah formulir saat ini menerima respons. |
is | Boolean | Menentukan apakah formulir akan menampilkan link untuk melihat ringkasan respons setelah responden menyelesaikan formulir. |
is | Boolean | Menentukan apakah formulir adalah kuis. |
move | Item | Memindahkan item pada indeks tertentu di antara semua item dalam formulir ke indeks lain yang ditentukan. |
move | Item | Memindahkan item tertentu ke indeks tertentu di antara semua item dalam formulir. |
remove | Form | Membatalkan tautan formulir dari tujuan respons saat ini. |
remove | Form | Menghapus pengguna tertentu dari daftar editor untuk Form . |
remove | Form | Menghapus pengguna tertentu dari daftar editor untuk Form . |
set | Form | Menetapkan apakah formulir saat ini menerima respons. |
set | Form | Menetapkan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya. |
set | Form | Menetapkan apakah formulir akan mengumpulkan alamat email responden. |
set | Form | Menetapkan pesan konfirmasi formulir. |
set | Form | Menetapkan pesan yang akan ditampilkan jika formulir tidak menerima respons. |
set | Form | Menetapkan deskripsi formulir. |
set | Form | Menetapkan tujuan tempat respons formulir disimpan. |
set | Form | Menetapkan apakah formulir adalah kuis. |
set | Form | Menetapkan apakah formulir hanya mengizinkan satu respons per responden. |
set | Form | Menetapkan apakah formulir memiliki status progres. |
set | Form | Menetapkan apakah formulir akan menampilkan link untuk melihat ringkasan respons setelah responden mengirimkan formulir. |
set | Form | Menetapkan apakah formulir akan menampilkan link untuk mengirimkan respons lain setelah responden menyelesaikan formulir. |
set | Form | Menetapkan apakah urutan pertanyaan di setiap halaman formulir diacak. |
set | Form | Menetapkan judul formulir. |
shorten | String | Mengonversi URL panjang untuk formulir menjadi URL singkat. |
submit | Form | Mengirimkan nilai untuk FormResponses yang diberikan. |
Dokumentasi mendetail
add Checkbox Grid Item()
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
Checkbox
— 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
add Checkbox Item()
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
Checkbox
— 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
add Date Item()
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
Date
— 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
add Date Time Item()
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
Date
— 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
add Duration Item()
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
Duration
— 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
add Editor(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 |
---|---|---|
email | 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
add Editor(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
add Editors(emailAddresses)
Menambahkan array pengguna yang diberikan ke daftar editor untuk Form
. Jika ada pengguna yang sudah ada dalam daftar penonton, metode ini akan mempromosikannya keluar dari daftar penonton.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
email | 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
add Grid Item()
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
Grid
— 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
add Image Item()
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
Image
— 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
add List Item()
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
List
— 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
add Multiple Choice Item()
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
Multiple
— 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
add Page Break Item()
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
Page
— 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
add Paragraph Text Item()
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
Paragraph
— 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
add Rating Item()
Menambahkan item pertanyaan baru yang memungkinkan responden memberikan rating.
// 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 rating item. const item = form.addRatingItem();
Pulang pergi
Rating
— 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
add Scale Item()
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
Scale
— 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
add Section Header Item()
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
Section
— 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
add Text Item()
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
Text
— 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
add Time Item()
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
Time
— 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
add Video Item()
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
Video
— 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
can Edit Response()
Menentukan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya.
Terlepas dari setelan ini, metode Form
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
collects Email()
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
create Response()
Membuat respons baru ke formulir. Untuk menjawab item pertanyaan, buat Item
dari item, lalu lampirkan ke respons formulir ini dengan memanggil Form
. Untuk menyimpan respons yang telah dirakit, panggil Form
.
Pulang pergi
Form
— 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
delete All Responses()
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.
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
delete Item(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
delete Item(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
delete Response(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 Form
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
response | 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
get Confirmation Message()
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
get Custom Closed Form Message()
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
get Description()
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
get Destination Id()
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
get Destination Type()
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
Destination
— 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
get Edit Url()
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
get Editors()
get Id()
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
get Item By Id(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
get Items()
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
get Items(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 |
---|---|---|
item | Item | 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
get Published Url()
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
get Response(responseId)
Mendapatkan satu respons formulir berdasarkan ID responsnya. ID respons dapat diambil dari Form
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
response | String | ID untuk respons formulir. |
Pulang pergi
Form
— 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
get Responses()
Mendapatkan array dari semua respons formulir.
Pulang pergi
Form
— 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
get Responses(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
Form
— 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
get Shuffle Questions()
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
get Summary Url()
Mendapatkan URL yang dapat digunakan untuk melihat ringkasan respons formulir. Kecuali jika set
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
get Title()
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
has Limit One Response Per User()
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
has Progress Bar()
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
has Respond Again Link()
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
is Accepting Responses()
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
is Publishing Summary()
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
is Quiz()
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
move Item(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
move Item(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. |
to | 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
remove Destination()
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
remove Editor(emailAddress)
Menghapus pengguna tertentu dari daftar editor untuk Form
. Metode ini tidak
memblokir pengguna agar tidak mengakses Form
jika mereka termasuk dalam kelas 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 |
---|---|---|
email | 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
remove Editor(user)
Menghapus pengguna tertentu dari daftar editor untuk Form
. Metode ini tidak
memblokir pengguna agar tidak mengakses Form
jika mereka termasuk dalam kelas 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
set Accepting Responses(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
set Allow Response Edits(enabled)
Menetapkan apakah formulir akan menampilkan link untuk mengedit respons setelah mengirimkannya. Default untuk
formulir baru adalah false
.
Terlepas dari setelan ini, metode Form
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
set Collect Email(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
set Confirmation Message(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
set Custom Closed Form Message(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
set Description(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
set Destination(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 | Destination | 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
set Is Quiz(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
set Limit One Response Per User(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
set Progress Bar(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
set Publishing Summary(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
set Show Link To Respond Again(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
set Shuffle Questions(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
set Title(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
shorten Form Url(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
submit Grades(responses)
Mengirimkan nilai untuk FormResponses yang diberikan.
Jika kode Anda menyertakan pemicu on
, memanggil submit
akan memicu kondisi on
dan menyebabkan loop tanpa batas. Untuk mencegah loop tanpa akhir, tambahkan kode yang memeriksa apakah nilai sudah ada sebelum memanggil submit
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
responses | Form | 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