이 페이지는 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`	광고에서 유효성 검사를 설정하는 데 사용할 수 있는 CheckboxGridValidationBuilder 인스턴스를 반환합니다. `CheckboxGridItem`
`createCheckboxValidation()`	`CheckboxValidationBuilder`	유효성 검사를 설정하는 데 사용할 수 있는 CheckboxValidationBuilder의 인스턴스를 반환합니다. `CheckboxItem`
`createFeedback()`	`QuizFeedbackBuilder`	채점 가능한 항목에 피드백을 설정하는 데 사용할 수 있는 QuizFeedbackBuilder의 인스턴스를 반환합니다. `Item`
`createGridValidation()`	`GridValidationBuilder`	`GridItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 GridValidationBuilder의 인스턴스를 반환합니다.
`createParagraphTextValidation()`	`ParagraphTextValidationBuilder`	유효성 검사를 설정하는 데 사용할 수 있는 ParagraphTextValidationBuilder 인스턴스를 반환합니다. `ParagraphTextItem`
`createTextValidation()`	`TextValidationBuilder`	`TextItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 TextValidationBuilder 인스턴스를 반환합니다.
`getActiveForm()`	`Form`	스크립트가 컨테이너에 결합된 형식을 반환합니다.
`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`	새 양식의 이름

리턴

Form: 새 양식

생성 값

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

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

`createCheckboxGridValidation()`

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

리턴

CheckboxGridValidationBuilder

`createCheckboxValidation()`

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

리턴

CheckboxValidationBuilder

`createFeedback()`

채점 가능한 항목에 피드백을 설정하는 데 사용할 수 있는 QuizFeedbackBuilder의 인스턴스를 반환합니다. Item

리턴

QuizFeedbackBuilder

`createGridValidation()`

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

리턴

GridValidationBuilder

`createParagraphTextValidation()`

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

리턴

ParagraphTextValidationBuilder

`createTextValidation()`

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

리턴

TextValidationBuilder

`getActiveForm()`

스크립트가 컨테이너에 결합된 양식을 반환합니다. 사용자에게 제공되는 양식과 스크립트가 컨테이너에 결합되지 않았습니다. openById(id) 또는 openByUrl(url)를 사용하세요. 하세요.

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

리턴

Form: 스크립트가 바인딩된 형식 또는 스크립트가 바인딩되지 않은 경우에는 null입니다. 양식

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

`getUi()`

스크립트가 다음 작업을 수행할 수 있도록 하는 양식 편집기의 사용자 인터페이스 환경 인스턴스를 반환합니다. 메뉴, 대화상자 및 사이드바와 같은 기능을 추가할 수 있습니다. 스크립트는 응답자가 보는 뷰가 아닌 열려 있는 양식 편집기의 현재 인스턴스이며, 스크립트가 양식에 바인딩되어 있는지 확인합니다. 자세한 내용은 메뉴 및 대화상자 및 사이드바 가이드를 참고하세요.

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

리턴

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

`openById(id)`

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

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

매개변수

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

리턴

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

리턴

Form: 지정된 URL이 있는 양식

생성 값

Error: 지정된 URL이 잘못되었거나 사용자에게 충분한 정보가 없는 경우 권한

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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