会話型アクションのサポートは 2023 年 6 月 13 日に終了しました。詳細については、
会話型アクションの廃止をご覧ください。
Method: projects.matchIntents
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
HTTP リクエスト
POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
project |
string
必須。プロジェクト ID で指定される、テスト対象のプロジェクト。形式: 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
省略可。このインテントに一致したエンドユーザーの入力または音声入力。ユーザー入力に基づいてインテントが一致すると入力されます。
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 UTC。"],[[["\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. |"]]