- संसाधन: फ़ॉर्म
- जानकारी
- FormSettings
- QuizSettings
- आइटम
- QuestionItem
- सवाल
- ChoiceQuestion
- ChoiceType
- विकल्प
- GoToAction
- इमेज
- MediaProperties
- स्क्रीन पर अलाइनमेंट
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- ग्रेडिंग
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- ग्रिड
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- वीडियो
- तरीके
संसाधन: फ़ॉर्म
Google Forms का दस्तावेज़. Drive में एक फ़ॉर्म बनाया जाता है. Drive API की मदद से, किसी फ़ॉर्म को मिटाया जाता है या उसके ऐक्सेस सुरक्षा में बदलाव किया जाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "formId": string, "info": { object ( |
फ़ील्ड | |
---|---|
formId |
सिर्फ़ आउटपुट के लिए. फ़ॉर्म का आईडी. |
info |
ज़रूरी है. फ़ॉर्म का टाइटल और जानकारी. |
settings |
फ़ॉर्म की सेटिंग. इसे |
items[] |
ज़रूरी है. फ़ॉर्म में मौजूद आइटम की सूची, जिसमें सेक्शन हेडर, सवाल, एम्बेड किया गया मीडिया वगैरह शामिल हो सकता है. |
revisionId |
सिर्फ़ आउटपुट के लिए. फ़ॉर्म का बदलाव आईडी. इसका इस्तेमाल अपडेट के अनुरोधों में बदलाव आईडी का फ़ॉर्मैट समय के साथ बदल सकता है, इसलिए इसे पारदर्शी नहीं होना चाहिए. लौटाए गए बदलाव के आईडी के वापस आने के बाद सिर्फ़ 24 घंटे तक मान्य होना चाहिए. इस आईडी को सभी उपयोगकर्ताओं के साथ शेयर नहीं किया जा सकता. अगर कॉल के बीच में बदलाव आईडी में कोई बदलाव नहीं हुआ है, तो इसका मतलब है कि फ़ॉर्म में कोई बदलाव नहीं हुआ है. वहीं दूसरी ओर, आम तौर पर एक ही फ़ॉर्म और उपयोगकर्ता के लिए बदले गए आईडी का मतलब होता है कि फ़ॉर्म को अपडेट किया गया है. हालांकि, आईडी के फ़ॉर्मैट में बदलाव जैसी अंदरूनी वजहों से भी ऐसा हो सकता है. |
responderUri |
सिर्फ़ आउटपुट के लिए. जवाब देने वाले लोगों के साथ शेयर करने के लिए, फ़ॉर्म यूआरआई. इसके बाद, एक ऐसा पेज खुलेगा जो लोगों को जवाब सबमिट करने की अनुमति देगा, लेकिन सवालों में बदलाव करने की अनुमति नहीं देगा. |
linkedSheetId |
सिर्फ़ आउटपुट के लिए. लिंक की गई Google शीट का आईडी, जो इस फ़ॉर्म से जवाब इकट्ठा कर रहा है (अगर ऐसी कोई शीट मौजूद है). |
जानकारी
फ़ॉर्म की सामान्य जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "title": string, "documentTitle": string, "description": string } |
फ़ील्ड | |
---|---|
title |
ज़रूरी है. फ़ॉर्म का टाइटल, जिसे जवाब देने वाले लोग देख सकते हैं. |
documentTitle |
सिर्फ़ आउटपुट के लिए. उस दस्तावेज़ का टाइटल जो Drive में दिख रहा है. अगर |
description |
फ़ॉर्म की जानकारी. |
FormSettings
किसी फ़ॉर्म की सेटिंग.
जेएसओएन के काेड में दिखाना |
---|
{
"quizSettings": {
object ( |
फ़ील्ड | |
---|---|
quizSettings |
क्विज़ फ़ॉर्म और ग्रेडिंग से जुड़ी सेटिंग. |
QuizSettings
क्विज़ फ़ॉर्म और ग्रेडिंग से जुड़ी सेटिंग. इन्हें UpdateSettingsRequest के साथ अपडेट करना ज़रूरी है.
जेएसओएन के काेड में दिखाना |
---|
{ "isQuiz": boolean } |
फ़ील्ड | |
---|---|
isQuiz |
यह फ़ॉर्म कोई क्विज़ है या नहीं. सही होने पर, जवाबों को सवाल |
आइटम
फ़ॉर्म का एक आइटम. kind
बताता है कि यह किस तरह का आइटम है.
जेएसओएन के काेड में दिखाना |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
फ़ील्ड | |
---|---|
itemId |
आइटम आईडी. आईडी बनाते समय, यह दिया जा सकता है, लेकिन आईडी का इस्तेमाल पहले से फ़ॉर्म में नहीं किया जाना चाहिए. अगर यह आईडी नहीं दिया गया है, तो नया आईडी असाइन किया जाता है. |
title |
आइटम का टाइटल. |
description |
आइटम की जानकारी. |
यूनियन फ़ील्ड kind . ज़रूरी है. इस तरह का आइटम है. kind इनमें से सिर्फ़ एक हो सकता है: |
|
questionItem |
उपयोगकर्ता से सवाल पूछ सकता है. |
questionGroupItem |
एक मुख्य सवाल के ज़रिए, उपयोगकर्ता से एक या उससे ज़्यादा सवाल पूछता है. |
pageBreakItem |
शीर्षक वाला नया पेज शुरू करें. |
textItem |
पेज पर शीर्षक और जानकारी दिखाता है. |
imageItem |
पेज पर इमेज दिखाता है. |
videoItem |
पेज पर वीडियो दिखाता है. |
QuestionItem
फ़ॉर्म आइटम, जिसमें एक ही सवाल है.
जेएसओएन के काेड में दिखाना |
---|
{ "question": { object ( |
फ़ील्ड | |
---|---|
question |
ज़रूरी है. दिखाया गया सवाल. |
image |
सवाल में दिखाई गई इमेज. |
सवाल
कोई भी सवाल. ऐसे सवाल को kind
के नाम से जाना जाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
फ़ील्ड | |
---|---|
questionId |
रीड ओनली. सवाल का आईडी. आईडी बनाते समय, यह दिया जा सकता है, लेकिन आईडी का इस्तेमाल पहले से फ़ॉर्म में नहीं किया जाना चाहिए. अगर यह आईडी नहीं दिया गया है, तो नया आईडी असाइन किया जाता है. |
required |
जवाब देने वाले व्यक्ति को अपना जवाब सबमिट करने के लिए, सवाल का जवाब देना ज़रूरी है या नहीं. |
grading |
सवाल के लिए ग्रेडिंग सेटअप. |
यूनियन फ़ील्ड kind . ज़रूरी है. जवाब देने वाले व्यक्ति से पूछे गए सवाल का टाइप. kind इनमें से सिर्फ़ एक हो सकता है: |
|
choiceQuestion |
जवाब देने वाला व्यक्ति, पहले से तय विकल्पों में से विकल्प चुन सकता है. |
textQuestion |
जवाब देने वाला व्यक्ति, जवाब में बिना किसी शुल्क के जवाब दे सकता है. |
scaleQuestion |
जवाब देने वाला व्यक्ति, दी गई सीमा में से कोई संख्या चुन सकता है. |
dateQuestion |
जवाब देने वाला व्यक्ति तारीख डाल सकता है. |
timeQuestion |
जवाब देने वाला व्यक्ति समय डाल सकता है. |
fileUploadQuestion |
जवाब देने वाला व्यक्ति, एक या उससे ज़्यादा फ़ाइलें अपलोड कर सकता है. |
rowQuestion |
|
ChoiceQuestion
कोई रेडियो/चेकबॉक्स/ड्रॉपडाउन सवाल.
जेएसओएन के काेड में दिखाना |
---|
{ "type": enum ( |
फ़ील्ड | |
---|---|
type |
ज़रूरी है. पसंद के सवाल का टाइप. |
options[] |
ज़रूरी है. जवाब देने वाले व्यक्ति को, चुने जाने वाले विकल्पों की सूची. |
shuffle |
क्विज़ के अलग-अलग इंस्टेंस के लिए, विकल्पों को किसी भी क्रम में दिखाया जाना चाहिए या नहीं. इसका इस्तेमाल अक्सर ऐसे जवाब देने वालों को धोखाधड़ी से बचाने के लिए किया जाता है जो शायद दूसरे लोगों की स्क्रीन देख रहे हों. इसके अलावा, इसका इस्तेमाल सर्वे में पक्षपात को दूर करने के लिए किया जाता है, क्योंकि पहले या बाद में हमेशा एक जैसे विकल्पों का इस्तेमाल करके ही ऐसा किया जाता है. |
ChoiceType
पसंद किस तरह की है.
Enums | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
डिफ़ॉल्ट मान. इस्तेमाल नहीं किया गया. |
RADIO |
रेडियो बटन: उपयोगकर्ता को सभी विकल्प दिखाए जाते हैं और वह उनमें से किसी एक को ही चुन सकता है. |
CHECKBOX |
चेकबॉक्स: उपयोगकर्ता को सभी विकल्प दिखते हैं और वह इनमें से किसी भी विकल्प को चुन सकता है. |
DROP_DOWN |
ड्रॉप-डाउन मेन्यू: विकल्प सिर्फ़ मांग पर उपयोगकर्ता को दिखाए जाते हैं, नहीं तो सिर्फ़ मौजूदा विकल्प दिखाया जाएगा. सिर्फ़ एक विकल्प चुना जा सकता है. |
विकल्प
विकल्प वाले सवाल के लिए एक विकल्प.
जेएसओएन के काेड में दिखाना |
---|
{ "value": string, "image": { object ( |
फ़ील्ड | |
---|---|
value |
ज़रूरी है. उपयोगकर्ता को दिखाया गया विकल्प. |
image |
इमेज को विकल्प के तौर पर दिखाएं. |
isOther |
विकल्प "अन्य" है या नहीं. फ़िलहाल, यह सिर्फ़ |
यूनियन फ़ील्ड go_to_section . अगर यह विकल्प चुना जाता है, तो किस सेक्शन पर जाना है. फ़िलहाल, यह विकल्प सिर्फ़ RADIO और SELECT वाले विकल्प पर लागू होता है. हालांकि, QuestionGroupItem में इसकी अनुमति नहीं है. go_to_section इनमें से सिर्फ़ एक हो सकता है: |
|
goToAction |
सेक्शन नेविगेशन टाइप. |
goToSectionId |
जिस सेक्शन पर जाना है उसके हेडर का आइटम आईडी. |
GoToAction
सेक्शन नेविगेशन के लिए कॉन्सटेंट.
Enums | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
डिफ़ॉल्ट मान. इस्तेमाल नहीं किया गया. |
NEXT_SECTION |
अगले सेक्शन पर जाएं. |
RESTART_FORM |
फ़ॉर्म की शुरुआत में वापस जाएं. |
SUBMIT_FORM |
फ़ॉर्म तुरंत सबमिट करें. |
इमेज
इमेज दिखाने वाला डेटा.
जेएसओएन के काेड में दिखाना |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
फ़ील्ड | |
---|---|
contentUri |
सिर्फ़ आउटपुट के लिए. वह यूआरआई जिससे आप इमेज डाउनलोड कर सकते हैं; यह सिर्फ़ सीमित समय के लिए मान्य है. |
altText |
इमेज पर कर्सर घुमाने पर दिखने वाली जानकारी, जिसे स्क्रीन रीडर पढ़ते हैं. |
properties |
इमेज की प्रॉपर्टी. |
यूनियन फ़ील्ड image_source . इमेज का सोर्स किस तरह का है. नई इमेज बनाते समय, इमेज के सोर्स के लिए सिर्फ़ एक फ़ील्ड सेट करना चाहिए. image_source इनमें से सिर्फ़ एक हो सकता है: |
|
sourceUri |
सिर्फ़ इनपुट. सोर्स यूआरआई वह यूआरआई है जिसका इस्तेमाल इमेज शामिल करने के लिए किया जाता है. फ़ेच किए जाने पर सोर्स यूआरआई खाली हो सकता है. |
MediaProperties
मीडिया की विशेषताएं.
जेएसओएन के काेड में दिखाना |
---|
{
"alignment": enum ( |
फ़ील्ड | |
---|---|
alignment |
मीडिया की स्थिति. |
width |
मीडिया की चौड़ाई, पिक्सल में. जब मीडिया दिखाया जाता है, तो उसे इस वैल्यू से कम या दिखाए गए फ़ॉर्म की चौड़ाई के हिसाब से स्केल किया जाता है. मीडिया का मूल आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) सुरक्षित रखा जाता है. अगर मीडिया को फ़ॉर्म में जोड़ते समय कोई चौड़ाई तय नहीं की गई है, तो वह मीडिया सोर्स की चौड़ाई पर सेट होती है. चौड़ाई 0 से 740 के बीच होनी चाहिए. चौड़ाई को 0 या अनिर्दिष्ट पर सेट करने की अनुमति केवल मीडिया स्रोत को अपडेट करते समय ही है. |
अलाइनमेंट
पेज पर अलाइनमेंट.
Enums | |
---|---|
ALIGNMENT_UNSPECIFIED |
डिफ़ॉल्ट मान. इस्तेमाल नहीं किया गया. |
LEFT |
बाईं ओर अलाइन करें. |
RIGHT |
दाईं ओर अलाइन करें. |
CENTER |
मध्य में. |
TextQuestion
टेक्स्ट पर आधारित सवाल.
जेएसओएन के काेड में दिखाना |
---|
{ "paragraph": boolean } |
फ़ील्ड | |
---|---|
paragraph |
सवाल, पैराग्राफ़ का है या नहीं. अगर नहीं, तो सवाल एक छोटा टेक्स्ट है. |
ScaleQuestion
स्केल से जुड़ा सवाल. उपयोगकर्ता के पास चुनने के लिए संख्या वाली रेंज होती हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
फ़ील्ड | |
---|---|
low |
ज़रूरी है. स्केल के लिए सबसे कम संभावित वैल्यू. |
high |
ज़रूरी है. स्केल के लिए सबसे ज़्यादा संभावित वैल्यू. |
lowLabel |
स्केल पर निम्नतम बिंदु का वर्णन करने वाला प्रदर्शित करने के लिए लेबल. |
highLabel |
स्केल पर सबसे ऊंचे बिंदु के बारे में बताने वाला लेबल. |
DateQuestion
तारीख से जुड़ा सवाल. तारीख के सवालों के लिए, डिफ़ॉल्ट रूप से सिर्फ़ महीना + दिन चुना गया है.
जेएसओएन के काेड में दिखाना |
---|
{ "includeTime": boolean, "includeYear": boolean } |
फ़ील्ड | |
---|---|
includeTime |
क्या सवाल के हिस्से के तौर पर समय शामिल करना है. |
includeYear |
साल को सवाल में शामिल करना है या नहीं. |
TimeQuestion
समय से जुड़ा सवाल.
जेएसओएन के काेड में दिखाना |
---|
{ "duration": boolean } |
फ़ील्ड | |
---|---|
duration |
अगर सवाल बीते हुए समय के बारे में है, तो |
FileUploadQuestion
फ़ाइल अपलोड करने से जुड़ा सवाल. फ़िलहाल, इस एपीआई में फ़ाइल अपलोड करने से जुड़े सवाल नहीं बनाए जा सकते.
जेएसओएन के काेड में दिखाना |
---|
{
"folderId": string,
"types": [
enum ( |
फ़ील्ड | |
---|---|
folderId |
ज़रूरी है. उस Drive फ़ोल्डर का आईडी जहां अपलोड की गई फ़ाइलें सेव की जाती हैं. |
types[] |
इस सवाल में स्वीकार किए जाने वाले फ़ाइल टाइप. |
maxFiles |
एक जवाब में इस सवाल के लिए, ज़्यादा से ज़्यादा कितनी फ़ाइलें अपलोड की जा सकती हैं. |
maxFileSize |
इस सवाल के लिए, अपलोड की गई कोई भी एक फ़ाइल ज़्यादा से ज़्यादा बाइट संख्या में अपलोड की जा सकती है. |
FileType
ऐसे फ़ाइल टाइप जिन्हें फ़ाइल अपलोड करने से जुड़े सवाल पर अपलोड किया जा सकता है.
Enums | |
---|---|
FILE_TYPE_UNSPECIFIED |
डिफ़ॉल्ट मान. इस्तेमाल नहीं किया गया. |
ANY |
टाइप पर कोई पाबंदी नहीं है. |
DOCUMENT |
Google Docs दस्तावेज़. |
PRESENTATION |
Google Slides प्रज़ेंटेशन. |
SPREADSHEET |
Google Sheets स्प्रेडशीट. |
DRAWING |
ड्रॉइंग. |
PDF |
एक PDF. |
IMAGE |
इमेज. |
VIDEO |
एक वीडियो. |
AUDIO |
कोई ऑडियो फ़ाइल. |
RowQuestion
ऐसे सवाल के लिए कॉन्फ़िगरेशन जो सवालों के ग्रुप का हिस्सा है.
जेएसओएन के काेड में दिखाना |
---|
{ "title": string } |
फ़ील्ड | |
---|---|
title |
ज़रूरी है. |
ग्रेडिंग
किसी एक सवाल के लिए ग्रेडिंग
जेएसओएन के काेड में दिखाना |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
फ़ील्ड | |
---|---|
pointValue |
ज़रूरी है. जवाब देने वाले व्यक्ति को सही जवाब के लिए, अपने-आप ज़्यादा से ज़्यादा पॉइंट मिल सकते हैं. यह नेगेटिव नहीं होना चाहिए. |
correctAnswers |
ज़रूरी है. सवाल के लिए जवाब कुंजी. इस फ़ील्ड के आधार पर, जवाबों को अपने-आप ग्रेड दिया जाता है. |
whenRight |
सही जवाबों के लिए सुझाव, शिकायत या राय दिखाई जाती है. यह सुझाव, कई विकल्प वाले सिर्फ़ ऐसे सवालों के लिए सेट किया जा सकता है जिनके सही जवाब दिए गए हों. |
whenWrong |
गलत जवाबों के लिए सुझाव, शिकायत या राय दिखाई गई. यह सुझाव, कई विकल्प वाले सिर्फ़ ऐसे सवालों के लिए सेट किया जा सकता है जिनके सही जवाब दिए गए हों. |
generalFeedback |
सभी जवाबों के लिए सुझाव, शिकायत या राय दिखाई जाती है. आम तौर पर, इसका इस्तेमाल छोटे जवाब वाले सवालों के लिए तब किया जाता है, जब क्विज़ का मालिक जवाब देने वालों को तुरंत यह जानना चाहता है कि क्या उन्होंने जवाब को आधिकारिक रूप से ग्रेड देने का मौका मिलने से पहले सही जवाब दिया है या नहीं. सामान्य फ़ीडबैक को, अपने-आप ग्रेड दिए जाने वाले कई विकल्प वाले सवालों के लिए सेट नहीं किया जा सकता. |
CorrectAnswers
सवाल के लिए जवाब कुंजी.
जेएसओएन के काेड में दिखाना |
---|
{
"answers": [
{
object ( |
फ़ील्ड | |
---|---|
answers[] |
सही जवाबों की सूची. इन जवाबों के आधार पर क्विज़ के जवाब को अपने-आप ग्रेड दिया जा सकता है. एक-वैल्यू वाले सवालों के लिए, अगर कोई जवाब इस सूची में मौजूद किसी भी वैल्यू से मेल खाता है, तो उसे सही के तौर पर मार्क किया जाता है. दूसरे शब्दों में, एक से ज़्यादा सही जवाब दिए जा सकते हैं. एक से ज़्यादा वैल्यू वाले ( |
CorrectAnswer
किसी सवाल का एक सही जवाब. कई वैल्यू वाले (CHECKBOX
) सवालों के लिए, एक सही जवाब के विकल्प को दिखाने के लिए कई CorrectAnswer
की ज़रूरत हो सकती है.
जेएसओएन के काेड में दिखाना |
---|
{ "value": string } |
फ़ील्ड | |
---|---|
value |
ज़रूरी है. सही जवाब मान. अलग-अलग वैल्यू टाइप को फ़ॉर्मैट करने के तरीके के बारे में जानने के लिए, |
QuestionGroupItem
ऐसे सवाल की जानकारी देता है जिसमें एक साथ कई सवाल शामिल होते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "questions": [ { object ( |
फ़ील्ड | |
---|---|
questions[] |
ज़रूरी है. इस सवाल के ग्रुप से जुड़े सवालों की सूची. एक सवाल सिर्फ़ एक ग्रुप से जुड़ा होना चाहिए. ग्रुप के |
image |
सवाल वाले ग्रुप में, उन सवालों के ऊपर दिखने वाली इमेज. |
यूनियन फ़ील्ड kind . ज़रूरी है. सवालों के ग्रुप का टाइप, जिससे तय होता है कि किस तरह के सवाल पूछे जा सकते हैं और वे किस तरह दिखाए जाएंगे. kind इनमें से सिर्फ़ एक हो सकता है: |
|
grid |
सवालों का ग्रुप एक ग्रिड है, जिसमें एक जैसे विकल्प वाले कई विकल्प वाले सवाल हैं. जब |
ग्रिड
विकल्पों की एक ग्रिड (रेडियो या चेक बॉक्स). हर पंक्ति में अलग-अलग सवाल होते हैं. हर लाइन में एक जैसे विकल्प होते हैं, जो कॉलम के तौर पर दिखाए जाते हैं.
जेएसओएन के काेड में दिखाना |
---|
{
"columns": {
object ( |
फ़ील्ड | |
---|---|
columns |
ज़रूरी है. ग्रिड में मौजूद हर सवाल के लिए शेयर किए गए विकल्प. दूसरे शब्दों में, कॉलम की वैल्यू. सिर्फ़ |
shuffleQuestions |
अगर |
PageBreakItem
पेज ब्रेक. इस आइटम का टाइटल और जानकारी, नए पेज पर सबसे ऊपर दिखती है.
TextItem
कोई टेक्स्ट आइटम.
ImageItem
वह आइटम जिसमें कोई इमेज होती है.
जेएसओएन के काेड में दिखाना |
---|
{
"image": {
object ( |
फ़ील्ड | |
---|---|
image |
ज़रूरी है. आइटम में दिखाई गई इमेज. |
VideoItem
वीडियो वाला आइटम.
जेएसओएन के काेड में दिखाना |
---|
{
"video": {
object ( |
फ़ील्ड | |
---|---|
video |
ज़रूरी है. आइटम में दिखाया गया वीडियो. |
caption |
वीडियो के नीचे दिखाया गया टेक्स्ट. |
वीडियो
वीडियो दिखाने वाला डेटा.
जेएसओएन के काेड में दिखाना |
---|
{
"youtubeUri": string,
"properties": {
object ( |
फ़ील्ड | |
---|---|
youtubeUri |
ज़रूरी है. YouTube यूआरआई. |
properties |
वीडियो की प्रॉपर्टी. |
तरीके |
|
---|---|
|
अपडेट के बैच के साथ फ़ॉर्म को बदलें. |
|
अनुरोध में दिए गए फ़ॉर्म के मैसेज में दिए गए टाइटल का इस्तेमाल करके, नया फ़ॉर्म बनाएं. |
|
फ़ॉर्म पाएं. |