Чтобы добавить содержимое в форму или обновить настройки, метаданные или содержимое, используйте метод batchUpdate()
, который группирует изменения в пакет, так что в случае сбоя одного запроса ни одно из других (потенциально зависимых) изменений не записывается.
Метод batchUpdate()
возвращает тело ответа, внутри которого находится ответ на каждый запрос. Каждый ответ занимает тот же индекс, что и соответствующий запрос; для запросов без применимого ответа ответ по этому индексу будет пустым.
Прежде чем вы начнете
Прежде чем приступить к выполнению задач на этой странице, выполните следующие задачи:
- Полная авторизация/аутентификация и настройка учетных данных в инструкциях программы раннего доступа.
Обновить метаданные, настройки или элементы
В следующем примере показано, как обновить метаданные формы, но структура содержимого и настроек одинакова — они используют запросы updateItem
или updateSettings
вместо updateFormInfo
. Для каждого запроса вы указываете имя поля, которое нужно изменить, и обновленное значение, а также значение updateMask
, чтобы ограничить изменения в указанных вами полях.
ОТДЫХ
Чтобы обновить описание формы, вызовите метод batchUpdate()
с идентификатором формы и обновленным значением описания.
Пример тела запроса
"requests": [{
"updateFormInfo": {
"info": {
"description": "Please complete this quiz based on this week's readings for class."
},
"updateMask": "description"
}
}]
Питон
Node.js
Добавить элемент
В следующем примере показано, как добавить новое содержимое в форму. При добавлении нового контента вы должны указать место с индексом, куда следует вставить новый контент. Например, местоположение с индексом 0
вставит содержимое в начало формы.
ОТДЫХ
Чтобы добавить элемент в форму, вызовите метод batchUpdate()
, указав идентификатор формы, информацию об элементе и желаемое местоположение.
Пример тела запроса
"requests": [{
"createItem": {
"item": {
"title": "Homework video",
"description": "Quizzes in Google Forms",
"videoItem": {
"video": {
"youtubeUri": "https://www.youtube.com/watch?v=Lt5HqPvM-eI"
}
}},
"location": {
"index": 0
}
}]
Питон
Node.js
Порядок запроса
Метод batchUpdate()
принимает массив подзапросов, таких как createItem
и updateItem
. Подзапросы проверяются по одному в порядке их предоставления.
Пример. Запрос batchUpdate
содержит массив requests
с двумя подзапросами createItem
. Подзапрос A имеет location.index
0, а подзапрос B имеет location.index
1. Если массив requests
равен [A, B], batchUpdate
завершится успешно. Если массив равен [B, A], batchUpdate
завершится ошибкой, поскольку location.index
1 недействителен, если форма уже не содержит элемент с индексом 0.