Method: forms.batchUpdate

আপডেটের ব্যাচের সাথে ফর্মটি পরিবর্তন করুন।

HTTP অনুরোধ

POST https://forms.googleapis.com/v1/forms/{formId}:batchUpdate

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
formId

string

প্রয়োজন। ফর্ম আইডি।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "includeFormInResponse": boolean,
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
ক্ষেত্র
includeFormInResponse

boolean

প্রতিক্রিয়ায় মডেলটির আপডেট করা সংস্করণ ফেরত দেওয়া হবে কিনা।

requests[]

object ( Request )

প্রয়োজন। এই ব্যাচের আপডেট অনুরোধ.

writeControl

object ( WriteControl )

লেখার অনুরোধ কিভাবে কার্যকর করা হয় তার উপর নিয়ন্ত্রণ প্রদান করে।

প্রতিক্রিয়া শরীর

একটি BatchUpdateFormRequest এর প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "form": {
    object (Form)
  },
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
ক্ষেত্র
form

object ( Form )

বুল রিকোয়েস্ট ফিল্ডের ভিত্তিতে includeFormInResponse , সমস্ত প্রয়োগকৃত মিউটেশন/আপডেট সহ একটি ফর্ম ফেরত দেওয়া হয় বা না হয়। এটি এই পরিবর্তনগুলির দ্বারা তৈরি রিভিশন আইডির পরে হতে পারে৷

replies[]

object ( Response )

আপডেটের উত্তর। এই মানচিত্র 1:1 আপডেট অনুরোধের সাথে, যদিও কিছু অনুরোধের উত্তর খালি হতে পারে।

writeControl

object ( WriteControl )

অনুরোধ প্রয়োগ করার পরে আপডেট করা লেখা নিয়ন্ত্রণ।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/forms.body

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।

অনুরোধ

যে ধরনের আপডেট অনুরোধ করা যেতে পারে।

JSON প্রতিনিধিত্ব
{

  // Union field kind can be only one of the following:
  "updateFormInfo": {
    object (UpdateFormInfoRequest)
  },
  "updateSettings": {
    object (UpdateSettingsRequest)
  },
  "createItem": {
    object (CreateItemRequest)
  },
  "moveItem": {
    object (MoveItemRequest)
  },
  "deleteItem": {
    object (DeleteItemRequest)
  },
  "updateItem": {
    object (UpdateItemRequest)
  }
  // End of list of possible types for union field kind.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্র kind . অনুরোধের ধরন। kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
updateFormInfo

object ( UpdateFormInfoRequest )

ফর্মের তথ্য আপডেট করুন।

updateSettings

object ( UpdateSettingsRequest )

ফর্মের সেটিংস আপডেট করে।

createItem

object ( CreateItemRequest )

একটি নতুন আইটেম তৈরি করুন.

moveItem

object ( MoveItemRequest )

একটি নির্দিষ্ট স্থানে একটি আইটেম সরান.

deleteItem

object ( DeleteItemRequest )

একটি আইটেম মুছুন.

updateItem

object ( UpdateItemRequest )

একটি আইটেম আপডেট করুন.

UpdateFormInfoRequest

ফর্মের তথ্য আপডেট করুন।

JSON প্রতিনিধিত্ব
{
  "info": {
    object (Info)
  },
  "updateMask": string
}
ক্ষেত্র
info

object ( Info )

আপডেট করার জন্য তথ্য.

updateMask

string ( FieldMask format)

প্রয়োজন। এই মুখোশের নাম শুধুমাত্র মান পরিবর্তন করা হয়. অন্তত একটি ক্ষেত্র নির্দিষ্ট করা আবশ্যক। মূল info নিহিত এবং নির্দিষ্ট করা উচিত নয়। প্রতিটি ক্ষেত্র আপডেট করার জন্য একটি একক "*" শর্ট-হ্যান্ড হিসাবে ব্যবহার করা যেতে পারে।

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

আপডেট সেটিং অনুরোধ

ফর্মের FormSettings আপডেট করুন।

JSON প্রতিনিধিত্ব
{
  "settings": {
    object (FormSettings)
  },
  "updateMask": string
}
ক্ষেত্র
settings

object ( FormSettings )

প্রয়োজন। আপডেট করার জন্য সেটিংস।

updateMask

string ( FieldMask format)

প্রয়োজন। এই মুখোশের নাম শুধুমাত্র মান পরিবর্তন করা হয়. অন্তত একটি ক্ষেত্র নির্দিষ্ট করা আবশ্যক। রুট settings নিহিত এবং নির্দিষ্ট করা উচিত নয়। প্রতিটি ক্ষেত্র আপডেট করার জন্য একটি একক "*" শর্ট-হ্যান্ড হিসাবে ব্যবহার করা যেতে পারে।

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

আইটেম অনুরোধ তৈরি করুন

একটি ফর্ম একটি আইটেম তৈরি করুন.

JSON প্রতিনিধিত্ব
{
  "item": {
    object (Item)
  },
  "location": {
    object (Location)
  }
}
ক্ষেত্র
item

object ( Item )

প্রয়োজন। আইটেম তৈরি করতে.

location

object ( Location )

প্রয়োজন। নতুন জিনিস কোথায় রাখবেন।

অবস্থান

একটি ফর্ম একটি নির্দিষ্ট অবস্থান.

JSON প্রতিনিধিত্ব
{

  // Union field where can be only one of the following:
  "index": integer
  // End of list of possible types for union field where.
}
ক্ষেত্র
ইউনিয়ন মাঠ where . প্রয়োজন। ফর্মে একটি অবস্থান উল্লেখ করুন। where নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
index

integer

আকারে একটি আইটেমের সূচক। এই পরিসীমা হতে হবে

[0.. N )

, যেখানে N হল ফর্মের আইটেমের সংখ্যা।

MoveItemRequest

একটি ফর্ম একটি আইটেম সরান.

JSON প্রতিনিধিত্ব
{
  "originalLocation": {
    object (Location)
  },
  "newLocation": {
    object (Location)
  }
}
ক্ষেত্র
originalLocation

object ( Location )

প্রয়োজন। সরানোর জন্য আইটেমটির অবস্থান।

newLocation

object ( Location )

প্রয়োজন। আইটেম জন্য নতুন অবস্থান.

আইটেম রিকোয়েস্ট মুছুন

একটি ফর্ম একটি আইটেম মুছুন.

JSON প্রতিনিধিত্ব
{
  "location": {
    object (Location)
  }
}
ক্ষেত্র
location

object ( Location )

প্রয়োজন। মুছে ফেলা আইটেম অবস্থান.

UpdateItemRequest

একটি ফর্ম একটি আইটেম আপডেট.

JSON প্রতিনিধিত্ব
{
  "item": {
    object (Item)
  },
  "location": {
    object (Location)
  },
  "updateMask": string
}
ক্ষেত্র
item

object ( Item )

প্রয়োজন। আইটেম জন্য নতুন মান. মনে রাখবেন যে আইটেম এবং প্রশ্ন আইডি ব্যবহার করা হয় যদি সেগুলি প্রদান করা হয় (এবং ফিল্ড মাস্কে থাকে)। যদি একটি আইডি খালি থাকে (এবং ক্ষেত্রের মাস্কে) একটি নতুন আইডি তৈরি হয়। এর মানে হল আপনি forms.get এর মাধ্যমে ফর্ম পেয়ে একটি আইটেম পরিবর্তন করতে পারেন, সেই আইটেমের আপনার স্থানীয় অনুলিপিটি আপনি যেভাবে চান তা পরিবর্তন করে এবং UpdateItemRequest ব্যবহার করে এটিকে আবার লিখতে পারেন, আইডিগুলি একই (বা ক্ষেত্রের মধ্যে নয়) মুখোশ)।

location

object ( Location )

প্রয়োজন। আপডেট করার জন্য আইটেম সনাক্তকারী অবস্থান।

updateMask

string ( FieldMask format)

প্রয়োজন। এই মুখোশের নাম শুধুমাত্র মান পরিবর্তন করা হয়.

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

WriteControl

লেখার অনুরোধ কিভাবে কার্যকর করা হয় তার উপর নিয়ন্ত্রণ প্রদান করে।

JSON প্রতিনিধিত্ব
{

  // Union field control can be only one of the following:
  "requiredRevisionId": string,
  "targetRevisionId": string
  // End of list of possible types for union field control.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্র control । যে ফর্ম থেকে পরিবর্তনগুলি প্রয়োগ করা হবে তার সংশোধন নির্ধারণ করে এবং সেই সংশোধন যদি ফর্মের বর্তমান সংশোধন না হয় তাহলে অনুরোধটি কীভাবে আচরণ করা উচিত। control নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
requiredRevisionId

string

যে ফর্মের রিভিশন আইডিতে লেখার অনুরোধ করা হয়েছে। যদি এটি ফর্মের সর্বশেষ সংশোধন না হয়, তবে অনুরোধটি প্রক্রিয়া করা হয় না এবং একটি 400 খারাপ অনুরোধ ত্রুটি ফেরত দেয়৷

targetRevisionId

string

যে ফর্মে লেখার অনুরোধ প্রয়োগ করা হয়েছে তার টার্গেট রিভিশন আইডি।

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

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

প্রতিক্রিয়া

একটি আপডেট থেকে একটি একক প্রতিক্রিয়া.

JSON প্রতিনিধিত্ব
{

  // Union field kind can be only one of the following:
  "createItem": {
    object (CreateItemResponse)
  }
  // End of list of possible types for union field kind.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্র kind . প্রতিক্রিয়া ধরনের. kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
createItem

object ( CreateItemResponse )

একটি আইটেম তৈরি ফলাফল.

আইটেম রেসপন্স তৈরি করুন

একটি আইটেম তৈরি ফলাফল.

JSON প্রতিনিধিত্ব
{
  "itemId": string,
  "questionId": [
    string
  ]
}
ক্ষেত্র
itemId

string

তৈরি আইটেম আইডি.

questionId[]

string

এই আইটেমটির অংশ হিসাবে তৈরি করা প্রশ্নের আইডি, একটি প্রশ্ন গোষ্ঠীর জন্য এটি এই আইটেমের জন্য তৈরি করা সমস্ত প্রশ্নের ID তালিকা করে।