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

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

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

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

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

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

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

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

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

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

WriteControl এর সাথে রাজ্যের সামঞ্জস্য নিশ্চিত করুন

আপনি যখন একটি নথি পড়েন এবং তারপর আপডেট করেন, তখন আপনি নিশ্চিত করতে পারেন যে BatchUpdate পদ্ধতিতে WriteControl ক্ষেত্র ব্যবহার করে নথিটি আপডেট করা হয়নি। এটি আপনাকে দস্তাবেজে সম্পাদনা করতে দেয় শুধুমাত্র যদি সংস্করণটি পরিবর্তিত না হয়। আপনি এটি কীভাবে ব্যবহার করেন তা এখানে:

  1. দস্তাবেজটি পান এবং এতে অন্তর্ভুক্ত করা revisionId স্ট্রিংটি সংরক্ষণ করুন।
  2. আপনার আপডেট অনুরোধ রচনা করুন.
  3. আপনার সংরক্ষিত স্ট্রিংটিতে প্রয়োজনীয় RevisionId সেট সহ একটি WriteControl অবজেক্ট অন্তর্ভুক্ত করুন।
  4. আপনি যখন BatchUpdate কল করেন, যদি নথির সংশোধন পরিবর্তন করা হয় তবে এটি একটি ত্রুটি প্রদান করে এবং একটি আপডেট সম্পাদন করে না।