Method: query.search
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন
আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।
ক্লাউড অনুসন্ধান ক্যোয়ারী API সার্চ পদ্ধতি প্রদান করে, যা ব্যবহারকারীর ক্যোয়ারী থেকে সবচেয়ে প্রাসঙ্গিক ফলাফল প্রদান করে। ফলাফলগুলি Gmail বা Google Drive-এর মতো Google Workspace অ্যাপ থেকে আসতে পারে অথবা আপনি তৃতীয় পক্ষ থেকে ইন্ডেক্স করা ডেটা থেকে আসতে পারে।
দ্রষ্টব্য: এই API কার্যকর করার জন্য একটি আদর্শ ব্যবহারকারীর অ্যাকাউন্ট প্রয়োজন৷ একটি পরিষেবা অ্যাকাউন্ট সরাসরি ক্যোয়ারী API অনুরোধগুলি সম্পাদন করতে পারে না; কোয়েরি করার জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে, Google Workspace ডোমেন-ওয়াইড অথরিটি ডেলিগেশন সেট-আপ করুন।
HTTP অনুরোধ
POST https://cloudsearch.googleapis.com/v1/query/search
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| ক্ষেত্র |
|---|
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 ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| ক্ষেত্র |
|---|
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
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।
অন্য কিছু উল্লেখ না করা থাকলে, এই পৃষ্ঠার কন্টেন্ট Creative Commons Attribution 4.0 License-এর অধীনে এবং কোডের নমুনাগুলি Apache 2.0 License-এর অধীনে লাইসেন্স প্রাপ্ত। আরও জানতে, Google Developers সাইট নীতি দেখুন। Java হল Oracle এবং/অথবা তার অ্যাফিলিয়েট সংস্থার রেজিস্টার্ড ট্রেডমার্ক।
2025-07-25 UTC-তে শেষবার আপডেট করা হয়েছে।
[null,null,["2025-07-25 UTC-তে শেষবার আপডেট করা হয়েছে।"],[],[],null,["# Method: query.search\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nThe Cloud Search query API provides the search method, which returns the most relevant results from a user query. The results can come from Google Workspace apps, such as Gmail or Google Drive, or they can come from data that you have indexed from a third party.\n\n**Note:** This API requires a standard end user account to execute. A service account can't perform query API requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of authority](https://developers.google.com/workspace/cloud-search/docs/guides/delegation/).\n\n### HTTP request\n\n`POST https://cloudsearch.googleapis.com/v1/query/search`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requestOptions\": { object (/workspace/cloud-search/docs/reference/rest/v1/RequestOptions) }, \"query\": string, \"pageSize\": integer, \"start\": integer, \"dataSourceRestrictions\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/settings.searchapplications#DataSourceRestriction) } ], \"facetOptions\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/settings.searchapplications#FacetOptions) } ], \"sortOptions\": { object (/workspace/cloud-search/docs/reference/rest/v1/settings.searchapplications#SortOptions) }, \"queryInterpretationOptions\": { object (/workspace/cloud-search/docs/reference/rest/v1/QueryInterpretationOptions) }, \"contextAttributes\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#ContextAttribute) } ] } ``` |\n\n| Fields ||\n|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestOptions` | `object (`[RequestOptions](/workspace/cloud-search/docs/reference/rest/v1/RequestOptions)`)` Request options, such as the search application and user timezone. |\n| `query` | `string` The raw query string. See supported search operators in the [Narrow your search with operators](https://support.google.com/cloudsearch/answer/6172299) |\n| `pageSize` | `integer` Maximum number of search results to return in one page. Valid values are between 1 and 100, inclusive. Default value is 10. Minimum value is 50 when results beyond 2000 are requested. |\n| `start` | `integer` Starting index of the results. |\n| `dataSourceRestrictions[]` | `object (`[DataSourceRestriction](/workspace/cloud-search/docs/reference/rest/v1/settings.searchapplications#DataSourceRestriction)`)` The sources to use for querying. If not specified, all data sources from the current search application are used. |\n| `facetOptions[]` | `object (`[FacetOptions](/workspace/cloud-search/docs/reference/rest/v1/settings.searchapplications#FacetOptions)`)` |\n| `sortOptions` | `object (`[SortOptions](/workspace/cloud-search/docs/reference/rest/v1/settings.searchapplications#SortOptions)`)` The options for sorting the search results |\n| `queryInterpretationOptions` | `object (`[QueryInterpretationOptions](/workspace/cloud-search/docs/reference/rest/v1/QueryInterpretationOptions)`)` options to interpret the user query. |\n| `contextAttributes[]` | `object (`[ContextAttribute](/workspace/cloud-search/docs/reference/rest/v1/indexing.datasources.items#ContextAttribute)`)` Context attributes for the request which will be used to adjust ranking of search results. The maximum number of elements is 10. |\n\n### Response body\n\nIf successful, the response body contains an instance of [SearchResponse](/workspace/cloud-search/docs/reference/rest/v1/SearchResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.query`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
