Method: projects.matchIntents

הפונקציה מחפשת את ה-Intents שתואמים לשאילתה נתונה.

בקשת 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

חובה. השם של ה-Intent האחרון שנמצאה בו התאמה.
params

map (key: string, value: object (IntentParameterValue))

חובה. מייצג פרמטרים שזוהו כחלק מהתאמה של Intent. זו מפה של השם של הפרמטר שזוהה לערך של הפרמטר שזוהה מקלט של משתמשים. כאן יוצגו כל הפרמטרים שהוגדרו באובייקט ה-Intent התואם ושזוהו.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
query

string

זה שינוי אופציונלי. קלט שהוקלד או מוקרא ממשתמש הקצה, שהתאים לכוונה הזו. השדה הזה יאוכלס כאשר תהיה התאמה לכוונת רכישה, על סמך הקלט של המשתמשים.