সেরা ফলাফলের জন্য সর্বোত্তম অনুশীলন

Google দস্তাবেজ API ব্যবহার করার সময় আপনার অনুসরণ করা উচিত বেশ কয়েকটি নীতি। এর মধ্যে রয়েছে:

  • দক্ষতার জন্য পিছনের দিকে সম্পাদনা করুন
  • সহযোগিতার জন্য পরিকল্পনা করুন
  • WriteControl ক্ষেত্র ব্যবহার করে রাষ্ট্রের ধারাবাহিকতা নিশ্চিত করুন

নিম্নলিখিত বিভাগগুলি এই নীতিগুলি ব্যাখ্যা করে।

দক্ষতার জন্য পিছনের দিকে সম্পাদনা করুন

documents.batchUpdate পদ্ধতিতে একটি একক কলের মধ্যে, আপনার অনুরোধগুলি সূচী অবস্থানের ক্রমানুসারে অর্ডার করুন। এটি সন্নিবেশ এবং মুছে ফেলার কারণে সূচক পরিবর্তনগুলি গণনা করার প্রয়োজনীয়তা দূর করে।

সহযোগিতার জন্য পরিকল্পনা করুন

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

পদ্ধতি কলের মধ্যে একটি নথি কীভাবে পরিবর্তন করতে পারে।

আপনার সূচী ভুল হলে এটি ত্রুটি হতে পারে। একাধিক ব্যবহারকারী UI ব্যবহার করে একটি নথি সম্পাদনা করে, Google ডক্স স্বচ্ছভাবে এর যত্ন নেয়। যাইহোক, একজন API ক্লায়েন্ট হিসাবে আপনার অ্যাপকে অবশ্যই এটি পরিচালনা করতে হবে। এমনকি যদি আপনি নথিতে সহযোগিতার প্রত্যাশা না করেন, তবে এটি সুরক্ষামূলকভাবে প্রোগ্রাম করা এবং নথির অবস্থা সামঞ্জস্যপূর্ণ থাকে তা নিশ্চিত করা গুরুত্বপূর্ণ। ধারাবাহিকতা নিশ্চিত করার এক উপায়ের জন্য, WriteControl বিভাগটি পর্যালোচনা করুন।

WriteControl এর সাথে রাষ্ট্রের সামঞ্জস্য স্থাপন করুন

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

আপনি এটি কীভাবে ব্যবহার করেন তা এখানে:

  1. documents.get মেথড ব্যবহার করে ডকুমেন্টটি পান এবং রিটার্ন করা documents রিসোর্স থেকে revisionId সেভ করুন।
  2. আপনার আপডেট অনুরোধ রচনা করুন.
  3. দুটি বিকল্পের একটি সহ একটি ঐচ্ছিক WriteControl অবজেক্ট অন্তর্ভুক্ত করুন:
    1. requiredRevisionId ক্ষেত্রটি যে নথিতে লেখার অনুরোধ প্রয়োগ করা হয়েছে তার revisionId আইডিতে সেট করা আছে। এপিআই রিড রিকোয়েস্টের পর থেকে ডকুমেন্টটি পরিবর্তন করা হলে লেখার অনুরোধ প্রসেস করা হয় না এবং এটি একটি ত্রুটি ফেরত দেয়।
    2. targetRevisionId ক্ষেত্রটি নথির revisionId আইডিতে সেট করা হয়েছে যেটিতে লেখার অনুরোধ প্রয়োগ করা হয়েছে। এপিআই রিড রিকোয়েস্টের পর থেকে ডকুমেন্টটি পরিবর্তন করা হলে, লেখার অনুরোধের পরিবর্তনগুলি সহযোগী পরিবর্তনের বিরুদ্ধে প্রয়োগ করা হয়। লেখার অনুরোধের ফলাফলে লেখার অনুরোধের পরিবর্তন এবং সহযোগী নথির একটি নতুন সংশোধনে পরিবর্তন উভয়ই অন্তর্ভুক্ত করে। ডক্স সার্ভার বিষয়বস্তু মার্জ করার জন্য দায়ী৷

WriteControl ব্যবহার করে কীভাবে একটি ব্যাচ অনুরোধ তৈরি করতে হয় তার উদাহরণের জন্য, এই ব্যাচ অনুরোধের উদাহরণটি দেখুন।