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 ব্যবহার করে ডকুমেন্টটি পড়ার পরে সহযোগীর পরিবর্তন ঘটে থাকে, তাহলে এই লেখার অনুরোধের মাধ্যমে সৃষ্ট পরিবর্তনগুলি সহযোগীর পরিবর্তনের বিরুদ্ধে প্রয়োগ করা হয়। এর ফলে ডকুমেন্টের একটি নতুন সংস্করণ তৈরি হয় যা সহযোগীর পরিবর্তন এবং অনুরোধের পরিবর্তন উভয়কেই অন্তর্ভুক্ত করে, যেখানে ডক্স সার্ভার বিরোধপূর্ণ পরিবর্তনগুলি সমাধান করে। টার্গেট রিভিশন আইডি ব্যবহার করার সময়, API ক্লায়েন্টকে ডকুমেন্টের অন্য সহযোগী হিসাবে ভাবা যেতে পারে।

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