REST Resource: forms

সম্পদ: ফর্ম

একটি Google ফর্ম নথি। ড্রাইভে একটি ফর্ম তৈরি করা হয় এবং একটি ফর্ম মুছে ফেলা বা এর অ্যাক্সেস সুরক্ষাগুলি পরিবর্তন করা ড্রাইভ API এর মাধ্যমে করা হয়৷

JSON প্রতিনিধিত্ব 
{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string,
  "publishSettings": {
    object (PublishSettings)
  }
}
ক্ষেত্র
formId

string

শুধুমাত্র আউটপুট। ফর্ম আইডি।

info

object ( Info )

প্রয়োজন। ফর্মের শিরোনাম এবং বিবরণ।

settings

object ( FormSettings )

ফর্মের সেটিংস। এটি UpdateSettingsRequest এর সাথে আপডেট করা আবশ্যক; forms.create এবং UpdateFormInfoRequest সময় এটি উপেক্ষা করা হয়।

items[]

object ( Item )

প্রয়োজন। ফর্মের আইটেমগুলির একটি তালিকা, যার মধ্যে বিভাগ শিরোনাম, প্রশ্ন, এমবেডেড মিডিয়া ইত্যাদি অন্তর্ভুক্ত থাকতে পারে।

revisionId

string

শুধুমাত্র আউটপুট। ফর্মের রিভিশন আইডি। আপডেটের অনুরোধে WriteControl এ ব্যবহার করা হয়েছে সংশোধনের ভিত্তিতে চিহ্নিত করার জন্য।

রিভিশন আইডির বিন্যাস সময়ের সাথে পরিবর্তিত হতে পারে, তাই এটিকে অস্বচ্ছভাবে বিবেচনা করা উচিত। একটি রিভিশন আইডি ফেরত দেওয়ার পরে শুধুমাত্র 24 ঘন্টা বৈধ হওয়ার নিশ্চয়তা দেওয়া হয় এবং ব্যবহারকারীদের মধ্যে শেয়ার করা যাবে না। যদি কলগুলির মধ্যে পুনর্বিবেচনা আইডি অপরিবর্তিত থাকে, তাহলে ফর্মের বিষয়বস্তু পরিবর্তিত হয়নি৷ বিপরীতভাবে, একটি পরিবর্তিত আইডি (একই ফর্ম এবং ব্যবহারকারীর জন্য) সাধারণত ফর্মের বিষয়বস্তু আপডেট করা হয়; যাইহোক, আইডি ফরম্যাট পরিবর্তনের মতো অভ্যন্তরীণ কারণগুলির কারণেও একটি পরিবর্তিত আইডি হতে পারে।

ফর্ম বিষয়বস্তু ফর্ম মেটাডেটা বাদ দেয়, সহ:

  • শেয়ারিং সেটিংস (যাদের ফর্মে অ্যাক্সেস আছে)
  • publishSettings (যদি ফর্মটি প্রকাশকে সমর্থন করে এবং যদি এটি প্রকাশিত হয়)
responderUri

string

শুধুমাত্র আউটপুট। উত্তরদাতাদের সাথে শেয়ার করার জন্য ফর্ম URI৷ এটি একটি পৃষ্ঠা খোলে যা ব্যবহারকারীকে প্রতিক্রিয়া জমা দেওয়ার অনুমতি দেয় কিন্তু প্রশ্ন সম্পাদনা করে না। যে ফর্মগুলির জন্য publishSettings মান সেট আছে, এটি হল প্রকাশিত ফর্ম URI৷

linkedSheetId

string

শুধুমাত্র আউটপুট। লিঙ্ক করা Google শীটের আইডি যা এই ফর্ম থেকে প্রতিক্রিয়া জমা করছে (যদি এই ধরনের শীট থাকে)।

publishSettings

object ( PublishSettings )

শুধুমাত্র আউটপুট। একটি ফর্মের জন্য প্রকাশনার সেটিংস৷ এই ক্ষেত্রটি লিগ্যাসি ফর্মের জন্য সেট করা নেই কারণ তাদের publishSettings ক্ষেত্র নেই৷ সমস্ত নতুন তৈরি ফর্ম প্রকাশ সেটিংস সমর্থন করে.

publishSettings মান সেট সহ ফর্মগুলি ফর্মটি প্রকাশ বা অপ্রকাশিত করতে forms.setPublishSettings API কল করতে পারে৷

তথ্য

একটি ফর্ম জন্য সাধারণ তথ্য.

JSON প্রতিনিধিত্ব 
{
  "title": string,
  "documentTitle": string,
  "description": string
}
ক্ষেত্র
title

string

প্রয়োজন। ফর্মের শিরোনাম যা উত্তরদাতাদের কাছে দৃশ্যমান।

documentTitle

string

শুধুমাত্র আউটপুট। ডকুমেন্টের শিরোনাম যা ড্রাইভে দৃশ্যমান। Info.title খালি থাকলে, Google Forms UI-তে documentTitle এর জায়গায় উপস্থিত হতে পারে এবং উত্তরদাতাদের কাছে দৃশ্যমান হতে পারে। documentTitle তৈরিতে সেট করা যেতে পারে, কিন্তু ব্যাচআপডেট অনুরোধ দ্বারা সংশোধন করা যাবে না। অনুগ্রহ করে Google ড্রাইভ API ব্যবহার করুন যদি আপনার documentTitle প্রোগ্রাম্যাটিকভাবে আপডেট করতে হয়।

description

string

ফর্মের বর্ণনা।

ফর্ম সেটিংস

একটি ফর্ম সেটিংস.

JSON প্রতিনিধিত্ব 
{
  "quizSettings": {
    object (QuizSettings)
  },
  "emailCollectionType": enum (EmailCollectionType)
}
ক্ষেত্র
quizSettings

object ( QuizSettings )

কুইজ ফর্ম এবং গ্রেডিং সম্পর্কিত সেটিংস।

emailCollectionType

enum ( EmailCollectionType )

ঐচ্ছিক। ফর্মটি উত্তরদাতাদের কাছ থেকে ইমেল ঠিকানা সংগ্রহ করে কিনা তা নির্ধারণ করে।

কুইজ সেটিংস

কুইজ ফর্ম এবং গ্রেডিং সম্পর্কিত সেটিংস। এগুলো অবশ্যই UpdateSettingsRequest এর সাথে আপডেট করতে হবে।

JSON প্রতিনিধিত্ব 
{
  "isQuiz": boolean
}
ক্ষেত্র
isQuiz

boolean

এই ফর্ম একটি কুইজ বা না. সত্য হলে, প্রশ্নের Grading উপর ভিত্তি করে উত্তরগুলি গ্রেড করা হয়। মিথ্যা সেট করার পরে, সমস্ত প্রশ্ন Grading মুছে ফেলা হয়।

ইমেইল সংগ্রহের প্রকার

ঐচ্ছিক। ফর্মটি উত্তরদাতাদের কাছ থেকে ইমেল ঠিকানা সংগ্রহ করে কিনা এবং ইমেল ঠিকানাগুলি কীভাবে সংগ্রহ করা হয় তা নির্ধারণ করে সেটি সেটিং। যদি ফর্মটি ইমেল ঠিকানা সংগ্রহ করে, তাহলে মানগুলি formResponse.respondentEmail ফিল্ডে জমা হয়।

এনামস
EMAIL_COLLECTION_TYPE_UNSPECIFIED অনির্দিষ্ট। এই মান অব্যবহৃত.
DO_NOT_COLLECT ফর্মটি ইমেল ঠিকানা সংগ্রহ করে না। ফর্ম মালিক একটি Google অ্যাকাউন্ট ব্যবহার করলে ডিফল্ট মান।
VERIFIED সাইন-ইন করা ব্যবহারকারীর অ্যাকাউন্টের উপর ভিত্তি করে ফর্মটি স্বয়ংক্রিয়ভাবে ইমেল ঠিকানা সংগ্রহ করে। ফর্মের মালিক Google Workspace অ্যাকাউন্ট ব্যবহার করলে ডিফল্ট মান।
RESPONDER_INPUT ফর্মটি একটি ক্ষেত্র ব্যবহার করে ইমেল ঠিকানা সংগ্রহ করে যা উত্তরদাতা ফর্মটিতে পূরণ করে।

আইটেম

ফর্ম একটি একক আইটেম. kind আইটেম কোন ধরনের সংজ্ঞায়িত.

JSON প্রতিনিধিত্ব 
{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}
ক্ষেত্র
itemId

string

আইটেম আইডি.

তৈরি করার সময়, এটি প্রদান করা যেতে পারে তবে আইডিটি ইতিমধ্যে ফর্মে ব্যবহার করা উচিত নয়। যদি প্রদান না করা হয়, একটি নতুন আইডি বরাদ্দ করা হয়.

title

string

আইটেম শিরোনাম.

description

string

আইটেম বর্ণনা.

ইউনিয়ন ক্ষেত্র kind . প্রয়োজন। আইটেম এই ধরনের. kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
questionItem

object ( QuestionItem )

ব্যবহারকারীর কাছে একটি প্রশ্ন উত্থাপন করে।

questionGroupItem

object ( QuestionGroupItem )

একটি একক প্রধান প্রম্পট সহ ব্যবহারকারীর কাছে এক বা একাধিক প্রশ্ন উত্থাপন করে৷

pageBreakItem

object ( PageBreakItem )

একটি শিরোনাম দিয়ে একটি নতুন পৃষ্ঠা শুরু করে।

textItem

object ( TextItem )

পৃষ্ঠায় একটি শিরোনাম এবং বিবরণ প্রদর্শন করে।

imageItem

object ( ImageItem )

পৃষ্ঠায় একটি চিত্র প্রদর্শন করে।

videoItem

object ( VideoItem )

পৃষ্ঠায় একটি ভিডিও প্রদর্শন করে।

প্রশ্ন আইটেম

একটি একক প্রশ্ন ধারণকারী একটি ফর্ম আইটেম.

JSON প্রতিনিধিত্ব 
{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}
ক্ষেত্র
question

object ( Question )

প্রয়োজন। প্রদর্শিত প্রশ্ন.

image

object ( Image )

প্রশ্নের মধ্যে প্রদর্শিত চিত্র।

প্রশ্ন

কোন প্রশ্ন. নির্দিষ্ট ধরনের প্রশ্ন তার kind দ্বারা পরিচিত হয়।

JSON প্রতিনিধিত্ব 
{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  },
  "ratingQuestion": {
    object (RatingQuestion)
  }
  // End of list of possible types for union field kind.
}
ক্ষেত্র
questionId

string

শুধু পড়ুন। প্রশ্ন আইডি.

তৈরি করার সময়, এটি প্রদান করা যেতে পারে তবে আইডিটি ইতিমধ্যে ফর্মে ব্যবহার করা উচিত নয়। যদি প্রদান না করা হয়, একটি নতুন আইডি বরাদ্দ করা হয়.

required

boolean

একজন উত্তরদাতাকে তাদের প্রতিক্রিয়া জমা দেওয়ার জন্য প্রশ্নের উত্তর দিতে হবে কিনা।

grading

object ( Grading )

প্রশ্নের জন্য গ্রেডিং সেটআপ।

ইউনিয়ন ক্ষেত্র kind . প্রয়োজন। প্রশ্নের ধরন একজন উত্তরদাতাকে দেওয়া হয়েছে। kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
choiceQuestion

object ( ChoiceQuestion )

একজন উত্তরদাতা বিকল্পগুলির একটি পূর্ব-নির্ধারিত সেট থেকে বেছে নিতে পারেন।

textQuestion

object ( TextQuestion )

একজন উত্তরদাতা একটি বিনামূল্যে পাঠ্য প্রতিক্রিয়া লিখতে পারেন।

scaleQuestion

object ( ScaleQuestion )

একজন উত্তরদাতা একটি পরিসর থেকে একটি সংখ্যা চয়ন করতে পারেন।

dateQuestion

object ( DateQuestion )

একজন উত্তরদাতা একটি তারিখ লিখতে পারেন।

timeQuestion

object ( TimeQuestion )

একজন উত্তরদাতা একটি সময় প্রবেশ করতে পারেন।

fileUploadQuestion

object ( FileUploadQuestion )

একজন উত্তরদাতা এক বা একাধিক ফাইল আপলোড করতে পারেন।

rowQuestion

object ( RowQuestion )

একটি QuestionGroupItem এর একটি সারি।

ratingQuestion

object ( RatingQuestion )

একজন উত্তরদাতা আইকনগুলির একটি পূর্ব-নির্ধারিত সেট থেকে একটি রেটিং বেছে নিতে পারেন।

চয়েস প্রশ্ন

একটি রেডিও/চেকবক্স/ড্রপডাউন প্রশ্ন।

JSON প্রতিনিধিত্ব 
{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}
ক্ষেত্র
type

enum ( ChoiceType )

প্রয়োজন। পছন্দের প্রশ্নের ধরন।

options[]

object ( Option )

প্রয়োজন। বিকল্পগুলির তালিকা যা একজন উত্তরদাতাকে বেছে নিতে হবে।

shuffle

boolean

কুইজের বিভিন্ন উদাহরণের জন্য বিকল্পগুলি এলোমেলো ক্রমে প্রদর্শিত হবে কিনা। এটি প্রায়শই উত্তরদাতাদের দ্বারা প্রতারণা রোধ করতে ব্যবহৃত হয় যারা অন্য উত্তরদাতার পর্দার দিকে তাকিয়ে থাকতে পারে, অথবা একটি সমীক্ষায় পক্ষপাত দূর করতে যা সর্বদা একই বিকল্পগুলিকে প্রথম বা শেষ করে চালু করা হতে পারে।

চয়েস টাইপ

পছন্দের ধরন।

এনামস
CHOICE_TYPE_UNSPECIFIED ডিফল্ট মান। অব্যবহৃত।
RADIO রেডিও বোতাম: সমস্ত পছন্দ ব্যবহারকারীকে দেখানো হয়, যারা শুধুমাত্র একটি বেছে নিতে পারে।
CHECKBOX চেকবক্স: সমস্ত পছন্দ ব্যবহারকারীকে দেখানো হয়, যারা সেগুলির যেকোনো সংখ্যা বেছে নিতে পারে।
DROP_DOWN ড্রপ-ডাউন মেনু: পছন্দগুলি শুধুমাত্র চাহিদা অনুযায়ী ব্যবহারকারীকে দেখানো হয়, অন্যথায় শুধুমাত্র বর্তমান পছন্দ দেখানো হয়। শুধুমাত্র একটি বিকল্প বেছে নেওয়া যেতে পারে।

অপশন

চয়েস প্রশ্নের জন্য একটি বিকল্প।

JSON প্রতিনিধিত্ব 
{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}
ক্ষেত্র
value

string

প্রয়োজন। ব্যবহারকারীর কাছে উপস্থাপিত পছন্দ।

image

object ( Image )

একটি বিকল্প হিসাবে চিত্র প্রদর্শন করুন.

isOther

boolean

বিকল্পটি "অন্য" কিনা। বর্তমানে শুধুমাত্র RADIO এবং CHECKBOX পছন্দের প্রকারের ক্ষেত্রে প্রযোজ্য, কিন্তু একটি