নথি অনুসন্ধান ও পুনরুদ্ধার করুন

এই নির্দেশিকায় ডেভেলপার নলেজ এপিআই-এর ফাংশনগুলো ব্যবহারের উদাহরণ দেওয়া হয়েছে: যেমন—ডকুমেন্ট অনুসন্ধান করা, একটিমাত্র ডকুমেন্ট পুনরুদ্ধার করা এবং একসাথে একাধিক ডকুমেন্ট পুনরুদ্ধার করা।

শুরু করার আগে, নিশ্চিত করুন যে আপনি API সক্রিয় করেছেন এবং একটি ডেভেলপার নলেজ API কী তৈরি করেছেন , এবং আপনার কী-টি একটি এনভায়রনমেন্ট ভেরিয়েবলে সংরক্ষণ করুন:

export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"

SearchDocumentChunks ব্যবহার করে নথি অনুসন্ধান করুন

একটি কোয়েরি স্ট্রিং-এর সাথে মেলে এমন ডকুমেন্ট চাঙ্কগুলি খুঁজে বের করতে documents.searchDocumentChunks মেথডটি ব্যবহার করুন। ফলাফলে ডকুমেন্টটির কন্টেন্টের চাঙ্ক এবং একটি parent রেফারেন্স অন্তর্ভুক্ত থাকে, যা ব্যবহার করে আপনি ডকুমেন্টটির সম্পূর্ণ কন্টেন্ট পুনরুদ্ধার করতে পারবেন।

নিম্নলিখিত উদাহরণটি 'BigQuery'-এর সাথে মেলে এমন ডকুমেন্ট অনুসন্ধান করে:

curl "https://developerknowledge.googleapis.com/v1/documents:searchDocumentChunks?query=BigQuery&key=$DEVELOPERKNOWLEDGE_API_KEY"

আপনি pageSize এর মতো প্যারামিটার ব্যবহার করে প্রতি পৃষ্ঠায় ফলাফলের সংখ্যা সীমিত করতে এবং pageToken ব্যবহার করে পরবর্তী পৃষ্ঠাগুলো পাওয়ার মাধ্যমে অনুসন্ধানের ফলাফলকে আরও পরিমার্জন করতে পারেন।

অনুসন্ধানের ফলাফল ফিল্টার করুন

অনুসন্ধানের ফলাফলে কঠোর ফিল্টার প্রয়োগ করতে filter প্যারামিটারটি ব্যবহার করুন। এই ফিল্টারটি অনুসন্ধানের ফলাফলের অংশগুলোর সাথে যুক্ত ডকুমেন্টগুলোর মেটাডেটার উপর প্রয়োগ করা হয়।

ফিল্টার করার জন্য সমর্থিত ক্ষেত্রসমূহ:

  • data_source ( STRING ): ডকুমেন্টটির উৎস, উদাহরণস্বরূপ, docs.cloud.google.com ।
  • update_time ( TIMESTAMP ): ডকুমেন্টটি সর্বশেষ কখন আপডেট করা হয়েছিল তার টাইমস্ট্যাম্প।
  • uri ( STRING ): ডকুমেন্ট URI, যেমন, https://docs.cloud.google.com/bigquery/docs/tables ।

সমর্থিত অপারেটর:

  • STRING ফিল্ডগুলো সম্পূর্ণ স্ট্রিং জুড়ে হুবহু মিল খুঁজে বের করার জন্য = (সমান) এবং != (অসমান) চিহ্ন সমর্থন করে।
  • TIMESTAMP ফিল্ডে = , < , <= , > , এবং >= সমর্থিত। টাইমস্ট্যাম্প অবশ্যই RFC-3339 ফরম্যাটে হতে হবে (যেমন, "2025-01-01T00:00:00Z" )।

আপনি AND , OR , এবং NOT (বা - ) লজিক্যাল অপারেটর ব্যবহার করে এক্সপ্রেশন একত্রিত করতে পারেন। মনে রাখবেন যে AND এর চেয়ে OR অগ্রাধিকার বেশি।

নিম্নলিখিত উদাহরণটি 'BigQuery'-এর সাথে মেলে এমন নথি অনুসন্ধান করে এবং ফলাফলকে docs.cloud.google.com থেকে প্রাপ্ত নথিতে সীমাবদ্ধ করে:

curl "https://developerknowledge.googleapis.com/v1/documents:searchDocumentChunks?query=BigQuery&filter=data_source%3D%22docs.cloud.google.com%22&key=$DEVELOPERKNOWLEDGE_API_KEY"

GetDocument ব্যবহার করে একটি ডকুমেন্ট পুনরুদ্ধার করুন

কোনো একটি ডকুমেন্টের সম্পূর্ণ বিষয়বস্তু পেতে documents.get মেথডটি ব্যবহার করুন।

নিম্নলিখিত উদাহরণটি documents/DOCUMENT_ID নামের একটি ডকুমেন্ট পুনরুদ্ধার করে:

curl "https://developerknowledge.googleapis.com/v1/documents:get?name=documents/DOCUMENT_ID&key=$DEVELOPERKNOWLEDGE_API_KEY"

প্রতিক্রিয়াটি হলো content ফিল্ড সহ সম্পূর্ণ Document রিসোর্স।

BatchGetDocuments ব্যবহার করে একাধিক ডকুমেন্ট পুনরুদ্ধার করুন

একটিমাত্র এপিআই কলে নাম দিয়ে সর্বোচ্চ ১০০টি ডকুমেন্ট পাওয়ার জন্য documents.batchGet মেথডটি ব্যবহার করুন। একাধিক GetDocument রিকোয়েস্ট পাঠানোর চেয়ে এটি বেশি কার্যকর।

নিম্নলিখিত উদাহরণটি নাম অনুসারে দুটি ডকুমেন্ট পুনরুদ্ধার করে:

curl "https://developerknowledge.googleapis.com/v1/documents:batchGet?names=documents/DOCUMENT_ID_1&names=documents/DOCUMENT_ID_2&key=$DEVELOPERKNOWLEDGE_API_KEY"

প্রতিক্রিয়াটিতে অনুরোধকৃত Document রিসোর্সগুলোর একটি তালিকা রয়েছে।