Class RatingItem

평점항목

응답자가 평가를 제공할 수 있는 질문 항목입니다. Form에서 항목에 액세스하거나 항목을 만들 수 있습니다. 퀴즈에 사용하면 이러한 항목에 점수가 부여됩니다. 

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

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

메서드

메서드반환 유형간략한 설명
createResponse(response)ItemResponse이 평가 항목의 새 ItemResponse를 만듭니다.
duplicate()RatingItem이 항목의 사본을 만들어 양식 끝에 추가합니다.
getGeneralFeedback()QuizFeedback응답자가 채점 가능한 질문에 답변할 때 표시되는 의견을 반환합니다.
getHelpText()String항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 경우 설명 텍스트라고도 함)를 가져옵니다.
getId()Integer항목의 고유 식별자를 가져옵니다.
getIndex()Integer양식의 모든 항목 중에서 항목의 색인을 가져옵니다.
getPoints()Integer채점 가능한 항목의 점수 값을 반환합니다.
getRatingIcon()RatingIconType평점에 선택된 아이콘을 가져옵니다.
getRatingScaleLevel()Integer평가의 척도 수준을 가져옵니다.
getTitle()String항목의 제목을 가져옵니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).
getType()ItemTypeItemType로 표시되는 항목 유형을 가져옵니다.
isRequired()Boolean응답자가 질문에 답변해야 하는지 여부를 결정합니다.
setGeneralFeedback(feedback)RatingItem정답 또는 오답이 없는 채점 가능한 질문 (즉, 수동 채점이 필요한 질문)에 응답할 때 응답자에게 표시할 의견을 설정합니다.
setHelpText(text)RatingItem항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.
setPoints(points)RatingItem채점 가능한 항목의 점수를 설정합니다.
setRatingIcon(ratingIcon)RatingItem평점 아이콘을 설정합니다.
setRatingScaleLevel(ratingScaleLevel)RatingItem평점의 최대 척도 수준을 설정합니다.
setRequired(enabled)RatingItem응답자가 질문에 답변해야 하는지 여부를 설정합니다.
setTitle(title)RatingItem항목의 제목을 설정합니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

자세한 문서

createResponse(response)

이 평가 항목의 새 ItemResponse를 만듭니다.

제공된 response가 1보다 작거나 getRatingScaleLevel()에서 반환된 값보다 큰 경우 스크립트 예외를 발생시킵니다. 

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

// Get an existing rating item and create a response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

매개변수

이름유형설명
responseInteger이 평가 항목의 값 답변입니다.

리턴

ItemResponse: 항목 응답입니다.

승인

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

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

duplicate()

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

리턴

RatingItem: 체이닝을 위한 이 RatingItem의 중복

승인

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

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

getGeneralFeedback()

응답자가 채점 가능한 질문에 답변할 때 표시되는 의견을 반환합니다.

리턴

QuizFeedback: 의견(있는 경우)

승인

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

  • 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

getPoints()

채점 가능한 항목의 점수 값을 반환합니다.

리턴

Integer: 문제의 점수입니다.

승인

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

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

getRatingIcon()

평점에 선택된 아이콘을 가져옵니다. 

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

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

리턴

RatingIconType: 평점 아이콘 유형입니다.

승인

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

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

getRatingScaleLevel()

평가의 척도 수준을 가져옵니다. 

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

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

리턴

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

isRequired()

응답자가 질문에 답변해야 하는지 여부를 결정합니다.

리턴

Boolean: 응답자가 질문에 답해야 하는지 여부

승인

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

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

setGeneralFeedback(feedback)

정답 또는 오답이 없는 채점 가능한 질문 (즉, 수동 채점이 필요한 질문)에 응답할 때 응답자에게 표시할 의견을 설정합니다.

매개변수

이름유형설명
feedbackQuizFeedback새로운 의견

리턴

RatingItem: 체이닝을 위한 이 RatingItem

승인

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

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

setHelpText(text)

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

매개변수

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

리턴

RatingItem: 체이닝을 위한 이 RatingItem

승인

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

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

setPoints(points)

채점 가능한 항목의 점수를 설정합니다. 새 항목의 기본값은 0입니다.

매개변수

이름유형설명
pointsInteger질문 항목의 점수

리턴

RatingItem: 체이닝을 위한 이 RatingItem

승인

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

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

setRatingIcon(ratingIcon)

평점 아이콘을 설정합니다.

평점 아이콘 유형이 잘못된 경우 스크립팅 예외가 발생합니다. 

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

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

매개변수

이름유형설명
ratingIconRatingIconType평점 아이콘 유형입니다.

리턴

RatingItem — 체이닝을 위한 이 RatingItem

생성 값

Error: 평점 아이콘 유형이 잘못된 경우

승인

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

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

setRatingScaleLevel(ratingScaleLevel)

평점의 최대 척도 수준을 설정합니다. 평점의 최대 척도 수준은 3 이상 10 이하여야 합니다. 새 평점은 기본적으로 평가 척도 수준 3으로 설정됩니다.

지정된 값이 허용된 한도를 벗어나면 스크립팅 예외가 발생합니다. 

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

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

매개변수

이름유형설명
ratingScaleLevelInteger평가 척도 수준입니다.

리턴

RatingItem — 체이닝을 위한 이 RatingItem

생성 값

Error: 평가 척도 수준이 잘못된 경우

승인

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

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

setRequired(enabled)

응답자가 질문에 답변해야 하는지 여부를 설정합니다.

매개변수

이름유형설명
enabledBoolean응답자가 질문에 답변해야 하는지 여부

리턴

RatingItem: 현재 항목 (연결용)

승인

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

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

setTitle(title)

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

매개변수

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

리턴

RatingItem: 체이닝을 위한 이 RatingItem

승인

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

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