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

Class FormApp

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

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

// Create and open a form.
const 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`에 대한 의견을 설정하는 데 사용할 수 있는 QuizFeedbackBuilder 인스턴스를 반환합니다.
`createGridValidation()`	`GridValidationBuilder`	`GridItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 GridValidationBuilder 인스턴스를 반환합니다.
`createParagraphTextValidation()`	`ParagraphTextValidationBuilder`	`ParagraphTextItem`에서 유효성 검사를 설정하는 데 사용할 수 있는 ParagraphTextValidationBuilder 인스턴스를 반환합니다.
`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.
const form = FormApp.create('Form Name');

매개변수

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

리턴

Form: 새 양식

생성 값

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

승인

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

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

`createCheckboxGridValidation()`

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

리턴

CheckboxGridValidationBuilder

`createCheckboxValidation()`

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

리턴

CheckboxValidationBuilder

`createFeedback()`

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

리턴

QuizFeedbackBuilder

`createGridValidation()`

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

리턴

GridValidationBuilder

`createParagraphTextValidation()`

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

리턴

ParagraphTextValidationBuilder

`createTextValidation()`

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

리턴

TextValidationBuilder

`getActiveForm()`

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

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

리턴

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

리턴

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

`openById(id)`

지정된 ID가 있는 Form를 반환합니다. ID가 유효하지 않거나 사용자에게 양식을 열 권한이 없는 경우 예외를 발생시킵니다.

// Open a form by ID.
const 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.
const 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