Method: presentations.batchUpdate

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

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

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

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

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

HTTP অনুরোধ

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

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

পথের পরামিতি

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

string

আপডেটগুলো প্রয়োগ করার জন্য প্রেজেন্টেশনটি।

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

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

JSON উপস্থাপনা
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
ক্ষেত্র
requests[]

object ( Request )

প্রেজেন্টেশনটিতে প্রয়োগ করার জন্য আপডেটগুলির একটি তালিকা।

writeControl

object ( WriteControl )

রাইট রিকোয়েস্টগুলো কীভাবে কার্যকর করা হবে, তার ওপর নিয়ন্ত্রণ প্রদান করে।

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

ব্যাচ আপডেটের প্রতিক্রিয়া বার্তা।

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

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

string

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

replies[]

object ( Response )

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

writeControl

object ( WriteControl )

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

commentUpdateState

enum ( CommentUpdateState )

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

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

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

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

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

রাইটকন্ট্রোল

রাইট রিকোয়েস্টগুলো কীভাবে কার্যকর করা হবে, তার ওপর নিয়ন্ত্রণ প্রদান করে।

JSON উপস্থাপনা
{
  "requiredRevisionId": string
}
ক্ষেত্র
requiredRevisionId

string

রাইট রিকোয়েস্টের জন্য প্রয়োজনীয় প্রেজেন্টেশনের revision ID । যদি এটি নির্দিষ্ট করা হয় এবং প্রয়োজনীয় রিভিশন আইডিটি প্রেজেন্টেশনের বর্তমান রিভিশন আইডির সাথে না মেলে, তাহলে রিকোয়েস্টটি প্রসেস করা হয় না এবং একটি 400 ব্যাড রিকোয়েস্ট এরর রিটার্ন করে।

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

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

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

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