Method: documents.searchDocumentChunks

গুগলের ডেভেলপার ডকুমেন্টেশন জুড়ে ডেভেলপার জ্ঞান অনুসন্ধান করে। ব্যবহারকারীর কোয়েরির উপর ভিত্তি করে DocumentChunk রিটার্ন করে। একই Document থেকে একাধিক চাঙ্ক থাকতে পারে। সম্পূর্ণ ডকুমেন্ট পুনরুদ্ধার করতে, SearchDocumentChunksResponse.results এ রিটার্ন করা DocumentChunk.parent সহ DeveloperKnowledge.GetDocument অথবা DeveloperKnowledge.BatchGetDocuments ব্যবহার করুন।

HTTP অনুরোধ

GET https://developerknowledge.googleapis.com/v1alpha/documents:searchDocumentChunks

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

কোয়েরি প্যারামিটার

প্যারামিটার
query

string

আবশ্যক। ব্যবহারকারীর দেওয়া মূল কোয়েরি স্ট্রিংটি এখানে দিতে হবে, যেমন "How to create a Cloud Storage bucket?"। কোয়েরিটি অবশ্যই ৫০০ অক্ষরের বেশি হবে না; ৫০০ অক্ষরের চেয়ে দীর্ঘ মান ব্যবহার করলে INVALID_ARGUMENT ত্রুটি দেখা দেবে।

pageSize

integer

ঐচ্ছিক। ফেরত দেওয়া ফলাফলের সর্বোচ্চ সংখ্যা নির্দিষ্ট করে। পরিষেবাটি এই মানের চেয়ে কম ফলাফলও ফেরত দিতে পারে।

অনির্দিষ্ট থাকলে, সর্বাধিক ৫টি ফলাফল ফেরত দেওয়া হবে।

সর্বোচ্চ মান হলো ১০০; ১০০-এর উপরের মানগুলোকে ১০০-তে রূপান্তরিত করা হবে।

pageToken

string

ঐচ্ছিক। এতে একটি পেজ টোকেন থাকে, যা পূর্ববর্তী documents.searchDocumentChunks কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন।

filter

string

ঐচ্ছিক। অনুসন্ধানের ফলাফলের উপর একটি কঠোর ফিল্টার প্রয়োগ করে। এই এক্সপ্রেশনটি https://google.aip.dev/160 -এ বর্ণিত সিনট্যাক্সের একটি উপসেট সমর্থন করে।

যদিও documents.searchDocumentChunks DocumentChunk রিটার্ন করে, ফিল্টারটি DocumentChunk.document ফিল্ডগুলিতে প্রয়োগ করা হয়।

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

  • contentLengthBytes (পূর্ণসংখ্যা): Document.content ফিল্ডের দৈর্ঘ্য, যা বাইটে পরিমাপ করা হয়।
  • dataSource (স্ট্রিং): ডকুমেন্টটির উৎস, যেমন docs.cloud.google.com । কর্পাসের ডেটা উৎসগুলোর সম্পূর্ণ তালিকার জন্য https://developers.google.com/knowledge/reference/corpus-reference দেখুন।
  • updateTime (টাইমস্ট্যাম্প): ডকুমেন্টটি সর্বশেষ কখন অর্থপূর্ণভাবে আপডেট করা হয়েছিল তার টাইমস্ট্যাম্প। একটি অর্থপূর্ণ আপডেট হলো এমন একটি আপডেট যা ডকুমেন্টের মার্কডাউন কন্টেন্ট বা মেটাডেটা পরিবর্তন করে।
  • uri (স্ট্রিং): ডকুমেন্ট URI, যেমন https://docs.cloud.google.com/bigquery/docs/tables ।

INTEGER ফিল্ডে = , < , <= , > , এবং >= অপারেটরগুলো সমর্থিত।

STRING ফিল্ডগুলো সম্পূর্ণ স্ট্রিংয়ের সঠিক মিলের জন্য = (সমান) এবং != (অসমান) অপারেটর সমর্থন করে। আংশিক মিল, প্রিফিক্স মিল এবং রেজেক্সপ মিল সমর্থিত নয়।

TIMESTAMP ফিল্ডে = , < , <= , > , এবং >= অপারেটরগুলো সমর্থিত। টাইমস্ট্যাম্প অবশ্যই RFC-3339 ফরম্যাটে হতে হবে, যেমন, "2025-01-01T00:00:00Z" ।

দ্রষ্টব্য: ফিল্ডের নাম অবশ্যই snake_case হতে হবে (যেমন, dataSource )। ফিল্টারিং এক্সপ্রেশনের ডানদিকের মান অবশ্যই ডাবল কোটেশনের মধ্যে থাকা স্ট্রিং লিটারেল হতে হবে (যেমন, "docs.cloud.google.com" )।

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

উদাহরণ:

  • Document.content_length_bytes দ্বারা ফিল্টার করুন : contentLengthBytes < 50000
  • dataSource = "docs.cloud.google.com" OR dataSource = "firebase.google.com"
  • dataSource != "firebase.google.com"
  • updateTime < "2024-01-01T00:00:00Z"
  • updateTime >= "2025-01-22T00:00:00Z" AND (dataSource = "developer.chrome.com" OR dataSource = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

filter স্ট্রিং অবশ্যই ৫০০ অক্ষরের বেশি হবে না; ৫০০ অক্ষরের চেয়ে দীর্ঘ মানের ফলে INVALID_ARGUMENT ত্রুটি দেখা দেবে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

DeveloperKnowledge.SearchDocumentChunks এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
results[]

object ( DocumentChunk )

প্রদত্ত কোয়েরির জন্য অনুসন্ধানের ফলাফল এখানে রয়েছে। এই তালিকার প্রতিটি DocumentChunk এ অনুসন্ধান কোয়েরির সাথে প্রাসঙ্গিক বিষয়বস্তুর একটি অংশ থাকে। সম্পূর্ণ ডকুমেন্টের বিষয়বস্তু পেতে DeveloperKnowledge.GetDocument অথবা DeveloperKnowledge.BatchGetDocuments এর সাথে প্রতিটি ফলাফলের DocumentChunk.parent ফিল্ডটি ব্যবহার করুন।

nextPageToken

string

একটি টোকেন প্রদান করে যা পরবর্তী পৃষ্ঠা আনার জন্য pageToken হিসেবে পাঠানো যেতে পারে। এই ক্ষেত্রটি পূরণ না করা হলে, পরবর্তী কোনো পৃষ্ঠা থাকবে না।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/developerprofiles.readonly
  • https://www.googleapis.com/auth/cloud-platform

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .