Class Form

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
양식

전체 속성 및 항목이 포함된 양식 속성에는 제목, 설정, 응답이 저장되는 위치가 포함됩니다. 항목에는 체크박스 또는 라디오 항목과 같은 질문 항목이 포함되며 레이아웃 항목은 페이지 나누기와 같은 항목을 의미합니다. FormApp에서 양식에 액세스하거나 양식을 작성할 수 있습니다.

// Open a form by ID and create a new spreadsheet.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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());

메서드

메서드반환 유형간략한 설명
addCheckboxGridItem()CheckboxGridItem응답자가 체크박스 시퀀스에서 행당 여러 개 선택지를 선택할 수 있는 열과 행의 그리드로 표시되는 새 질문 항목을 추가합니다.
addCheckboxItem()CheckboxItem응답자가 하나 이상의 체크박스를 선택할 수 있는 새로운 질문 항목과 '기타' 필드를 선택사항으로 선택할 수 있도록 추가합니다.
addDateItem()DateItem응답자가 날짜를 나타낼 수 있는 새 질문 항목을 추가합니다.
addDateTimeItem()DateTimeItem응답자가 날짜 및 시간을 나타낼 수 있는 새 질문 항목을 추가합니다.
addDurationItem()DurationItem응답자가 시간을 나타낼 수 있는 새 질문 항목을 추가합니다.
addEditor(emailAddress)Form지정된 사용자를 Form의 편집자 목록에 추가합니다.
addEditor(user)Form지정된 사용자를 Form의 편집자 목록에 추가합니다.
addEditors(emailAddresses)Form지정된 사용자 배열을 Form의 편집자 목록에 추가합니다.
addGridItem()GridItem응답자가 라디오 버튼 시퀀스에서 행당 하나의 선택 항목을 선택할 수 있는 열과 행의 그리드로 표시되는 새 질문 항목을 추가합니다.
addImageItem()ImageItem이미지를 표시하는 새 레이아웃 항목을 추가합니다.
addListItem()ListItem응답자가 드롭다운 목록에서 하나의 선택사항을 선택할 수 있는 새로운 질문 항목을 추가합니다.
addMultipleChoiceItem()MultipleChoiceItem응답자가 라디오 목록 또는 선택사항 '기타' 필드 중에서 한 가지 선택지를 선택할 수 있게 하는 새로운 질문 항목을 추가합니다.
addPageBreakItem()PageBreakItem페이지의 시작을 표시하는 새 레이아웃 항목을 추가합니다.
addParagraphTextItem()ParagraphTextItem응답자가 텍스트 블록을 입력할 수 있는 새 질문 항목을 추가합니다.
addScaleItem()ScaleItem응답자가 라디오 버튼의 번호가 매겨진 시퀀스에서 옵션 하나를 선택할 수 있는 새 질문 항목을 추가합니다.
addSectionHeaderItem()SectionHeaderItem섹션의 시작을 시각적으로 나타내는 새 레이아웃 항목을 추가합니다.
addTextItem()TextItem응답자가 한 줄의 텍스트를 입력할 수 있는 새 질문 항목을 추가합니다.
addTimeItem()TimeItem응답자가 하루 중 특정 시간을 나타낼 수 있는 새 질문 항목을 추가합니다.
addVideoItem()VideoItem동영상을 표시하는 새 레이아웃 항목을 추가합니다.
canEditResponse()Boolean양식을 제출한 후 응답을 수정할 수 있는 링크를 표시하는지 여부를 결정합니다.
collectsEmail()Boolean양식에서 응답자의 이메일 주소를 수집할지 결정합니다.
createResponse()FormResponse양식에 관한 새 응답을 만듭니다.
deleteAllResponses()Form양식의 응답 저장소에서 제출된 모든 응답을 삭제합니다.
deleteItem(index)void양식의 모든 항목 중에서 특정 색인의 항목을 삭제합니다.
deleteItem(item)void지정된 항목을 삭제합니다.
deleteResponse(responseId)Form양식의 응답 저장소에서 단일 응답을 삭제합니다.
getConfirmationMessage()String양식의 확인 메시지를 가져옵니다.
getCustomClosedFormMessage()String양식이 응답을 수락하지 않는 경우에 표시될 맞춤 메시지를 가져오거나 맞춤 메시지가 설정되지 않은 경우 빈 문자열을 가져옵니다.
getDescription()String양식의 설명을 가져옵니다.
getDestinationId()String양식의 응답 대상 ID를 가져옵니다.
getDestinationType()DestinationType양식의 응답 대상 유형을 가져옵니다.
getEditUrl()String양식의 수정 모드에 액세스할 때 사용할 수 있는 URL을 가져옵니다.
getEditors()User[]Form의 편집자 목록을 가져옵니다.
getId()String양식의 ID를 가져옵니다.
getItemById(id)Item지정된 ID의 항목을 가져옵니다.
getItems()Item[]양식에 있는 모든 항목의 배열을 가져옵니다.
getItems(itemType)Item[]지정된 유형의 모든 항목 배열을 가져옵니다.
getPublishedUrl()String양식에 응답하는 데 사용할 수 있는 URL을 가져옵니다.
getResponse(responseId)FormResponse응답 ID를 기반으로 단일 양식 응답을 가져옵니다.
getResponses()FormResponse[]모든 양식의 응답 배열을 가져옵니다.
getResponses(timestamp)FormResponse[]지정된 날짜 및 시간 이후의 모든 양식 응답의 배열을 가져옵니다.
getShuffleQuestions()Boolean양식의 각 페이지에서 질문 순서를 무작위로 지정할지 결정합니다.
getSummaryUrl()String양식의 응답 요약을 보는 데 사용할 수 있는 URL을 가져옵니다.
getTitle()String양식의 제목을 가져옵니다.
hasLimitOneResponsePerUser()Boolean양식에서 응답자당 하나의 응답만 허용할지 결정합니다.
hasProgressBar()Boolean양식에 진행률 표시줄을 표시할지 결정합니다.
hasRespondAgainLink()Boolean응답자가 양식을 작성한 후 양식에 다른 응답을 제출할 수 있는 링크를 표시할지 결정합니다.
isAcceptingResponses()Boolean양식이 현재 응답을 수락하고 있는지 확인합니다.
isPublishingSummary()Boolean응답자가 양식을 작성한 후 응답 요약을 볼 수 있는 양식 링크를 표시할지 여부를 결정합니다.
isQuiz()Boolean양식이 퀴즈인지를 결정합니다.
moveItem(from, to)Item양식의 모든 항목 간에 지정된 색인의 항목을 다른 지정된 색인으로 이동합니다.
moveItem(item, toIndex)Item양식의 모든 항목 간에 지정된 색인으로 항목을 이동합니다.
removeDestination()Form현재 응답 대상에서 양식 연결을 해제합니다.
removeEditor(emailAddress)FormForm의 편집자 목록에서 지정된 사용자를 삭제합니다.
removeEditor(user)FormForm의 편집자 목록에서 지정된 사용자를 삭제합니다.
requiresLogin()Boolean응답하기 전에 응답자가 동일한 도메인이나 하위 도메인의 계정에 로그인하도록 요구하는지 여부를 결정합니다.
setAcceptingResponses(enabled)Form양식이 현재 응답을 수락하는지 여부를 설정합니다.
setAllowResponseEdits(enabled)Form제출 후 양식에서 응답을 수정할 수 있는 링크를 표시할지를 설정합니다.
setCollectEmail(collect)Form양식에서 응답자의 이메일 주소를 수집할지를 설정합니다.
setConfirmationMessage(message)Form양식의 확인 메시지를 설정합니다.
setCustomClosedFormMessage(message)Form양식이 응답을 수락하지 않는 경우 표시할 메시지를 설정합니다.
setDescription(description)Form양식의 설명을 설정합니다.
setDestination(type, id)Form양식 응답이 저장되는 대상을 설정합니다.
setIsQuiz(enabled)Form양식이 퀴즈인지 여부를 설정합니다.
setLimitOneResponsePerUser(enabled)Form양식에서 응답자당 하나의 응답만 허용할지를 설정합니다.
setProgressBar(enabled)Form양식에 진행률 표시줄이 있는지 여부를 설정합니다.
setPublishingSummary(enabled)Form응답자가 양식을 제출한 후에 양식에서 응답 요약을 볼 수 있도록 링크를 표시할지를 설정합니다.
setRequireLogin(requireLogin)Form양식에서 응답자가 동일한 도메인 또는 하위 도메인의 계정에 로그인해야 응답하도록 할지를 설정합니다.
setShowLinkToRespondAgain(enabled)Form응답자가 양식을 작성한 후 양식에 또 다른 응답을 제출할 수 있는 링크를 표시할지를 설정합니다.
setShuffleQuestions(shuffle)Form양식의 각 페이지에서 질문 순서를 무작위로 지정할지 설정합니다.
setTitle(title)Form양식의 제목을 설정합니다.
shortenFormUrl(url)String양식의 긴 URL을 단축 URL로 변환합니다.
submitGrades(responses)Form지정된 FormResponse의 성적을 제출합니다.

자세한 문서

addCheckboxGridItem()

응답자가 체크박스 시퀀스에서 행당 여러 개 선택지를 선택할 수 있는 열과 행의 그리드로 표시되는 새 질문 항목을 추가합니다.

Return

CheckboxGridItem: 새로 생성된 항목

승인

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

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

addCheckboxItem()

응답자가 하나 이상의 체크박스를 선택할 수 있는 새로운 질문 항목과 '기타' 필드를 선택사항으로 선택할 수 있도록 추가합니다.

Return

CheckboxItem: 새로 생성된 항목

승인

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

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

addDateItem()

응답자가 날짜를 나타낼 수 있는 새 질문 항목을 추가합니다.

Return

DateItem: 새로 생성된 항목

승인

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

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

addDateTimeItem()

응답자가 날짜 및 시간을 나타낼 수 있는 새 질문 항목을 추가합니다.

Return

DateTimeItem: 새로 생성된 항목

승인

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

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

addDurationItem()

응답자가 시간을 나타낼 수 있는 새 질문 항목을 추가합니다.

Return

DurationItem: 새로 생성된 항목

승인

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

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

addEditor(emailAddress)

지정된 사용자를 Form의 편집자 목록에 추가합니다. 사용자가 이미 목록에 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름유형설명
emailAddressString추가할 사용자의 이메일 주소입니다.

Return

Form: 체이닝을 위한 Form입니다.

승인

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

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

addEditor(user)

지정된 사용자를 Form의 편집자 목록에 추가합니다. 사용자가 이미 목록에 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름유형설명
userUser추가할 사용자의 표현입니다.

Return

Form: 체이닝을 위한 Form입니다.

승인

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

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

addEditors(emailAddresses)

지정된 사용자 배열을 Form의 편집자 목록에 추가합니다. 뷰어 목록에 이미 있는 사용자가 있는 경우 이 메서드는 뷰어 목록에서 사용자를 승격합니다.

매개변수

이름유형설명
emailAddressesString[]추가할 사용자의 이메일 주소 배열입니다.

Return

Form: 체이닝을 위한 Form입니다.

승인

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

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

addGridItem()

응답자가 라디오 버튼 시퀀스에서 행당 하나의 선택 항목을 선택할 수 있는 열과 행의 그리드로 표시되는 새 질문 항목을 추가합니다.

Return

GridItem: 새로 생성된 항목

승인

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

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

addImageItem()

이미지를 표시하는 새 레이아웃 항목을 추가합니다.

Return

ImageItem: 새로 생성된 항목

승인

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

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

addListItem()

응답자가 드롭다운 목록에서 하나의 선택사항을 선택할 수 있는 새로운 질문 항목을 추가합니다.

Return

ListItem: 새로 생성된 항목

승인

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

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

addMultipleChoiceItem()

응답자가 라디오 목록 또는 선택사항 '기타' 필드 중에서 한 가지 선택지를 선택할 수 있게 하는 새로운 질문 항목을 추가합니다.

Return

MultipleChoiceItem: 새로 생성된 항목

승인

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

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

addPageBreakItem()

페이지의 시작을 표시하는 새 레이아웃 항목을 추가합니다.

Return

PageBreakItem: 새로 생성된 항목

승인

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

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

addParagraphTextItem()

응답자가 텍스트 블록을 입력할 수 있는 새 질문 항목을 추가합니다.

Return

ParagraphTextItem: 새로 생성된 항목

승인

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

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

addScaleItem()

응답자가 라디오 버튼의 번호가 매겨진 시퀀스에서 옵션 하나를 선택할 수 있는 새 질문 항목을 추가합니다.

Return

ScaleItem: 새로 생성된 항목

승인

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

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

addSectionHeaderItem()

섹션의 시작을 시각적으로 나타내는 새 레이아웃 항목을 추가합니다.

Return

SectionHeaderItem: 새로 생성된 항목

승인

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

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

addTextItem()

응답자가 한 줄의 텍스트를 입력할 수 있는 새 질문 항목을 추가합니다.

Return

TextItem: 새로 생성된 항목

승인

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

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

addTimeItem()

응답자가 하루 중 특정 시간을 나타낼 수 있는 새 질문 항목을 추가합니다.

Return

TimeItem: 새로 생성된 항목

승인

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

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

addVideoItem()

동영상을 표시하는 새 레이아웃 항목을 추가합니다.

Return

VideoItem: 새로 생성된 항목

승인

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

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

canEditResponse()

양식을 제출한 후 응답을 수정할 수 있는 링크를 표시하는지 여부를 결정합니다.

이 설정에 관계없이 FormResponse.getEditResponseUrl() 메서드를 사용하면 양식에 대한 수정 액세스 권한이 있는 스크립트 작성자가 응답을 수정하는 데 사용할 수 있는 URL을 생성할 수 있습니다.

Return

Boolean — 양식에서 '응답 수정' 링크가 표시되면 true입니다. 그렇지 않으면 false입니다.

승인

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

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

collectsEmail()

양식에서 응답자의 이메일 주소를 수집할지 결정합니다.

Return

Boolean — 양식에서 이메일 주소를 수집하는 경우 true, 수집하지 않는 경우 false

승인

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

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

createResponse()

양식에 관한 새 응답을 만듭니다. 질문 항목에 답하려면 항목에서 ItemResponse을 만든 후 FormResponse.withItemResponse(response)를 호출하여 이 양식 응답에 연결합니다. 구성된 응답을 저장하려면 FormResponse.submit()를 호출합니다.

Return

FormResponse: 새로 생성된 양식 응답

승인

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

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

deleteAllResponses()

양식의 응답 저장소에서 제출된 모든 응답을 삭제합니다. 이 메서드는 외부 응답 대상 (예: 스프레드시트)에 저장된 응답의 사본을 삭제하지 않지만 양식의 요약 뷰를 지웁니다.

Return

Form: 이 Form, 체이닝용

승인

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

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

deleteItem(index)

양식의 모든 항목 중에서 특정 색인의 항목을 삭제합니다. 지정된 색인에 항목이 없으면 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
indexInteger양식의 모든 항목 중에서 상품의 색인

예외 처리

Error — 지정된 색인에 항목이 없는 경우

승인

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

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

deleteItem(item)

지정된 항목을 삭제합니다. 항목이 이미 삭제된 경우 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
itemItem삭제할 항목

예외 처리

Error: 항목이 양식에 없는 경우

승인

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

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

deleteResponse(responseId)

양식의 응답 저장소에서 단일 응답을 삭제합니다. 이 메서드는 외부 응답 대상 (예: 스프레드시트)에 저장된 응답의 사본을 삭제하지 않지만 양식의 요약 뷰에서 응답을 삭제합니다. 응답 ID는 FormResponse.getId()로 가져올 수 있습니다.

매개변수

이름유형설명
responseIdString삭제할 양식 응답의 ID

Return

Form: 이 Form, 체이닝용

승인

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

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

getConfirmationMessage()

양식의 확인 메시지를 가져옵니다.

Return

String: 양식의 확인 메시지

승인

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

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

getCustomClosedFormMessage()

양식이 응답을 수락하지 않는 경우에 표시될 맞춤 메시지를 가져오거나 맞춤 메시지가 설정되지 않은 경우 빈 문자열을 가져옵니다.

Return

String: 양식이 응답을 허용하지 않는 경우 표시될 맞춤 메시지이거나, 맞춤 메시지가 설정되지 않은 경우 빈 문자열입니다.

승인

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

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

getDescription()

양식의 설명을 가져옵니다.

Return

String: 양식 설명

승인

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

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

getDestinationId()

양식의 응답 대상 ID를 가져옵니다.

Return

String: 양식의 응답 대상 ID

승인

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

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

getDestinationType()

양식의 응답 대상 유형을 가져옵니다.

Return

DestinationType: 양식의 응답 대상 유형

승인

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

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

getEditUrl()

양식의 수정 모드에 액세스할 때 사용할 수 있는 URL을 가져옵니다.

Return

String: 양식을 수정할 URL입니다.

승인

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

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

getEditors()

Form의 편집자 목록을 가져옵니다.

Return

User[]: 수정 권한이 있는 사용자의 배열입니다.

승인

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

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

getId()

양식의 ID를 가져옵니다.

Return

String: 양식의 ID입니다.

승인

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

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

getItemById(id)

지정된 ID의 항목을 가져옵니다. ID가 양식의 항목과 일치하지 않으면 null를 반환합니다.

매개변수

이름유형설명
idInteger상품 ID

Return

Item: 지정된 ID가 있는 항목 또는 항목에 형식이 없는 경우 null입니다.

승인

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

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

getItems()

양식에 있는 모든 항목의 배열을 가져옵니다.

Return

Item[]: 양식에 있는 모든 항목의 배열입니다.

승인

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

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

getItems(itemType)

지정된 유형의 모든 항목 배열을 가져옵니다.

매개변수

이름유형설명
itemTypeItemType검색할 항목 유형

Return

Item[]: 해당 유형의 모든 항목의 배열

승인

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

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

getPublishedUrl()

양식에 응답하는 데 사용할 수 있는 URL을 가져옵니다.

Return

String: 양식에 응답할 URL입니다.

승인

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

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

getResponse(responseId)

응답 ID를 기반으로 단일 양식 응답을 가져옵니다. 응답 ID는 FormResponse.getId()에서 가져올 수 있습니다.

매개변수

이름유형설명
responseIdString양식 응답의 ID입니다.

Return

FormResponse — 양식 응답입니다.

예외 처리

Error — 응답이 없는 경우

승인

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

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

getResponses()

모든 양식의 응답 배열을 가져옵니다.

Return

FormResponse[]: 모든 형태의 응답 배열

승인

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

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

getResponses(timestamp)

지정된 날짜 및 시간 이후의 모든 양식 응답의 배열을 가져옵니다.

매개변수

이름유형설명
timestampDate양식 응답이 반환되어야 하는 가장 빠른 날짜 및 시간입니다.

Return

FormResponse[] — 양식 응답 목록입니다.

승인

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

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

getShuffleQuestions()

양식의 각 페이지에서 질문 순서를 무작위로 지정할지 결정합니다.

Return

Boolean: 양식의 각 페이지에서 질문 순서가 무작위인 경우 true, 그렇지 않은 경우 false입니다.

승인

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

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

getSummaryUrl()

양식의 응답 요약을 보는 데 사용할 수 있는 URL을 가져옵니다. setPublishingSummary(enabled)true로 설정하지 않는 한, 양식에 대한 수정 권한이 있는 사용자만 URL에 액세스할 수 있습니다.

Return

String: 응답 요약을 볼 수 있는 URL입니다.

승인

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

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

getTitle()

양식의 제목을 가져옵니다.

Return

String — 양식의 제목

승인

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

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

hasLimitOneResponsePerUser()

양식에서 응답자당 하나의 응답만 허용할지 결정합니다. 값이 true이면 스크립트에서 양식 응답을 전혀 제출할 수 없습니다.

Return

Boolean: 양식에서 응답자당 하나의 응답만 허용하는 경우 true, 허용되지 않는 경우 false

승인

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

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

hasProgressBar()

양식에 진행률 표시줄을 표시할지 결정합니다.

Return

Boolean — 양식에 진행률 표시줄이 표시되면 true, 표시되지 않으면 false입니다.

승인

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

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

응답자가 양식을 작성한 후 양식에 다른 응답을 제출할 수 있는 링크를 표시할지 결정합니다.

Return

Booleantrue 양식에 '다른 응답 제출' 링크가 표시되는 경우 false 그렇지 않은 경우

승인

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

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

isAcceptingResponses()

양식이 현재 응답을 수락하고 있는지 확인합니다.

Return

Boolean — 양식이 응답을 허용하는 경우 true, 동의하지 않는 경우 false입니다.

승인

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

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

isPublishingSummary()

응답자가 양식을 작성한 후 응답 요약을 볼 수 있는 양식 링크를 표시할지 여부를 결정합니다.

Return

Booleantrue 양식에 '이전 응답 보기' 링크가 표시되면 false 그렇지 않은 경우

승인

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

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

isQuiz()

양식이 퀴즈인지를 결정합니다.

Return

Boolean — 양식이 응답을 허용하는 경우 true, 동의하지 않는 경우 false입니다.

승인

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

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

moveItem(from, to)

양식의 모든 항목 간에 지정된 색인의 항목을 다른 지정된 색인으로 이동합니다. to 색인이 범위를 벗어나면 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
fromInteger양식의 모든 항목 중에서 항목의 현재 색인
toInteger양식의 모든 항목 중 새 색인

Return

Item: 이동된 항목

예외 처리

Error — 두 색인 중 하나라도 범위를 벗어난 경우

승인

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

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

moveItem(item, toIndex)

양식의 모든 항목 간에 지정된 색인으로 항목을 이동합니다. 지정된 색인이 범위를 벗어나면 스크립팅 예외가 발생합니다.

매개변수

이름유형설명
itemItem이동할 항목
toIndexInteger양식의 모든 항목 중 새 색인

Return

Item: 이동된 항목

예외 처리

Error — 색인이 범위를 벗어난 경우

승인

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

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

removeDestination()

현재 응답 대상에서 양식 연결을 해제합니다. 연결 해제된 이전 대상은 이전의 모든 응답 사본을 계속 유지합니다. 대상이 명시적으로 설정되지 않은 양식을 포함한 모든 양식은 양식의 응답 저장소에 응답 사본을 저장합니다. 현재 양식에 응답 대상이 없으면 이 메서드는 적용되지 않습니다.

Return

Form: 이 Form, 체이닝용

승인

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

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

removeEditor(emailAddress)

Form의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있는 경우(예: Form이 사용자의 전체 도메인과 공유되었거나 사용자가 액세스할 수 있는 공유 드라이브에 Form가 있는 경우) 사용자가 Form에 액세스하지 못하도록 차단하지 않습니다.

Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
emailAddressString삭제할 사용자의 이메일 주소입니다.

Return

Form: 체이닝을 위한 Form입니다.

승인

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

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

removeEditor(user)

Form의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속해 있는 경우(예: Form이 사용자의 전체 도메인과 공유되었거나 사용자가 액세스할 수 있는 공유 드라이브에 Form가 있는 경우) 사용자가 Form에 액세스하지 못하도록 차단하지 않습니다.

Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
userUser삭제할 사용자의 표현입니다.

Return

Form: 체이닝을 위한 Form입니다.

승인

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

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

requiresLogin()

응답하기 전에 응답자가 동일한 도메인이나 하위 도메인의 계정에 로그인하도록 요구하는지 여부를 결정합니다.

Return

Boolean — 양식에 사용자가 로그인해야 하는 경우 true, 그렇지 않은 경우 false


setAcceptingResponses(enabled)

양식이 현재 응답을 수락하는지 여부를 설정합니다. 새 양식의 기본값은 true입니다.

매개변수

이름유형설명
enabledBoolean양식이 응답을 수락해야 하는 경우 true, 허용되지 않는 경우 false

Return

Form: 이 Form, 체이닝용

승인

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

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

setAllowResponseEdits(enabled)

제출 후 양식에서 응답을 수정할 수 있는 링크를 표시할지를 설정합니다. 새 양식의 기본값은 false입니다.

이 설정과 관계없이 FormResponse.getEditResponseUrl() 메서드를 사용하면 양식에 대한 수정 권한이 있는 스크립트 작성자가 응답을 수정하는 데 사용할 수 있는 URL을 생성할 수 있습니다.

매개변수

이름유형설명
enabledBooleantrue 양식에 '응답 수정' 링크가 표시되어야 하는 경우 false 그렇지 않으면

Return

Form: 이 Form, 체이닝용

승인

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

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

setCollectEmail(collect)

양식에서 응답자의 이메일 주소를 수집할지를 설정합니다. 새 양식의 기본값은 false입니다.

매개변수

이름유형설명
collectBoolean양식에서 이메일 주소를 수집해야 하는 경우 true, 수집하지 않을 경우 false

Return

Form: 이 Form, 체이닝용

승인

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

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

setConfirmationMessage(message)

양식의 확인 메시지를 설정합니다.

매개변수

이름유형설명
messageString양식의 새로운 확인 메시지

Return

Form: 이 Form, 체이닝용

승인

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

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

setCustomClosedFormMessage(message)

양식이 응답을 수락하지 않는 경우 표시할 메시지를 설정합니다. 설정된 메시지가 없으면 양식에서 기본 메시지를 사용합니다.

매개변수

이름유형설명
messageString양식이 응답을 수락하지 않는 경우 표시할 메시지

Return

Form: 이 Form, 체이닝용

승인

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

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

setDescription(description)

양식의 설명을 설정합니다.

매개변수

이름유형설명
descriptionString양식의 새로운 설명

Return

Form: 이 Form, 체이닝용

승인

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

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

setDestination(type, id)

양식 응답이 저장되는 대상을 설정합니다. 대상을 명시적으로 설정하지 않은 양식을 포함한 모든 양식은 양식의 응답 저장소에 응답 사본을 저장합니다.

매개변수

이름유형설명
typeDestinationType양식의 응답 대상 유형
idString양식의 응답 대상 ID

Return

Form: 이 Form, 체이닝용

예외 처리

Error: 지정된 목적지 ID가 잘못된 경우

승인

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

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

setIsQuiz(enabled)

양식이 퀴즈인지 여부를 설정합니다. 새 양식의 기본값은 false입니다.

채점된 질문은 퀴즈에서만 허용되므로 false로 설정하면 모든 질문에서 모든 채점 옵션이 삭제됩니다.

퀴즈 설정은 새 Forms UI에서만 사용할 수 있습니다. 양식을 퀴즈로 만들면 양식이 새 UI를 사용하도록 선택됩니다.

매개변수

이름유형설명
enabledBoolean양식에 퀴즈 기능을 사용 설정해야 하는 경우 true, 사용하지 않는 경우 false

Return

Form: 이 Form, 체이닝용

승인

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

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

setLimitOneResponsePerUser(enabled)

양식에서 응답자당 하나의 응답만 허용할지를 설정합니다. 새 양식의 기본값은 false입니다. 값이 true로 설정되면 스크립트가 양식 응답을 아예 제출할 수 없습니다.

매개변수

이름유형설명
enabledBoolean양식에서 응답자당 하나의 응답만 허용해야 하는 경우 true, 그렇지 않은 경우 false

Return

Form: 이 Form, 체이닝용

승인

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

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

setProgressBar(enabled)

양식에 진행률 표시줄이 있는지 여부를 설정합니다. 새 양식의 기본값은 false입니다.

매개변수

이름유형설명
enabledBoolean양식에 진행률 표시줄이 표시되어야 하는 경우 true, 그렇지 않은 경우 false

Return

Form: 이 Form, 체이닝용

승인

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

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

setPublishingSummary(enabled)

응답자가 양식을 제출한 후에 양식에서 응답 요약을 볼 수 있도록 링크를 표시할지를 설정합니다. 새 양식의 기본값은 false입니다.

매개변수

이름유형설명
enabledBooleantrue: 양식에 '이전 응답 보기' 링크가 표시되어야 하는 경우 false

Return

Form: 이 Form, 체이닝용

승인

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

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

setRequireLogin(requireLogin)

양식에서 응답자가 동일한 도메인 또는 하위 도메인의 계정에 로그인해야 응답하도록 할지를 설정합니다. 도메인 관리자가 기본값을 변경하지 않는 한 새 양식의 기본값은 false입니다.

이 기능은 Google Workspace 사용자가 만든 양식에서만 사용할 수 있습니다. 다른 유형의 Google 계정 사용자는 로그인하지 않아도 됩니다.

매개변수

이름유형설명
requireLoginBoolean양식에 사용자가 로그인해야 하는 경우 true, 그렇지 않은 경우 false

Return

Form — 현재 양식 (체이닝용)

승인

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

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

setShowLinkToRespondAgain(enabled)

응답자가 양식을 작성한 후 양식에 또 다른 응답을 제출할 수 있는 링크를 표시할지를 설정합니다. 새 양식의 기본값은 true입니다.

매개변수

이름유형설명
enabledBoolean양식에 '다른 응답 제출' 링크가 표시되어야 하는 경우 true, 그렇지 않은 경우 false

Return

Form: 이 Form, 체이닝용

승인

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

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

setShuffleQuestions(shuffle)

양식의 각 페이지에서 질문 순서를 무작위로 지정할지 설정합니다.

매개변수

이름유형설명
shuffleBoolean양식의 각 페이지에서 질문 순서를 무작위로 지정하면 true, 그러지 않으면 false입니다.

Return

Form: 이 Form, 체이닝용

승인

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

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

setTitle(title)

양식의 제목을 설정합니다.

매개변수

이름유형설명
titleString양식의 새 제목

Return

Form: 이 Form, 체이닝용

승인

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

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

shortenFormUrl(url)

양식의 긴 URL을 단축 URL로 변환합니다. 긴 URL이 Google Forms에 속하지 않는 경우 예외가 발생합니다.

매개변수

이름유형설명
urlString

Return

String: http://goo.gl/forms/1234 형식의 URL입니다.

승인

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

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

submitGrades(responses)

지정된 FormResponse의 성적을 제출합니다.

코드에 onFormSubmit 트리거가 포함된 경우 submitGrades()를 호출하면 onFormSubmit 조건이 트리거되고 무한 루프가 발생합니다. 무한 루프를 방지하려면 submitGrades()를 호출하기 전에 성적이 이미 있는지 확인하는 코드를 추가합니다.

매개변수

이름유형설명
responsesFormResponse[]

Return

Form: 체이닝을 위한 Form입니다.

승인

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

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