Class RatingItem

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|nullयह फ़ंक्शन, ग्रेड किए जा सकने वाले सवाल का जवाब देने पर, जवाब देने वालों को दिखने वाली प्रतिक्रिया दिखाता है.
getHelpText()Stringइससे आइटम का सहायता टेक्स्ट मिलता है. इसे कभी-कभी ImageItems, PageBreakItems, और SectionHeaderItems जैसे लेआउट आइटम के लिए ब्यौरे का टेक्स्ट भी कहा जाता है.
getId()Integerयह फ़ंक्शन, आइटम का यूनीक आइडेंटिफ़ायर दिखाता है.
getIndex()Integerयह फ़ॉर्म में मौजूद सभी आइटम में से, आइटम का इंडेक्स दिखाता है.
getPoints()Integerग्रेड किए जा सकने वाले किसी आइटम की पॉइंट वैल्यू दिखाता है.
getRatingIcon()RatingIconTypeरेटिंग के लिए चुना गया आइकॉन मिलता है.
getRatingScaleLevel()Integerइससे रेटिंग का स्केल लेवल मिलता है.
getTitle()Stringइससे आइटम का टाइटल मिलता है. कभी-कभी इसे हेडर टेक्स्ट भी कहा जाता है. ऐसा SectionHeaderItem के मामले में होता है.
getType()ItemTypeआइटम का टाइप मिलता है, जिसे ItemType के तौर पर दिखाया जाता है.
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|null — अगर कोई सुझाव/राय देनी है या शिकायत करनी है, तो यहां लिखें.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

  • 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 — आइटम का आईडी

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

  • 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