Method: query.search

ক্লাউড অনুসন্ধান ক্যোয়ারী API সার্চ পদ্ধতি প্রদান করে, যা ব্যবহারকারীর ক্যোয়ারী থেকে সবচেয়ে প্রাসঙ্গিক ফলাফল প্রদান করে। ফলাফলগুলি Gmail বা Google Drive-এর মতো Google Workspace অ্যাপ থেকে আসতে পারে অথবা আপনি তৃতীয় পক্ষ থেকে ইন্ডেক্স করা ডেটা থেকে আসতে পারে।

দ্রষ্টব্য: এই API কার্যকর করার জন্য একটি আদর্শ ব্যবহারকারীর অ্যাকাউন্ট প্রয়োজন৷ একটি পরিষেবা অ্যাকাউন্ট সরাসরি ক্যোয়ারী API অনুরোধগুলি সম্পাদন করতে পারে না; কোয়েরি করার জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে, Google Workspace ডোমেন-ওয়াইড অথরিটি ডেলিগেশন সেট-আপ করুন।

HTTP অনুরোধ

POST https://cloudsearch.googleapis.com/v1/query/search

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

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "requestOptions": {
    object (RequestOptions)
  },
  "query": string,
  "pageSize": integer,
  "start": integer,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ],
  "facetOptions": [
    {
      object (FacetOptions)
    }
  ],
  "sortOptions": {
    object (SortOptions)
  },
  "queryInterpretationOptions": {
    object (QueryInterpretationOptions)
  },
  "contextAttributes": [
    {
      object (ContextAttribute)
    }
  ]
}
ক্ষেত্র
requestOptions

object ( RequestOptions )

অনুরোধের বিকল্পগুলি, যেমন অনুসন্ধান অ্যাপ্লিকেশন এবং ব্যবহারকারীর সময় অঞ্চল।

query

string

কাঁচা ক্যোয়ারী স্ট্রিং। সমর্থিত অনুসন্ধান অপারেটর দেখুন অপারেটরদের সাথে আপনার অনুসন্ধান সংকীর্ণ করুন৷

pageSize

integer

সর্বোচ্চ সংখ্যক সার্চ ফলাফল এক পৃষ্ঠায় ফিরতে হবে। বৈধ মান 1 থেকে 100 এর মধ্যে, অন্তর্ভুক্ত। ডিফল্ট মান হল 10। 2000-এর বেশি ফলাফলের অনুরোধ করা হলে সর্বনিম্ন মান 50।

start

integer

ফলাফলের সূচী শুরু।

dataSourceRestrictions[]

object ( DataSourceRestriction )

অনুসন্ধানের জন্য যে উৎসগুলি ব্যবহার করতে হবে৷ নির্দিষ্ট না থাকলে, বর্তমান অনুসন্ধান অ্যাপ্লিকেশন থেকে সমস্ত ডেটা উত্স ব্যবহার করা হয়৷

facetOptions[]

object ( FacetOptions )

sortOptions

object ( SortOptions )

অনুসন্ধান ফলাফল বাছাই জন্য বিকল্প

queryInterpretationOptions

object ( QueryInterpretationOptions )

ব্যবহারকারীর প্রশ্নের ব্যাখ্যা করার বিকল্প।

contextAttributes[]

object ( ContextAttribute )

অনুরোধের জন্য প্রসঙ্গ বৈশিষ্ট্য যা অনুসন্ধান ফলাফলের র‌্যাঙ্কিং সামঞ্জস্য করতে ব্যবহার করা হবে। উপাদানের সর্বাধিক সংখ্যা 10।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে SearchResponse এর একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

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

  • https://www.googleapis.com/auth/cloud_search.query
  • https://www.googleapis.com/auth/cloud_search

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।

,

ক্লাউড অনুসন্ধান ক্যোয়ারী API সার্চ পদ্ধতি প্রদান করে, যা ব্যবহারকারীর ক্যোয়ারী থেকে সবচেয়ে প্রাসঙ্গিক ফলাফল প্রদান করে। ফলাফলগুলি Gmail বা Google Drive-এর মতো Google Workspace অ্যাপ থেকে আসতে পারে অথবা আপনি তৃতীয় পক্ষ থেকে ইন্ডেক্স করা ডেটা থেকে আসতে পারে।

দ্রষ্টব্য: এই API কার্যকর করার জন্য একটি আদর্শ ব্যবহারকারীর অ্যাকাউন্ট প্রয়োজন৷ একটি পরিষেবা অ্যাকাউন্ট সরাসরি ক্যোয়ারী API অনুরোধগুলি সম্পাদন করতে পারে না; কোয়েরি করার জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে, Google Workspace ডোমেন-ওয়াইড অথরিটি ডেলিগেশন সেট-আপ করুন।

HTTP অনুরোধ

POST https://cloudsearch.googleapis.com/v1/query/search

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

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "requestOptions": {
    object (RequestOptions)
  },
  "query": string,
  "pageSize": integer,
  "start": integer,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ],
  "facetOptions": [
    {
      object (FacetOptions)
    }
  ],
  "sortOptions": {
    object (SortOptions)
  },
  "queryInterpretationOptions": {
    object (QueryInterpretationOptions)
  },
  "contextAttributes": [
    {
      object (ContextAttribute)
    }
  ]
}
ক্ষেত্র
requestOptions

object ( RequestOptions )

অনুরোধের বিকল্পগুলি, যেমন অনুসন্ধান অ্যাপ্লিকেশন এবং ব্যবহারকারীর সময় অঞ্চল।

query

string

কাঁচা ক্যোয়ারী স্ট্রিং। সমর্থিত অনুসন্ধান অপারেটর দেখুন অপারেটরদের সাথে আপনার অনুসন্ধান সংকীর্ণ করুন৷

pageSize

integer

সর্বোচ্চ সংখ্যক সার্চ ফলাফল এক পৃষ্ঠায় ফিরতে হবে। বৈধ মান 1 থেকে 100 এর মধ্যে, অন্তর্ভুক্ত। ডিফল্ট মান হল 10। 2000-এর বেশি ফলাফলের অনুরোধ করা হলে সর্বনিম্ন মান 50।

start

integer

ফলাফলের সূচী শুরু।

dataSourceRestrictions[]

object ( DataSourceRestriction )

অনুসন্ধানের জন্য যে উৎসগুলি ব্যবহার করতে হবে৷ নির্দিষ্ট না থাকলে, বর্তমান অনুসন্ধান অ্যাপ্লিকেশন থেকে সমস্ত ডেটা উত্স ব্যবহার করা হয়৷

facetOptions[]

object ( FacetOptions )

sortOptions

object ( SortOptions )

অনুসন্ধান ফলাফল বাছাই জন্য বিকল্প

queryInterpretationOptions

object ( QueryInterpretationOptions )

ব্যবহারকারীর প্রশ্নের ব্যাখ্যা করার বিকল্প।

contextAttributes[]

object ( ContextAttribute )

অনুরোধের জন্য প্রসঙ্গ বৈশিষ্ট্য যা অনুসন্ধান ফলাফলের র‌্যাঙ্কিং সামঞ্জস্য করতে ব্যবহার করা হবে। উপাদানের সর্বাধিক সংখ্যা 10।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে SearchResponse এর একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

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

  • https://www.googleapis.com/auth/cloud_search.query
  • https://www.googleapis.com/auth/cloud_search

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।