이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class FormApp

스크립트가 기존 Form을 열거나 새 Form를 만들도록 허용합니다.

// Open a form by ID.
var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
var newForm = FormApp.create('Form Name');

속성

속성	유형	설명
`Alignment`	`Alignment`	이미지 정렬 유형의 열거형입니다.
`DestinationType`	`DestinationType`	양식 응답을 저장할 수 있는 대상 유형의 열거형입니다.
`FeedbackType`	`FeedbackType`	`Feedbacks` 형식 유형의 열거형입니다.
`ItemType`	`ItemType`	`Items` 형식 유형의 열거형입니다.
`PageNavigationType`	`PageNavigationType`	페이지 탐색에 사용 가능한 동작의 열거형입니다.

메서드

메서드	반환 유형	간략한 설명
`create(title)`	`Form`	새 `Form`를 만들고 반환합니다.
`createCheckboxGridValidation()`	`CheckboxGridValidationBuilder`	`CheckboxGridItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 CheckboxGridValidationBuilder의 인스턴스를 반환합니다.
`createCheckboxValidation()`	`CheckboxValidationBuilder`	`CheckboxItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 CheckboxValidationBuilder의 인스턴스를 반환합니다.
`createFeedback()`	`QuizFeedbackBuilder`	채점 가능한 `Item`에 관한 의견을 설정하는 데 사용할 수 있는 QuestFeedbackBuilder의 인스턴스를 반환합니다.
`createGridValidation()`	`GridValidationBuilder`	`GridItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 GridValidationBuilder의 인스턴스를 반환합니다.
`createParagraphTextValidation()`	`ParagraphTextValidationBuilder`	`ParagraphTextItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 ParagraphTextValidationBuilder 인스턴스를 반환합니다.
`createTextValidation()`	`TextValidationBuilder`	`TextItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 TextValidationBuilder 인스턴스를 반환합니다.
`getActiveForm()`	`Form`	스크립트가 container-bound인 양식을 반환합니다.
`getUi()`	`Ui`	스크립트가 메뉴, 대화상자, 사이드바 등의 기능을 추가할 수 있도록 양식 편집기의 사용자 인터페이스 환경의 인스턴스를 반환합니다.
`openById(id)`	`Form`	지정된 ID가 있는 `Form`를 반환합니다.
`openByUrl(url)`	`Form`	지정된 URL과 함께 `Form`를 반환합니다.

자세한 문서

`create(title)`

새 Form를 만들고 반환합니다. 지정된 제목이 null이거나 비어 있는 경우 예외가 발생합니다.

// Create and open a form.
var form = FormApp.create('Form Name');

매개변수

이름	유형	설명
`title`	`String`	새 양식의 이름

Return

Form: 새 양식

예외 처리

Error: 지정된 제목이 null이거나 비어 있는 경우

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

`createCheckboxGridValidation()`

CheckboxGridItem에서 유효성 검사를 설정하는 데 사용할 수 있는 CheckboxGridValidationBuilder의 인스턴스를 반환합니다.

Return

CheckboxGridValidationBuilder

`createCheckboxValidation()`

CheckboxItem에서 유효성 검사를 설정하는 데 사용할 수 있는 CheckboxValidationBuilder의 인스턴스를 반환합니다.

Return

CheckboxValidationBuilder

`createFeedback()`

채점 가능한 Item에 관한 의견을 설정하는 데 사용할 수 있는 QuestFeedbackBuilder의 인스턴스를 반환합니다.

Return

QuizFeedbackBuilder

`createGridValidation()`

GridItem에서 유효성 검사를 설정하는 데 사용할 수 있는 GridValidationBuilder의 인스턴스를 반환합니다.

Return

GridValidationBuilder

`createParagraphTextValidation()`

ParagraphTextItem에서 유효성 검사를 설정하는 데 사용할 수 있는 ParagraphTextValidationBuilder 인스턴스를 반환합니다.

Return

ParagraphTextValidationBuilder

`createTextValidation()`

TextItem에서 유효성 검사를 설정하는 데 사용할 수 있는 TextValidationBuilder 인스턴스를 반환합니다.

Return

TextValidationBuilder

`getActiveForm()`

스크립트가 container-bound인 양식을 반환합니다. 스크립트가 컨테이너에 종속되지 않은 형식과 상호작용하려면 대신 openById(id) 또는 openByUrl(url)를 사용하세요.

// Get the form to which this script is bound.
var form = FormApp.getActiveForm();

Return

Form: 스크립트가 바인딩되는 양식 또는 스크립트가 양식에 바인딩되지 않은 경우 null

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

`getUi()`

스크립트가 메뉴, 대화상자, 사이드바 등의 기능을 추가할 수 있도록 양식 편집기의 사용자 인터페이스 환경의 인스턴스를 반환합니다. 스크립트는 응답자가 보는 뷰가 아닌 열려 있는 양식 편집기의 현재 인스턴스에 대한 UI와 상호작용할 수 있으며, 스크립트가 양식에 결합된 경우에만 가능합니다. 자세한 내용은 메뉴, 대화상자 및 사이드바 가이드를 참고하세요.

// Add a custom menu to the active form, including a separator and a sub-menu.
function onOpen(e) {
  FormApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(FormApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Return

Ui: 이 양식의 사용자 인터페이스 환경 인스턴스

`openById(id)`

지정된 ID가 있는 Form를 반환합니다. ID가 잘못되었거나 사용자에게 양식을 열 권한이 없는 경우 예외가 발생합니다.

// Open a form by ID.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

매개변수

이름	유형	설명
`id`	`String`	열려는 양식의 ID

Return

Form: 지정된 ID가 있는 양식

예외 처리

Error: 지정된 ID가 유효하지 않거나 사용자에게 충분한 권한이 없는 경우

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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

`openByUrl(url)`

지정된 URL과 함께 Form를 반환합니다. URL이 잘못되었거나 사용자에게 양식을 열 권한이 없는 경우 예외가 발생합니다.

// Open a form by URL.
var form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit'
    );

매개변수

이름	유형	설명
`url`	`String`	열려는 양식의 URL

Return

Form: 지정된 URL이 있는 양식

예외 처리

Error: 지정된 URL이 유효하지 않거나 사용자에게 충분한 권한이 없는 경우

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.

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