Method: projects.matchIntents

مقاصد منطبق با یک پرس و جو داده شده را پیدا می کند.

درخواست HTTP

POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
project

string

مورد نیاز. پروژه در حال آزمایش، با شناسه پروژه نشان داده شده است. قالب: پروژه ها/{پروژه}

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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

اختیاری. ورودی تایپ شده یا گفتاری از کاربر نهایی که با این هدف مطابقت دارد. بر اساس ورودی کاربر، زمانی که یک intent مطابقت داده می شود، پر می شود.