Interface Item

항목

제목, 도움말 텍스트 등 모든 항목에 공통적인 속성을 포함하는 일반 양식 항목입니다. Form에서 항목에 액세스하거나 항목을 만들 수 있습니다.

유형별 속성에서 작업하려면 getType()를 사용하여 항목의 ItemType를 확인한 다음 asCheckboxItem()와 같은 메서드를 사용하여 항목을 적절한 클래스로 변환합니다. 

// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const textItem = item.asTextItem();
  textItem.setRequired(false);
}

클래스 구현

이름간략한 설명

메서드

메서드반환 유형간략한 설명
asCheckboxGridItem()CheckboxGridItem항목을 체크박스 그리드 항목으로 반환합니다.
asCheckboxItem()CheckboxItem항목을 체크박스 항목으로 반환합니다.
asDateItem()DateItem항목을 날짜 항목으로 반환합니다.
asDateTimeItem()DateTimeItem항목을 날짜-시간 항목으로 반환합니다.
asDurationItem()DurationItem항목을 기간 항목으로 반환합니다.
asGridItem()GridItem항목을 그리드 항목으로 반환합니다.
asImageItem()ImageItem항목을 이미지 항목으로 반환합니다.
asListItem()ListItem항목을 목록 항목으로 반환합니다.
asMultipleChoiceItem()MultipleChoiceItem항목을 객관식 항목으로 반환합니다.
asPageBreakItem()PageBreakItem항목을 페이지 나누기 항목으로 반환합니다.
asParagraphTextItem()ParagraphTextItem항목을 단락 텍스트 항목으로 반환합니다.
asRatingItem()RatingItem항목을 평가 항목으로 반환합니다.
asScaleItem()ScaleItem항목을 스케일 항목으로 반환합니다.
asSectionHeaderItem()SectionHeaderItem항목을 섹션 헤더 항목으로 반환합니다.
asTextItem()TextItem항목을 텍스트 항목으로 반환합니다.
asTimeItem()TimeItem항목을 시간 항목으로 반환합니다.
asVideoItem()VideoItem항목을 동영상 항목으로 반환합니다.
duplicate()Item이 항목의 사본을 만들어 양식 끝에 추가합니다.
getHelpText()String항목의 도움말 텍스트를 가져옵니다 (ImageItems, PageBreakItems, SectionHeaderItems과 같은 레이아웃 항목의 설명 텍스트라고도 함).
getId()Integer항목의 고유 식별자를 가져옵니다.
getIndex()Integer양식의 모든 항목 중에서 항목의 색인을 가져옵니다.
getTitle()String항목의 제목을 가져옵니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).
getType()ItemTypeItemType로 표시된 항목의 유형을 가져옵니다.
setHelpText(text)Item항목의 도움말 텍스트를 설정합니다 (ImageItems, PageBreakItems, SectionHeaderItems과 같은 레이아웃 항목의 설명 텍스트라고도 함).
setTitle(title)Item항목의 제목을 설정합니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

자세한 문서

asCheckboxGridItem()

항목을 체크박스 그리드 항목으로 반환합니다. ItemType가 아직 CHECKBOX_GRID이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

CheckboxGridItem - 체크박스 그리드 항목

생성 값

Error - 항목이 체크박스 그리드 항목이 아닌 경우

승인

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

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

asCheckboxItem()

항목을 체크박스 항목으로 반환합니다. ItemType가 아직 CHECKBOX이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

CheckboxItem - 체크박스 항목

생성 값

Error - 항목이 체크박스 항목이 아닌 경우

승인

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

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

asDateItem()

항목을 날짜 항목으로 반환합니다. ItemType가 아직 DATE이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

DateItem - 날짜 항목

생성 값

Error - 항목이 날짜 항목이 아닌 경우

승인

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

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

asDateTimeItem()

항목을 날짜-시간 항목으로 반환합니다. ItemType가 아직 DATETIME이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

DateTimeItem - 날짜/시간 항목

생성 값

Error - 항목이 날짜-시간 항목이 아닌 경우

승인

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

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

asDurationItem()

항목을 기간 항목으로 반환합니다. ItemType가 아직 DURATION이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

DurationItem - 기간 항목

생성 값

Error - 상품이 기간 상품이 아닌 경우

승인

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

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

asGridItem()

항목을 그리드 항목으로 반환합니다. ItemType가 아직 GRID이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

GridItem - 그리드 항목

생성 값

Error - 항목이 그리드 항목이 아닌 경우

승인

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

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

asImageItem()

항목을 이미지 항목으로 반환합니다. ItemType가 아직 IMAGE이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

ImageItem - 이미지 항목

생성 값

Error - 항목이 이미지 항목이 아닌 경우

asListItem()

항목을 목록 항목으로 반환합니다. ItemType가 아직 LIST이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

ListItem - 목록 항목

생성 값

Error - 항목이 목록 항목이 아닌 경우

승인

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

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

asMultipleChoiceItem()

항목을 객관식 항목으로 반환합니다. ItemType가 아직 MULTIPLE_CHOICE이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

MultipleChoiceItem - 객관식 항목

생성 값

Error - 항목이 객관식 항목이 아닌 경우

승인

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

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

asPageBreakItem()

항목을 페이지 나누기 항목으로 반환합니다. ItemType가 아직 PAGE_BREAK이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

PageBreakItem - 페이지 나누기 항목

생성 값

Error - 항목이 페이지 나누기 항목이 아닌 경우

승인

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

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

asParagraphTextItem()

항목을 단락 텍스트 항목으로 반환합니다. ItemType가 아직 PARAGRAPH_TEXT이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

ParagraphTextItem - 단락 텍스트 항목

생성 값

Error - 항목이 단락 텍스트 항목이 아닌 경우

승인

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

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

asRatingItem()

항목을 평가 항목으로 반환합니다. ItemType가 아직 RATING이 아닌 경우 ScriptingException이 발생합니다. 

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

리턴

RatingItem - 평가 항목입니다.

생성 값

Error - 상품이 평가 상품이 아닌 경우

승인

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

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

asScaleItem()

항목을 스케일 항목으로 반환합니다. ItemType가 아직 SCALE이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

ScaleItem - 확장 항목

생성 값

Error - 상품이 저울 상품이 아닌 경우

승인

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

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

asSectionHeaderItem()

항목을 섹션 헤더 항목으로 반환합니다. ItemType가 아직 SECTION_HEADER이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

SectionHeaderItem - 섹션 헤더 항목

생성 값

Error - 항목이 섹션 헤더 항목이 아닌 경우

승인

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

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

asTextItem()

항목을 텍스트 항목으로 반환합니다. ItemType가 아직 TEXT이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

TextItem - 텍스트 항목

생성 값

Error - 항목이 텍스트 항목이 아닌 경우

승인

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

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

asTimeItem()

항목을 시간 항목으로 반환합니다. ItemType가 아직 TIME이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

TimeItem - 시간 항목

생성 값

Error - 상품이 시간 상품이 아닌 경우

승인

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

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

asVideoItem()

항목을 동영상 항목으로 반환합니다. ItemType가 아직 VIDEO이 아닌 경우 스크립팅 예외를 발생시킵니다.

리턴

VideoItem - 동영상 항목

생성 값

Error - 항목이 동영상 항목이 아닌 경우

duplicate()

이 항목의 사본을 만들어 양식 끝에 추가합니다.

리턴

Item - 연결을 위한 이 Item의 중복

승인

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

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

getHelpText()

항목의 도움말 텍스트를 가져옵니다 (ImageItems, PageBreakItems, SectionHeaderItems과 같은 레이아웃 항목의 설명 텍스트라고도 함).

리턴

String - 상품의 도움말 텍스트 또는 설명 텍스트

승인

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

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

getId()

항목의 고유 식별자를 가져옵니다.

리턴

Integer: 상품 ID

승인

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

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

getIndex()

양식의 모든 항목 중에서 항목의 색인을 가져옵니다.

리턴

Integer: 항목의 색인

승인

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

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

getTitle()

항목의 제목을 가져옵니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

리턴

String - 상품의 제목 또는 헤더 텍스트

승인

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

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

getType()

ItemType로 표시된 항목의 유형을 가져옵니다.

리턴

ItemType: 상품의 유형

승인

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

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

setHelpText(text)

항목의 도움말 텍스트를 설정합니다 (ImageItems, PageBreakItems, SectionHeaderItems과 같은 레이아웃 항목의 설명 텍스트라고도 함).

매개변수

이름유형설명
textString새 도움말 텍스트

리턴

Item - 이 Item(연결용)

승인

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

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

setTitle(title)

항목의 제목을 설정합니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

매개변수

이름유형설명
titleString새 제목 또는 헤더 텍스트

리턴

Item - 이 Item(연결용)

승인

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

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