تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
Method: projects.matchIntents
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يبحث عن الأغراض التي تتطابق مع طلب بحث معيّن.
طلب HTTP
POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
project |
string
مطلوب. المشروع الذي يتم اختباره، ويُشار إليه برقم تعريف المشروع. التنسيق: projects/{project}
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"query": string,
"locale": string
} |
| الحقول |
query |
string
مطلوب. طلب بحث المستخدم كنص عادي
|
locale |
string
مطلوب. اللغة المطلوب استخدامها لتقييم طلب البحث، مثل "en". يجب أن يتّبع التنسيق BCP 47: https://tools.ietf.org/html/bcp47. يمكنك الاطّلاع على قائمة اللغات المتاحة على الرابط https://developers.google.com/assistant/console/languages-locales.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثّل هذه السمة الاستجابة للعثور على نوايا مطابقة.
| تمثيل JSON |
{
"matchedIntents": [
{
object (Intent)
}
]
} |
| الحقول |
matchedIntents[] |
object (Intent)
تمت مطابقة الأهداف، مرتبة من الأكثر صلة إلى الأقل صلة بالموضوع. يتم عرض أول 50 مطابقة فقط.
|
النيّة بالشراء
| تمثيل JSON |
{
"name": string,
"params": {
string: {
object (IntentParameterValue)
},
...
},
"query": string
} |
| الحقول |
name |
string
مطلوب. اسم آخر غرض مطابق.
|
params |
map (key: string, value: object (IntentParameterValue))
مطلوب. تمثل المَعلمات المحدَّدة كجزء من مطابقة النية. هذه خريطة لاسم المَعلمة المحدّدة بقيمة المَعلمة المحدّدة من إدخال المستخدم. ستظهر هنا جميع المَعلمات المحدّدة في الغرض المطابق والمحدد. عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
|
query |
string
اختياريّ. الإدخال المكتوب أو المنطوق من المستخدم النهائي الذي يطابق هذا الهدف ستتم تعبئة هذا الحقل عند مطابقة هدف، استنادًا إلى إدخال المستخدم.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eFinds the intents that match a given user query, returning the top 50 matches ranked by relevance.\u003c/p\u003e\n"],["\u003cp\u003eRequires a \u003ccode\u003ePOST\u003c/code\u003e request to the specified endpoint, including the project ID and user query.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain the user query as plain text and the locale for evaluation.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of matched intents, each with its name, parameters, and the original query.\u003c/p\u003e\n"],["\u003cp\u003eEach intent object provides details like the intent name, identified parameters, and the portion of the user input that triggered the match.\u003c/p\u003e\n"]]],["This document details the process of matching user queries to intents via a `POST` request to `https://actions.googleapis.com/v2/{project=projects/*}:matchIntents`. The request requires a `project` path parameter, a JSON body with `query` and `locale` strings. The response returns a JSON object with `matchedIntents`, an array of matched intents, each with `name`, `params` (parameter name-value pairs), and `query` fields. Only the first 50 matching intents are returned, ordered from most to least relevant.\n"],null,["# Method: projects.matchIntents\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.MatchIntentsResponse.SCHEMA_REPRESENTATION)\n- [Intent](#Intent)\n - [JSON representation](#Intent.SCHEMA_REPRESENTATION)\n\nFinds the intents that match a given query.\n\n### HTTP request\n\n`POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|------------------------------------------------------------------------------------------------------|\n| `project` | `string` Required. The project being tested, indicated by the Project ID. Format: projects/{project} |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-----------------------------------------------|---|\n| ``` { \"query\": string, \"locale\": string } ``` |\n\n| Fields ||\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `query` | `string` Required. User query as plain text. |\n| `locale` | `string` Required. Locale to use to evaluate the query, such as \"en\". The format should follow BCP 47: \u003chttps://tools.ietf.org/html/bcp47\u003e See the list of supported languages in \u003chttps://developers.google.com/assistant/console/languages-locales\u003e |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse for finding matching intents.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"matchedIntents\": [ { object (/assistant/actions/api/reference/rest/v2/projects/matchIntents#Intent) } ] } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `matchedIntents[]` | `object (`[Intent](/assistant/actions/api/reference/rest/v2/projects/matchIntents#Intent)`)` Intents matched, ordered from most to least relevant. Only the first 50 matches are returned. |\n\nIntent\n------\n\nRepresents an intent.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"params\": { string: { object (/assistant/actions/api/reference/rest/v2/IntentParameterValue) }, ... }, \"query\": string } ``` |\n\n| Fields ||\n|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the last matched intent. |\n| `params` | `map (key: string, value: object (`[IntentParameterValue](/assistant/actions/api/reference/rest/v2/IntentParameterValue)`))` Required. Represents parameters identified as part of intent matching. This is a map of the name of the identified parameter to the value of the parameter identified from user input. All parameters defined in the matched intent that are identified will be surfaced here. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `query` | `string` Optional. Typed or spoken input from the end user that matched this intent. This will be populated when an intent is matched, based on the user input. |"]]
