এই নির্দেশিকাটি প্রাথমিক অনুরোধ এবং প্রতিক্রিয়া পদ্ধতিগুলি প্রবর্তন করে যা Google ডক্স এপিআই তৈরি করে এবং কীভাবে আপনি ব্যাচে একটি নথি আপডেট করতে পারেন।
আপনি একটি HTTP অনুরোধ ব্যবহার করে, অথবা একটি ভাষা-নির্দিষ্ট ক্লায়েন্ট লাইব্রেরিতে একটি পদ্ধতির আমন্ত্রণ ব্যবহার করে Google ডক্স API-কে আহ্বান করতে পারেন৷ এগুলি ব্যাপকভাবে সমতুল্য।
Google ডক্স API একটি HTTP প্রতিক্রিয়া প্রদান করে, যা সাধারণত অনুরোধ আহ্বানের ফলাফল অন্তর্ভুক্ত করে। অনুরোধ করার জন্য একটি ক্লায়েন্ট লাইব্রেরি ব্যবহার করার সময়, প্রতিক্রিয়াগুলি একটি ভাষা-নির্দিষ্ট উপায়ে ফেরত দেওয়া হয়।
পদ্ধতির অনুরোধ করুন
ডক্স API নিম্নলিখিত পদ্ধতিগুলিকে সমর্থন করে:
documents.create: একটি ফাঁকা Google ডক্স ডকুমেন্ট তৈরি করুন।documents.get: নির্দিষ্ট নথির একটি সম্পূর্ণ উদাহরণ প্রদান করুন। নথির বিষয়বস্তু, ফর্ম্যাটিং এবং অন্যান্য বৈশিষ্ট্যগুলি বের করতে আপনি ফিরে আসা JSON পার্স করতে পারেন।documents.batchUpdate: নথিতে পারমাণবিকভাবে প্রয়োগ করার জন্য সম্পাদনা অনুরোধের একটি তালিকা জমা দিন এবং ফলাফলের একটি তালিকা ফেরত দিন।
documents.get এবং documents.batchUpdate পদ্ধতিতে লক্ষ্য নথি নির্দিষ্ট করার জন্য একটি পরামিতি হিসাবে একটি documentId প্রয়োজন। documents.create পদ্ধতি তৈরি করা নথির একটি উদাহরণ প্রদান করে, যেখান থেকে আপনি documentId পড়তে পারেন। documentId সম্পর্কে আরও তথ্যের জন্য, ডকুমেন্ট আইডি দেখুন।
মনে রাখবেন আপনি প্রকাশিত নথি পুনরুদ্ধার করতে documents.get পদ্ধতি ব্যবহার করতে পারবেন না। একবার প্রকাশিত হলে, সর্বজনীন নথি একটি ভিন্ন URL বিন্যাস ব্যবহার করে। documents.get পদ্ধতির সাথে URL এর নতুন documentId ব্যবহার করার প্রচেষ্টা একটি 404 HTTP স্ট্যাটাস কোড প্রতিক্রিয়া প্রদান করে। প্রকাশিত URL থেকে মূল documentId পুনরুদ্ধার করার কোন পদ্ধতি নেই। এই সমস্যাটির সমাধানের জন্য, আপনি ড্রাইভ এপিআই ব্যবহার করে প্রকাশিত নথিটি একটি ভাগ করা নথিতে অনুলিপি করতে পারেন এবং তারপরে পরিবর্তে এই ফাইলটি অ্যাক্সেস করতে পারেন৷ আরও তথ্যের জন্য, Google দস্তাবেজ, পত্রক, স্লাইড এবং ফর্মগুলিকে সর্বজনীন করুন দেখুন৷
ব্যাচ আপডেট
documents.batchUpdate পদ্ধতি request বস্তুর একটি তালিকা নেয়, প্রতিটি একটি একক অনুরোধ সম্পাদন করার জন্য নির্দিষ্ট করে। উদাহরণস্বরূপ, একটি অনুচ্ছেদ বিন্যাস করুন এবং তারপর একটি ইনলাইন চিত্র যোগ করুন। প্রতিটি অনুরোধ প্রয়োগ করার আগে যাচাই করা হয় এবং অনুরোধগুলি ব্যাচের অনুরোধে প্রদর্শিত ক্রম অনুসারে প্রক্রিয়া করা হয়।
ব্যাচ আপডেটের সমস্ত অনুরোধ পারমাণবিকভাবে প্রয়োগ করা হয়। অর্থাৎ, যদি কোনো অনুরোধ বৈধ না হয়, তাহলে সম্পূর্ণ আপডেট ব্যর্থ হয় এবং (সম্ভাব্যভাবে নির্ভরশীল) পরিবর্তনগুলির কোনোটিই প্রয়োগ করা হয় না।
কিছু documents.batchUpdate পদ্ধতি প্রয়োগ করা অনুরোধ সম্পর্কে তথ্য সহ প্রতিক্রিয়া প্রদান করে। এই পদ্ধতিগুলি একটি প্রতিক্রিয়া বডি প্রদান করে যাতে response বস্তুর একটি তালিকা থাকে। অন্যান্য অনুরোধের তথ্য ফেরত দিতে হবে না এবং খালি উত্তর দিতে হবে। প্রতিক্রিয়া তালিকার বস্তুগুলি সংশ্লিষ্ট অনুরোধের মতো একই সূচক ক্রম দখল করে।
ব্যাচ অনুরোধ করার জন্য একটি জনপ্রিয় প্যাটার্ন এই মত দেখায়:
requests = []
requests.append(first request)
requests.append(second request)
...
body = ... & requests & ...
...batchUpdate(body)
আপনার ডক্স এপিআই কল এবং documents.batchUpdate রেফারেন্স ডকুমেন্টেশন এবং প্রতিক্রিয়া প্রকারের জন্য কীভাবে ব্যাচ করবেন তার সম্পূর্ণ বিশদ বিবরণের জন্য ব্যাচ অনুরোধের সর্বোত্তম অনুশীলনগুলি দেখুন৷
ব্যাচ আপডেট অপারেশন
ব্যাচ আপডেট অনুরোধ বিভিন্ন ধরনের আছে. এখানে অনুরোধের প্রকারের একটি ব্রেকডাউন রয়েছে, বিভিন্ন বিভাগে গোষ্ঠীবদ্ধ।