Class Form

Форма

Форма, содержащая общие свойства и элементы. Свойства включают заголовок, настройки и место хранения ответов. Элементы включают пункты вопросов, такие как флажки или переключатели, а элементы макета относятся к таким вещам, как разрывы страниц. Доступ к формам или их создание осуществляется через 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());

Методы

Метод Тип возвращаемого значения Краткое описание
add Checkbox Grid Item() Checkbox Grid Item Добавляет новый вопрос, представленный в виде сетки столбцов и строк, позволяющий респонденту выбирать несколько вариантов ответа в каждой строке из последовательности флажков.
add Checkbox Item() Checkbox Item Добавляет новый вопрос, позволяющий респонденту выбрать один или несколько вариантов ответа, а также необязательное поле «другое».
add Date Item() Date Item Добавляет новый вопрос, позволяющий респонденту указать дату.
add Date Time Item() Date Time Item Добавляет новый вопрос, позволяющий респонденту указать дату и время.
add Duration Item() Duration Item Добавляет новый вопрос, позволяющий респонденту указать продолжительность времени.
add Editor(emailAddress) Form Добавляет указанного пользователя в список редакторов Form .
add Editor(user) Form Добавляет указанного пользователя в список редакторов Form .
add Editors(emailAddresses) Form Добавляет указанный массив пользователей в список редакторов для Form .
add Grid Item() Grid Item Добавляется новый вопрос, представленный в виде сетки столбцов и строк, позволяющий респонденту выбрать один вариант ответа в каждой строке из последовательности радиокнопок.
add Image Item() Image Item Добавляет новый элемент макета, отображающий изображение.
add List Item() List Item Добавляет новый вопрос, позволяющий респонденту выбрать один вариант из выпадающего списка.
add Multiple Choice Item() Multiple Choice Item Добавляет новый пункт вопроса, позволяющий респонденту выбрать один из вариантов ответа из списка переключателей или заполнить необязательное поле «другое».
add Page Break Item() Page Break Item Добавляет новый элемент макета, который отмечает начало страницы.
add Paragraph Text Item() Paragraph Text Item Добавляет новый пункт вопроса, позволяющий респонденту ввести текстовый блок.
add Published Reader(emailAddress) Form Добавляет указанного пользователя в список участников, ответивших на Form .
add Published Reader(user) Form Добавляет указанного пользователя в список участников, ответивших на Form .
add Published Readers(emailAddresses) Form Добавляет указанный массив пользователей в список респондентов для Form .
add Rating Item() Rating Item Добавляет новый вопрос, позволяющий респонденту поставить оценку.
add Scale Item() Scale Item Добавляет новый вопрос, позволяющий респонденту выбрать один вариант из пронумерованной последовательности переключателей.
add Section Header Item() Section Header Item Добавляет новый элемент макета, который визуально обозначает начало раздела.
add Text Item() Text Item Добавляет новый вопрос, позволяющий респонденту ввести одну строку текста.
add Time Item() Time Item Добавляет новый вопрос, позволяющий респонденту указать время суток.
add Video Item() Video Item Добавляет новый элемент макета, отображающий видео.
can Edit Response() Boolean Определяет, будет ли в форме отображаться ссылка для редактирования ответа после его отправки.
collects Email() Boolean Определяет, собирает ли форма адреса электронной почты респондентов.
create Response() Form Response Создает новый ответ на форму.
delete All Responses() Form Удаляет все отправленные ответы из хранилища ответов формы.
delete Item(index) void Удаляет элемент с заданным индексом среди всех элементов формы.
delete Item(item) void Удаляет указанный элемент.
delete Response(responseId) Form Удаляет один ответ из хранилища ответов формы.
get Confirmation Message() String Получает подтверждающее сообщение из формы.
get Custom Closed Form Message() String Получает пользовательское сообщение, отображаемое, если форма не принимает ответы, или пустую строку, если пользовательское сообщение не задано.
get Description() String Получает описание формы.
get Destination Id() String Получает идентификатор адреса получателя ответа формы.
get Destination Type() Destination Type Получает тип адресата ответа формы.
get Edit Url() String Получает URL-адрес, который можно использовать для доступа к режиму редактирования формы.
get Editors() User[] Получает список редакторов для этой Form .
get Id() String Получает идентификатор формы.
get Item By Id(id) Item |null Получает элемент с заданным ID.
get Items() Item[] Получает массив всех элементов формы.
get Items(itemType) Item[] Получает массив всех элементов заданного типа.
get Published Readers() User[] Получает список респондентов, заполнивших эту Form .
get Published Url() String Получает URL-адрес, который можно использовать для ответа на форму.
get Response(responseId) Form Response Получает один ответ из формы на основе его идентификатора.
get Responses() Form Response[] Получает массив всех ответов на форму.
get Responses(timestamp) Form Response[] Получает массив всех ответов на форму, полученных после указанной даты и времени.
get Shuffle Questions() Boolean Определяет, будет ли порядок вопросов на каждой странице анкеты рандомизированным.
get Summary Url() String Получает URL-адрес, который можно использовать для просмотра сводки ответов на форму.
get Title() String Получает заголовок формы.
has Limit One Response Per User() Boolean Определяет, допускает ли форма только один ответ от респондента.
has Progress Bar() Boolean Определяет, будет ли форма отображать индикатор выполнения.
has Respond Again Link() Boolean Определяет, будет ли в форме отображаться ссылка для отправки дополнительного ответа после заполнения формы респондентом.
is Accepting Responses() Boolean Определяет, принимает ли форма в данный момент ответы.
is Published() Boolean Определяет, будет ли форма опубликована.
is Publishing Summary() Boolean Определяет, будет ли в форме отображаться ссылка для просмотра сводки ответов после заполнения формы респондентом.
is Quiz() Boolean Определяет, является ли форма тестом.
move Item(from, to) Item Перемещает элемент с заданным индексом среди всех элементов формы на другой заданный индекс.
move Item(item, toIndex) Item Перемещает заданный элемент по заданному индексу среди всех элементов формы.
remove Destination() Form Отменяет связь формы с текущим местом назначения ответа.
remove Editor(emailAddress) Form Удаляет указанного пользователя из списка редакторов Form .
remove Editor(user) Form Удаляет указанного пользователя из списка редакторов Form .
remove Published Reader(emailAddress) Form Удаляет указанного пользователя из списка участников, ответивших на Form .
remove Published Reader(user) Form Удаляет указанного пользователя из списка участников, ответивших на Form .
set Accepting Responses(enabled) Form Определяет, принимает ли форма в данный момент ответы.
set Allow Response Edits(enabled) Form Определяет, будет ли форма отображать ссылку для редактирования ответа после его отправки.
set Collect Email(collect) Form Определяет, будет ли форма собирать адреса электронной почты респондентов.
set Confirmation Message(message) Form Устанавливает сообщение с подтверждением для формы.
set Custom Closed Form Message(message) Form Задает сообщение, которое будет отображаться, если форма не принимает ответы.
set Description(description) Form Задает описание формы.
set Destination(type, id) Form Указывает место, куда сохраняются ответы на формы.
set Is Quiz(enabled) Form Определяет, является ли форма викториной.
set Limit One Response Per User(enabled) Form Определяет, разрешает ли форма только один ответ от одного респондента.
set Progress Bar(enabled) Form Определяет, будет ли у формы индикатор выполнения.
set Published(enabled) Form Определяет, будет ли форма опубликована.
set Publishing Summary(enabled) Form Определяет, будет ли форма отображать ссылку для просмотра сводки ответов после того, как респондент отправит форму.
set Show Link To Respond Again(enabled) Form Определяет, будет ли форма отображать ссылку для отправки дополнительного ответа после заполнения формы респондентом.
set Shuffle Questions(shuffle) Form Определяет, будет ли порядок вопросов на каждой странице анкеты рандомизирован.
set Title(title) Form Задает заголовок формы.
shorten Form Url(url) String Преобразует длинный URL-адрес формы в короткий.
submit Grades(responses) Form Выставляет оценки за предоставленные ответы в форме.
supports Advanced Responder Permissions() Boolean Определяет, поддерживает ли форма публикацию.

Подробная документация

addCheckboxGridItem()

Добавляет новый вопрос, представленный в виде сетки столбцов и строк, позволяющий респонденту выбирать несколько вариантов ответа в каждой строке из последовательности флажков.

// 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'
]);

Возвращаться

CheckboxGridItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addCheckboxItem()

Добавляет новый вопрос, позволяющий респонденту выбрать один или несколько вариантов ответа, а также необязательное поле «другое».

// 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']);

Возвращаться

CheckboxItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addDateItem()

Добавляет новый вопрос, позволяющий респонденту указать дату.

// 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.');

Возвращаться

DateItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addDateTimeItem()

Добавляет новый вопрос, позволяющий респонденту указать дату и время.

// 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);

Возвращаться

DateTimeItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addDurationItem()

Добавляет новый вопрос, позволяющий респонденту указать продолжительность времени.

// 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);

Возвращаться

DurationItem — Вновь созданный предмет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addEditor(emailAddress)

Добавляет указанного пользователя в список редакторов Form . Если пользователь уже был в списке зрителей или отвечающих, этот метод удаляет его из списка.

// 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 editor to the form.
// TODO(developer): replace the emailAddress.
form.addEditor('editor@uni.edu');

Параметры

Имя Тип Описание
email Address String Адрес электронной почты пользователя, который необходимо добавить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addEditor(user)

Добавляет указанного пользователя в список редакторов Form . Если пользователь уже был в списке зрителей или отвечающих, этот метод удаляет его из списка.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the editors from the old form.
const users = oldForm.getEditors();

// Creates a new form.
const newForm = FormApp.create('New form');

// Adds the editors to a new form.
users.forEach(user => newForm.addEditor(user));

Параметры

Имя Тип Описание
user User Изображение пользователя, которого нужно добавить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addEditors(emailAddresses)

Добавляет заданный массив пользователей в список редакторов Form . Если какой-либо из пользователей уже был в списке зрителей, этот метод перемещает его из списка зрителей.

// 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 editors to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReaders(['editor1@uni.edu', 'editor2@uni.edu']);

Параметры

Имя Тип Описание
email Addresses String[] Массив адресов электронной почты пользователей, которых нужно добавить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addGridItem()

Добавляется новый вопрос, представленный в виде сетки столбцов и строк, позволяющий респонденту выбрать один вариант ответа в каждой строке из последовательности радиокнопок.

// 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'
]);

Возвращаться

GridItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addImageItem()

Добавляет новый элемент макета, отображающий изображение.

// 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);

Возвращаться

ImageItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addListItem()

Добавляет новый вопрос, позволяющий респонденту выбрать один вариант из выпадающего списка.

// 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')]);

Возвращаться

ListItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addMultipleChoiceItem()

Добавляет новый пункт вопроса, позволяющий респонденту выбрать один из вариантов ответа из списка переключателей или заполнить необязательное поле «другое».

// 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]);

Возвращаться

MultipleChoiceItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addPageBreakItem()

Добавляет новый элемент макета, который отмечает начало страницы.

// 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);

Возвращаться

PageBreakItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addParagraphTextItem()

Добавляет новый пункт вопроса, позволяющий респонденту ввести текстовый блок.

// 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?');

Возвращаться

ParagraphTextItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addPublishedReader(emailAddress)

Добавляет указанного пользователя в список участников, отвечающих на Form . Если пользователь уже был в списке редакторов или зрителей, этот метод не оказывает никакого эффекта.

// 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 responder to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReader('responder@uni.edu');

Параметры

Имя Тип Описание
email Address String Адрес электронной почты пользователя, который необходимо добавить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addPublishedReader(user)

Добавляет указанного пользователя в список участников, отвечающих на Form . Если пользователь уже был в списке редакторов или зрителей, этот метод не оказывает никакого эффекта.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the responders from the old form.
const users = oldForm.getPublishedReaders();

// Creates a new form.
const newForm = FormApp.create('New form');

// Adds the responders to a new form.
users.forEach(user => newForm.addPublishedReader(user));

Параметры

Имя Тип Описание
user User Изображение пользователя, которого нужно добавить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addPublishedReaders(emailAddresses)

Добавляет указанный массив пользователей в список участников, отвечающих на Form . Если пользователь уже был в списке редакторов или зрителей, этот метод не оказывает никакого эффекта.

// 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 responders to the form.
// TODO(developer): replace the emailAddress.
form.addPublishedReaders(['responder1@uni.edu', 'responder2@uni.edu']);

Параметры

Имя Тип Описание
email Addresses String[] Массив адресов электронной почты пользователей, которых нужно добавить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addRatingItem()

Добавляет новый вопрос, позволяющий респонденту поставить оценку.

// 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();

Возвращаться

RatingItem — Вновь созданный товар.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addScaleItem()

Добавляет новый вопрос, позволяющий респонденту выбрать один вариант из пронумерованной последовательности переключателей.

// 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');

Возвращаться

ScaleItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addSectionHeaderItem()

Добавляет новый элемент макета, который визуально обозначает начало раздела.

// 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');

Возвращаться

SectionHeaderItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addTextItem()

Добавляет новый вопрос, позволяющий респонденту ввести одну строку текста.

// 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?');

Возвращаться

TextItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addTimeItem()

Добавляет новый вопрос, позволяющий респонденту указать время суток.

// 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?');

Возвращаться

TimeItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

addVideoItem()

Добавляет новый элемент макета, отображающий видео.

// 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);

Возвращаться

VideoItem — Вновь созданный элемент.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

canEditResponse()

Определяет, будет ли в форме отображаться ссылка для редактирования ответа после его отправки.

Независимо от этой настройки, метод FormResponse.getEditResponseUrl() позволяет автору скрипта, имеющему доступ к редактированию формы, сгенерировать 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.
// 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);

Возвращаться

Booleantrue если в форме отображается ссылка «Редактировать ответ»; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

collectsEmail()

Определяет, собирает ли форма адреса электронной почты респондентов.

// 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);

Возвращаться

Booleantrue если форма собирает адреса электронной почты; false , если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

createResponse()

Создает новый ответ на форму. Чтобы ответить на вопрос, создайте объект ItemResponse из этого вопроса, а затем прикрепите его к этому ответу формы, вызвав метод FormResponse.withItemResponse(response) . Чтобы сохранить собранный ответ, вызовите FormResponse.submit() .

Возвращаться

FormResponse — Вновь созданный ответ формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

deleteAllResponses()

Удаляет все отправленные ответы из хранилища ответов формы. Этот метод не удаляет копии ответов, хранящиеся во внешнем хранилище ответов (например, в электронной таблице), но очищает сводную информацию в форме.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

deleteItem(index)

Удаляет элемент по заданному индексу среди всех элементов формы. Генерирует исключение скрипта, если элемент по заданному индексу отсутствует.

// 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);
}

Параметры

Имя Тип Описание
index Integer Индекс элемента среди всех элементов в форме.

Броски

Error — если элемент по указанному индексу отсутствует.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

deleteItem(item)

Удаляет указанный элемент. Генерирует исключение скрипта, если элемент уже был удален.

// 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);
}

Параметры

Имя Тип Описание
item Item Элемент, который необходимо удалить.

Броски

Error — если элемент не существует в форме.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

deleteResponse(responseId)

Удаляет один ответ из хранилища ответов формы. Этот метод не удаляет копии ответов, хранящиеся во внешнем хранилище ответов (например, в электронной таблице), но удаляет ответ из сводного представления формы. Идентификатор ответа можно получить с помощью FormResponse.getId() .

Параметры

Имя Тип Описание
response Id String Идентификатор ответа формы, который нужно удалить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getConfirmationMessage()

Получает подтверждающее сообщение из формы.

// 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);

Возвращаться

String — сообщение с подтверждением заполнения формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getCustomClosedFormMessage()

Получает пользовательское сообщение, отображаемое, если форма не принимает ответы, или пустую строку, если пользовательское сообщение не задано.

// 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);

Возвращаться

String — пользовательское сообщение, которое будет отображаться, если форма не принимает ответы, или пустая строка, если пользовательское сообщение не задано.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getDescription()

Получает описание формы.

// 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);

Возвращаться

String — Описание формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getDestinationId()

Получает идентификатор адреса получателя ответа формы.

// 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);

Возвращаться

String — Идентификатор адресата ответа формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getDestinationType()

Получает тип адресата ответа формы.

// 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);

Возвращаться

DestinationType — Тип адресата ответа формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getEditUrl()

Получает URL-адрес, который можно использовать для доступа к режиму редактирования формы.

// 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);

Возвращаться

String — URL-адрес формы для редактирования.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getEditors()

Получает список редакторов для этой Form .

Возвращаться

User[] — Массив пользователей с правами на редактирование.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getId()

Получает идентификатор формы.

// 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);

Возвращаться

String — Идентификатор формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getItemById(id)

Получает элемент с заданным ID. Возвращает null если ID не соответствует элементу в форме.

// 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);

Параметры

Имя Тип Описание
id Integer Идентификатор товара.

Возвращаться

Item |null — Элемент с заданным ID или null , если элемент отсутствует в форме.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getItems()

Получает массив всех элементов формы.

// 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);

Возвращаться

Item[] — Массив всех элементов в форме.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getItems(itemType)

Получает массив всех элементов заданного типа.

// 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);

Параметры

Имя Тип Описание
item Type Item Type Тип извлекаемых предметов.

Возвращаться

Item[] — Массив всех элементов этого типа.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getPublishedReaders()

Получает список респондентов, заполнивших эту Form .

// 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 responders for the form.
const users = form.getPublishedReaders();
users.forEach(user => console.log(user.getEmail()));

Возвращаться

User[] — Массив пользователей с правами ответчика.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getPublishedUrl()

Получает 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.
// 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);

Возвращаться

String — URL-адрес, который будет использоваться для ответа на форму.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getResponse(responseId)

Получает один ответ формы на основе его идентификатора. Идентификаторы ответов можно получить с помощью FormResponse.getId() .

Параметры

Имя Тип Описание
response Id String Идентификатор ответа на форму.

Возвращаться

FormResponse — Форма ответа.

Броски

Error — если ответ не существует.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getResponses()

Получает массив всех ответов на форму.

Возвращаться

FormResponse[] — Массив всех ответов, полученных с помощью этой формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getResponses(timestamp)

Получает массив всех ответов на форму, полученных после указанной даты и времени.

Параметры

Имя Тип Описание
timestamp Date Укажите самую раннюю дату и время, к которым следует отправить ответы на заполненную форму.

Возвращаться

FormResponse[] — Список ответов формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getShuffleQuestions()

Определяет, будет ли порядок вопросов на каждой странице анкеты рандомизированным.

Возвращаться

Booleantrue если порядок вопросов на каждой странице анкеты случайный; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getSummaryUrl()

Получает URL-адрес, который можно использовать для просмотра сводки ответов на форму. Если setPublishingSummary(enabled) не установлен в true , доступ к 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);

Возвращаться

String — URL-адрес для просмотра сводки ответов.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

getTitle()

Получает заголовок формы.

// 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);

Возвращаться

String — Заголовок формы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

hasLimitOneResponsePerUser()

Определяет, допускает ли форма только один ответ от респондента. Если значение равно true , скрипт вообще не сможет отправить ответы из формы.

Возвращаться

Booleantrue если форма допускает только один ответ от респондента; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

hasProgressBar()

Определяет, будет ли форма отображать индикатор выполнения.

// 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());

Возвращаться

Booleantrue если форма отображает индикатор выполнения; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

Определяет, будет ли в форме отображаться ссылка для отправки дополнительного ответа после заполнения формы респондентом.

// 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());

Возвращаться

Booleantrue если в форме отображается ссылка «Отправить другой ответ»; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

isAcceptingResponses()

Определяет, принимает ли форма в данный момент ответы. Это значение перезаписывается при изменении состояния публикации формы.

// 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);

Возвращаться

Booleantrue если форма принимает ответы; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

isPublished()

Определяет, будет ли форма опубликована.

Эта функция доступна только для форм, поддерживающих публикацию. Используйте supportsAdvancedResponderPermissions() , чтобы проверить, поддерживает ли форма публикацию.

// 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 whether the form is published or not and logs it to the console.
console.log(form.isPublished());

Возвращаться

Booleantrue если форма опубликована; false если нет.

Броски

Error — если вызывается для неподдерживаемых форм.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

isPublishingSummary()

Определяет, будет ли в форме отображаться ссылка для просмотра сводки ответов после заполнения формы респондентом.

// 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);

Возвращаться

Booleantrue если в форме отображается ссылка «Посмотреть предыдущие ответы»; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

isQuiz()

Определяет, является ли форма тестом.

// 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());

Возвращаться

Booleantrue если форма принимает ответы; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

moveItem(from, to)

Перемещает элемент с заданным индексом среди всех элементов формы на другой заданный индекс. Генерирует исключение скрипта, если индекс выходит за пределы to диапазона.

// 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);

Параметры

Имя Тип Описание
from Integer Текущий индекс элемента среди всех элементов в форме.
to Integer Новый индекс для элемента среди всех элементов в форме.

Возвращаться

Item — предмет, который был перемещен.

Броски

Error — если какой-либо из индексов выходит за пределы допустимого диапазона.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

moveItem(item, toIndex)

Перемещает заданный элемент по заданному индексу среди всех элементов формы. Генерирует исключение скрипта, если заданный индекс выходит за пределы допустимого диапазона.

// 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);

Параметры

Имя Тип Описание
item Item Предмет, который нужно переместить.
to Index Integer Новый индекс для элемента среди всех элементов в форме.

Возвращаться

Item — предмет, который был перемещен.

Броски

Error — если индекс выходит за пределы допустимого диапазона.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

removeDestination()

Отключает форму от текущего места назначения ответов. Отключенное предыдущее место назначения по-прежнему сохраняет копию всех предыдущих ответов. Все формы, включая те, у которых место назначения не указано явно, сохраняют копию ответов в хранилище ответов формы . Если у формы в данный момент нет места назначения ответов, этот метод не оказывает никакого эффекта.

// 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();

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

removeEditor(emailAddress)

Удаляет указанного пользователя из списка редакторов Form . Этот метод не блокирует доступ пользователей к Form , если они относятся к категории пользователей с общим доступом — например, если Form доступна всему домену пользователя или если Form находится на общем диске, к которому пользователь имеет доступ.

Для файлов в Google Диске это также удаляет пользователя из списка пользователей, просматривающих и отвечающих на запросы.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Removes the editor from the form.
// TODO(developer): replace the emailAddress.
form.removeEditor('editor@uni.edu');

Параметры

Имя Тип Описание
email Address String Адрес электронной почты пользователя, которого нужно удалить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

removeEditor(user)

Удаляет указанного пользователя из списка редакторов Form . Этот метод не блокирует доступ пользователей к Form , если они относятся к категории пользователей с общим доступом — например, если Form доступна всему домену пользователя или если Form находится на общем диске, к которому пользователь имеет доступ.

Для файлов в Google Диске это также удаляет пользователя из списка просматриваемых файлов.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the editors from the form.
const users = form1.getEditors();

// Opens another form.
// TODO(developer): Replace the URL with your own.
const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit');

// Removes editors from the form.
users.forEach(user => form2.removeEditor(user));

Параметры

Имя Тип Описание
user User Изображение пользователя, которое нужно удалить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

removePublishedReader(emailAddress)

Удаляет указанного пользователя из списка участников, отвечающих на вопросы Form . Этот метод не блокирует доступ пользователей к Form , если они относятся к категории пользователей с общим доступом — например, если Form доступна всему домену пользователя или если Form находится на общем диске, к которому пользователь имеет доступ.

Для файлов в Google Диске это также удаляет пользователя из списка программ просмотра и редактирования.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Removes the responders from the form.
// TODO(developer): replace the emailAddress.
form.removePublishedReader('responder1@uni.edu');

Параметры

Имя Тип Описание
email Address String Адрес электронной почты пользователя, которого нужно удалить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

removePublishedReader(user)

Удаляет указанного пользователя из списка участников, отвечающих на вопросы Form . Этот метод не блокирует доступ пользователей к Form , если они относятся к категории пользователей с общим доступом — например, если Form доступна всему домену пользователя или если Form находится на общем диске, к которому пользователь имеет доступ.

Для файлов в Google Диске это также удаляет пользователя из списка программ просмотра и редактирования.

// Opens the Forms file by its URL.
// TODO(developer): Replace the URL with your own.
const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the responders from the form.
const users = form1.getPublishedReaders();

// Opens another form.
// TODO(developer): Replace the URL with your own.
const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit');

// Removes responders from the form.
users.forEach(user => form2.removePublishedReader(user));

Параметры

Имя Тип Описание
user User Изображение пользователя, которое нужно удалить.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setAcceptingResponses(enabled)

Определяет, принимает ли форма в данный момент ответы. По умолчанию для новых форм значение равно 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());

Параметры

Имя Тип Описание
enabled Boolean true если форма должна принимать ответы; false если не должна.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Броски

Error — если эта функция включена в неопубликованной форме.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setAllowResponseEdits(enabled)

Определяет, будет ли форма отображать ссылку для редактирования ответа после его отправки. По умолчанию для новых форм значение равно false .

Независимо от этой настройки, метод FormResponse.getEditResponseUrl() позволяет автору скрипта, имеющему права на редактирование формы, сгенерировать 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.
// 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());

Параметры

Имя Тип Описание
enabled Boolean true указывает, что форма должна отображать ссылку «Редактировать свой ответ»; false — в противном случае.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setCollectEmail(collect)

Определяет, будет ли форма собирать адреса электронной почты респондентов. По умолчанию для новых форм установлено значение 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);

Параметры

Имя Тип Описание
collect Boolean true указывает на необходимость сбора адресов электронной почты через форму; значение false — на необходимость.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setConfirmationMessage(message)

Устанавливает сообщение с подтверждением для формы.

// 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);

Параметры

Имя Тип Описание
message String Новое подтверждающее сообщение в форме.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setCustomClosedFormMessage(message)

Задает сообщение, которое будет отображаться, если форма не принимает ответы. Если сообщение не задано, форма использует сообщение по умолчанию.

// 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);

Параметры

Имя Тип Описание
message String Сообщение, которое отображается, если форма не принимает ответы.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setDescription(description)

Задает описание формы.

Параметры

Имя Тип Описание
description String Новое описание формы.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setDestination(type, id)

Задает место сохранения ответов на форму. Все формы, включая те, для которых место сохранения не указано явно, сохраняют копию ответов в хранилище ответов формы .

Параметры

Имя Тип Описание
type Destination Type Тип адресата ответа формы.
id String Идентификатор адресата ответа формы.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Броски

Error — если указанный идентификатор назначения недействителен.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setIsQuiz(enabled)

Определяет, является ли форма викториной. По умолчанию для новых форм значение равно false .

Вопросы с оценкой разрешены только в викторинах, поэтому установка этого параметра в значение 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',
);

// 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());

Параметры

Имя Тип Описание
enabled Boolean true , если для формы должны быть включены функции викторины; false если нет.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setLimitOneResponsePerUser(enabled)

Определяет, разрешает ли форма только один ответ от респондента. По умолчанию для новых форм значение равно false . Если значение установлено на true , скрипт вообще не сможет отправлять ответы из формы.

Параметры

Имя Тип Описание
enabled Boolean true если форма допускает только один ответ от респондента; false если нет.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setProgressBar(enabled)

Определяет, будет ли у формы индикатор выполнения. По умолчанию для новых форм значение равно 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());

Параметры

Имя Тип Описание
enabled Boolean true если форма отображает индикатор выполнения; false если нет.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setPublished(enabled)

Определяет, будет ли форма опубликована. По умолчанию для новых форм значение равно true .

Эта функция доступна только для форм, поддерживающих публикацию. Используйте supportsAdvancedResponderPermissions() , чтобы проверить, поддерживает ли форма публикацию.

Для того чтобы форма стала доступна участникам, отвечающим на вопросы, её необходимо опубликовать. Этот метод отменяет вызовы метода setAcceptingResponses(enabled) .

// 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',
);

// Publishes the form before sharing it.
form.setPublished(true);

// Checks whether the form is published or not and logs it to the console.
console.log(form.isPublished());

Параметры

Имя Тип Описание
enabled Boolean Если форма должна быть опубликована, то true равно false .

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Броски

Error — если вызывается для неподдерживаемых форм.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setPublishingSummary(enabled)

Определяет, будет ли форма отображать ссылку для просмотра сводки ответов после отправки формы респондентом. По умолчанию для новых форм значение равно false .

Параметры

Имя Тип Описание
enabled Boolean true указывает, что форма должна отображать ссылку «Посмотреть предыдущие ответы»; false — в противном случае.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setShowLinkToRespondAgain(enabled)

Определяет, будет ли форма отображать ссылку для отправки дополнительного ответа после заполнения формы респондентом. По умолчанию для новых форм значение равно true .

Параметры

Имя Тип Описание
enabled Boolean true , если в форме должна отображаться ссылка «Отправить еще один ответ»; false в противном случае.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setShuffleQuestions(shuffle)

Определяет, будет ли порядок вопросов на каждой странице анкеты рандомизирован.

Параметры

Имя Тип Описание
shuffle Boolean true , если порядок вопросов на каждой странице анкеты должен быть случайным; false если нет.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setTitle(title)

Задает заголовок формы.

Параметры

Имя Тип Описание
title String Новое название формы.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

shortenFormUrl(url)

Преобразует длинный URL-адрес формы в короткий. Генерирует исключение, если длинный URL-адрес не относится к Google Forms.

Параметры

Имя Тип Описание
url String URL-адрес для сокращения.

Возвращаться

String — URL-адрес в формате http://goo.gl/forms/1234 .

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

submitGrades(responses)

Выставляет оценки за предоставленные ответы в форме.

Если ваш код содержит триггер onFormSubmit , вызов submitGrades() запускает условие onFormSubmit и вызывает бесконечный цикл. Чтобы предотвратить бесконечный цикл, добавьте код, который проверяет, существуют ли оценки уже, прежде чем вызывать submitGrades() .

Параметры

Имя Тип Описание
responses Form Response[] Массив всех ответов, полученных в ходе заполнения формы.

Возвращаться

Form — Эта Form предназначена для создания цепочек.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

supportsAdvancedResponderPermissions()

Определяет, поддерживает ли форма публикацию. Этот метод используется для определения доступности методов setPublished(enabled) и isPublished() , а также прав доступа обработчика событий.

// 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 whether the form supports publishing or not and logs it to the
// console.
console.log(form.supportsAdvancedResponderPermissions());

Возвращаться

Booleantrue если форма поддерживает публикацию; false если нет.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

Устаревшие методы