Method: spreadsheets.batchUpdate

স্প্রেডশিটে এক বা একাধিক আপডেট প্রয়োগ করে।

প্রতিটি request প্রয়োগ করার আগে যাচাই করা হয়। যদি কোনো অনুরোধ বৈধ না হয়, তাহলে সম্পূর্ণ অনুরোধ প্রক্রিয়াটি ব্যর্থ হবে এবং কিছুই প্রয়োগ করা হবে না।

কিছু অনুরোধের সাথে replies থাকে, যা আপনাকে সেগুলি কীভাবে প্রয়োগ করা হয় সে সম্পর্কে কিছু তথ্য দেয়। উত্তরগুলো অনুরোধগুলোরই প্রতিচ্ছবি হবে। উদাহরণস্বরূপ, যদি আপনি ৪টি আপডেট প্রয়োগ করেন এবং ৩য়টির একটি উত্তর থাকে, তাহলে প্রতিক্রিয়াটিতে ক্রমানুসারে ২টি খালি উত্তর, আসল উত্তর এবং আরেকটি খালি উত্তর থাকবে।

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

HTTP অনুরোধ

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

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

পথের পরামিতি

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

string

যে স্প্রেডশিটটিতে আপডেটগুলো প্রয়োগ করতে হবে।

অনুরোধকারী শরীর

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

JSON উপস্থাপনা 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean,
  "commentsViewMode": enum (CommentsViewMode)
}
ক্ষেত্র
requests[]

object ( Request )

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

includeSpreadsheetInResponse

boolean

আপডেট প্রতিক্রিয়ায় স্প্রেডশীট রিসোর্সটি অন্তর্ভুক্ত করা হবে কিনা তা নির্ধারণ করে।

responseRanges[]

string

রেসপন্স স্প্রেডশিটে অন্তর্ভুক্ত পরিসর সীমিত করে। শুধুমাত্র includeSpreadsheetInResponse মান 'true' হলেই এটি অর্থবহ হয়।

responseIncludeGridData

boolean

গ্রিড ডেটা ফেরত দেওয়া হবে কিনা তার জন্য 'ট্রু'। শুধুমাত্র includeSpreadsheetInResponse মান 'true' হলেই এটি অর্থবহ। অনুরোধে কোনো ফিল্ড মাস্ক সেট করা থাকলে এই প্যারামিটারটি উপেক্ষা করা হয়।

commentsViewMode

enum ( CommentsViewMode )

স্প্রেডশিটে প্রয়োগ করার জন্য মন্তব্য দেখার মোড। এটি মন্তব্য বাদ দিয়ে বা অন্তর্ভুক্ত করে স্প্রেডশিটটি দেখার সুযোগ দেয়। যদি কোনো মোড নির্দিষ্ট করা না থাকে, তাহলে COMMENTS_VIEW_MODE_OMITTED ব্যবহৃত হয়। এটি কেবল তখনই অর্থবহ হবে যখন includeSpreadsheetInResponse মান 'true' হবে।

প্রতিক্রিয়া সংস্থা

স্প্রেডশিটে ব্যাচ আপডেট করার উত্তর।

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

JSON উপস্থাপনা 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
ক্ষেত্র
spreadsheetId

string

যে স্প্রেডশিটটিতে আপডেটগুলো প্রয়োগ করা হয়েছিল।

replies[]

object ( Response )

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

updatedSpreadsheet

object ( Spreadsheet )

আপডেট প্রয়োগ করার পরের স্প্রেডশিট। এটি শুধুমাত্র তখনই সেট করা হয়, যদি BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response এর true হয়।

commentUpdateState

enum ( CommentUpdateState )

ব্যাচ অনুরোধে মন্তব্যের আপডেটগুলো প্রয়োগ করা হয়েছে কিনা।

অনুমোদনের পরিধি

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

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

মন্তব্য আপডেট অবস্থা

ব্যাচ অনুরোধে মন্তব্যের অবস্থা আপডেট হয়।

এনাম
COMMENT_UPDATE_STATE_UNSPECIFIED মন্তব্য আপডেটের অবস্থা অনির্দিষ্ট।
NO_UPDATES_REQUESTED ব্যাচ অনুরোধে কোনো মন্তব্য হালনাগাদের অনুরোধ করা হয়নি।
ALL_SAVED অনুরোধকৃত সকল মন্তব্য আপডেট ব্যাচ অনুরোধের মাধ্যমে প্রয়োগ করা হয়েছে।
ALL_FAILED_UNKNOWN_REASON অনুরোধ করা সমস্ত মন্তব্য আপডেট ব্যর্থ হয়েছে।