Method: documents.batchUpdate

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

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

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

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

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

HTTP অনুরোধ

POST https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate

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

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

পরামিতি
documentId

string

আপডেট করার জন্য নথির আইডি।

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

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

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

object ( Request )

নথিতে আবেদন করার জন্য আপডেটের একটি তালিকা।

writeControl

object ( WriteControl )

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

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

একটি documents.batchUpdate অনুরোধ থেকে প্রতিক্রিয়া বার্তা.

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

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

string

নথির আইডি যেখানে আপডেটগুলি প্রয়োগ করা হয়েছে৷

replies[]

object ( Response )

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

writeControl

object ( WriteControl )

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

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

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

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

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

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

যে নথিতে লেখার অনুরোধটি প্রয়োগ করা হয়েছে তার ঐচ্ছিক revision ID । যদি এটি নথির সর্বশেষ সংশোধন না হয়, তবে অনুরোধটি প্রক্রিয়া করা হয় না এবং একটি 400 খারাপ অনুরোধ ত্রুটি ফেরত দেয়৷

যখন একটি প্রয়োজনীয় পুনর্বিবেচনা আইডি একটি প্রতিক্রিয়াতে ফেরত দেওয়া হয়, তখন অনুরোধটি প্রয়োগ করার পরে এটি নথির সংশোধন আইডি নির্দেশ করে৷

targetRevisionId

string

যে নথিতে লেখার অনুরোধ প্রয়োগ করা হয়েছে তার ঐচ্ছিক লক্ষ্য revision ID ।

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

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