ভূমিকা

Google ডক্স API আপনাকে নথি তৈরি এবং সংশোধন করতে দেয়৷

অ্যাপগুলি ব্যবহারকারী এবং সিস্টেম-প্রদত্ত ডেটা উভয় থেকে পালিশড নথি তৈরি করতে ডক্স API-এর সাথে একীভূত হতে পারে। API আপনাকে অনুমতি দেয়:

  • স্বয়ংক্রিয় প্রক্রিয়া
  • বাল্ক ডকুমেন্টেশন তৈরি করুন
  • চালান বা চুক্তি তৈরি করুন

API এর ওভারভিউ

ডকুমেন্ট রিসোর্স আপনি ডক্স এপিআই চালু করার জন্য যে পদ্ধতিগুলি ব্যবহার করেন তা প্রদান করে।

API পদ্ধতি

নিম্নলিখিত পদ্ধতিগুলি আপনাকে Google ডক্স ডকুমেন্ট তৈরি করতে, পড়তে এবং আপডেট করতে দেয়:

  • একটি নথি তৈরি করতে documents.create ব্যবহার করুন।
  • একটি নির্দিষ্ট নথির বিষয়বস্তু পুনরুদ্ধার করতে documents.get ব্যবহার করুন।
  • একটি নির্দিষ্ট নথিতে আপডেটের একটি সেট পারমাণবিকভাবে সম্পাদন করতে documents.batchUpdate ব্যবহার করুন।

টার্গেট ডকুমেন্ট নির্দিষ্ট করতে একটি প্যারামিটার হিসাবে get এবং batchUpdate পদ্ধতিতে একটি documentId (নীচে দেখুন) প্রয়োজন। create পদ্ধতিটি তৈরি করা নথির একটি উদাহরণ প্রদান করে, যেখান থেকে আপনি আইডিটি পড়তে পারেন।

ব্যাচ আপডেট

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

batchUpdate পদ্ধতি প্রতিক্রিয়া বস্তুর একটি তালিকা প্রদান করে। এই তালিকার বস্তুগুলি সংশ্লিষ্ট অনুরোধের মতো একই সূচক ক্রম দখল করে।

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

ডকুমেন্ট আইডি

ডকুমেন্ট আইডি একটি নথির উল্লেখ করে এবং সেগুলি URL থেকে নেওয়া যেতে পারে:

https://docs.google.com/document/d/documentId/edit

documentId হল একটি অনন্য স্ট্রিং যাতে অক্ষর, সংখ্যা এবং কিছু বিশেষ অক্ষর থাকে। Google ডক্স ইউআরএল থেকে ডকুমেন্ট আইডি বের করতে নিম্নলিখিত রেগুলার এক্সপ্রেশন ব্যবহার করা যেতে পারে:

/document/d/([a-zA-Z0-9-_]+)

আপনি যদি Google Drive API-এর সাথে পরিচিত হন, তাহলে documentId ফাইল রিসোর্সের আইডির সাথে মিলে যায়।

একটি নথির মধ্যে অবস্থান: সূচী

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

ডকুমেন্ট আপডেট ওয়ার্কফ্লো

একটি নতুন দস্তাবেজ তৈরি করা এবং পপুলেট করা সহজ, যেহেতু উদ্বিগ্ন হওয়ার মতো কোনও বিদ্যমান সামগ্রী নেই এবং এমন কোনও সহযোগী নেই যারা নথির অবস্থা পরিবর্তন করতে পারে৷ ধারণাগতভাবে, এটি নিম্নলিখিত ক্রম চিত্রে দেখানো হিসাবে কাজ করে:

একটি নতুন নথি তৈরি এবং পপুলেট করার জন্য ওয়ার্কফ্লো।

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

একটি নথি আপডেট করতে কর্মপ্রবাহ।

এই চিত্রটি কর্মপ্রবাহ বিবেচনা করে না যেখানে একই নথিতে অন্যান্য সহযোগীদের দ্বারা সমসাময়িক আপডেট করা হয়। এই বিষয়ের আলোচনার জন্য সহযোগিতার পরিকল্পনা দেখুন।