অনুরোধ এবং প্রতিক্রিয়া

এই নির্দেশিকাটি প্রাথমিক অনুরোধ এবং প্রতিক্রিয়া পদ্ধতিগুলি প্রবর্তন করে যা 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.batchUpdate পদ্ধতি request বস্তুর একটি তালিকা নেয়, প্রতিটি একটি একক অনুরোধ সম্পাদন করার জন্য নির্দিষ্ট করে। উদাহরণস্বরূপ, একটি অনুচ্ছেদ বিন্যাস করুন এবং তারপর একটি ইনলাইন চিত্র যোগ করুন। প্রতিটি অনুরোধ প্রয়োগ করার আগে যাচাই করা হয় এবং অনুরোধগুলি ব্যাচের অনুরোধে প্রদর্শিত ক্রম অনুসারে প্রক্রিয়া করা হয়।

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

কিছু documents.batchUpdate পদ্ধতি প্রয়োগ করা অনুরোধ সম্পর্কে তথ্য সহ প্রতিক্রিয়া প্রদান করে। এই পদ্ধতিগুলি একটি প্রতিক্রিয়া বডি প্রদান করে যাতে response বস্তুর একটি তালিকা থাকে। অন্যান্য অনুরোধের তথ্য ফেরত দিতে হবে না এবং খালি উত্তর দিতে হবে। প্রতিক্রিয়া তালিকার বস্তুগুলি সংশ্লিষ্ট অনুরোধের মতো একই সূচক ক্রম দখল করে।

ব্যাচ অনুরোধ করার জন্য একটি জনপ্রিয় প্যাটার্ন এই মত দেখায়:

requests = []
requests.append(first request)
requests.append(second request)
...

body = ... & requests & ...

...batchUpdate(body)

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

ব্যাচ আপডেট অপারেশন

ব্যাচ আপডেট অনুরোধ বিভিন্ন ধরনের আছে. এখানে অনুরোধের প্রকারের একটি ব্রেকডাউন রয়েছে, বিভিন্ন বিভাগে গোষ্ঠীবদ্ধ।

অবজেক্ট ADD/INSERT আপডেট / প্রতিস্থাপন মুছুন
পাঠ্য InsertTextRequest AllTextRequest প্রতিস্থাপন করুন
শৈলী ParagraphBulletsRequest তৈরি করুন UpdateTextStyleRequest
অনুচ্ছেদশৈলীর অনুরোধ আপডেট করুন
UpdateTableCellStyleRequest
UpdateTableRowStyleRequest
UpdateDocumentStyleRequest
UpdateSectionStyleRequest
অনুচ্ছেদ মুছুন বুলেট অনুরোধ
নাম দেওয়া রেঞ্জ NamedRangeRequest তৈরি করুন ReplaceNamedRangeContentRequest নামযুক্ত রেঞ্জের অনুরোধ মুছুন
DeleteContentRangeRequest
ছবি InsertInlineImageRequest প্রতিস্থাপন চিত্র অনুরোধ
টেবিল InsertTableRequest
InsertTableRowRequest
InsertTableColumnRequest
UpdateTableColumnPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
PinTableHeaderRowsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
পৃষ্ঠা অবজেক্ট ( শিরোনাম এবং ফুটার সহ) InsertPageBreakRequest
HeaderRequest তৈরি করুন
ফুটারের অনুরোধ তৈরি করুন
পাদটীকা অনুরোধ তৈরি করুন
ইনসার্ট সেকশনব্রেক রিকোয়েস্ট
ডিলিট পজিশন করা অবজেক্ট রিকোয়েস্ট
হেডার রিকোয়েস্ট মুছুন
ডিলিটফুটার রিকোয়েস্ট