ক্লাউড অনুসন্ধান ক্যোয়ারী 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 | কাঁচা ক্যোয়ারী স্ট্রিং। সমর্থিত অনুসন্ধান অপারেটর দেখুন অপারেটরদের সাথে আপনার অনুসন্ধান সংকীর্ণ করুন৷ |
pageSize | সর্বোচ্চ সংখ্যক সার্চ ফলাফল এক পৃষ্ঠায় ফিরতে হবে। বৈধ মান 1 থেকে 100 এর মধ্যে, অন্তর্ভুক্ত। ডিফল্ট মান হল 10। 2000-এর বেশি ফলাফলের অনুরোধ করা হলে সর্বনিম্ন মান 50। |
start | ফলাফলের সূচী শুরু। |
dataSourceRestrictions[] | অনুসন্ধানের জন্য যে উৎসগুলি ব্যবহার করতে হবে৷ নির্দিষ্ট না থাকলে, বর্তমান অনুসন্ধান অ্যাপ্লিকেশন থেকে সমস্ত ডেটা উত্স ব্যবহার করা হয়৷ |
facetOptions[] | |
sortOptions | অনুসন্ধান ফলাফল বাছাই জন্য বিকল্প |
queryInterpretationOptions | ব্যবহারকারীর প্রশ্নের ব্যাখ্যা করার বিকল্প। |
contextAttributes[] | অনুরোধের জন্য প্রসঙ্গ বৈশিষ্ট্য যা অনুসন্ধান ফলাফলের র্যাঙ্কিং সামঞ্জস্য করতে ব্যবহার করা হবে। উপাদানের সর্বাধিক সংখ্যা 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 | কাঁচা ক্যোয়ারী স্ট্রিং। সমর্থিত অনুসন্ধান অপারেটর দেখুন অপারেটরদের সাথে আপনার অনুসন্ধান সংকীর্ণ করুন৷ |
pageSize | সর্বোচ্চ সংখ্যক সার্চ ফলাফল এক পৃষ্ঠায় ফিরতে হবে। বৈধ মান 1 থেকে 100 এর মধ্যে, অন্তর্ভুক্ত। ডিফল্ট মান হল 10। 2000-এর বেশি ফলাফলের অনুরোধ করা হলে সর্বনিম্ন মান 50। |
start | ফলাফলের সূচী শুরু। |
dataSourceRestrictions[] | অনুসন্ধানের জন্য যে উৎসগুলি ব্যবহার করতে হবে৷ নির্দিষ্ট না থাকলে, বর্তমান অনুসন্ধান অ্যাপ্লিকেশন থেকে সমস্ত ডেটা উত্স ব্যবহার করা হয়৷ |
facetOptions[] | |
sortOptions | অনুসন্ধান ফলাফল বাছাই জন্য বিকল্প |
queryInterpretationOptions | ব্যবহারকারীর প্রশ্নের ব্যাখ্যা করার বিকল্প। |
contextAttributes[] | অনুরোধের জন্য প্রসঙ্গ বৈশিষ্ট্য যা অনুসন্ধান ফলাফলের র্যাঙ্কিং সামঞ্জস্য করতে ব্যবহার করা হবে। উপাদানের সর্বাধিক সংখ্যা 10। |
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে SearchResponse
এর একটি উদাহরণ থাকে।
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/cloud_search.query
-
https://www.googleapis.com/auth/cloud_search
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।