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