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 مطابقت داده می شود، پر می شود.