Method: projects.matchIntents

הפונקציה מוצאת את האובייקטים מסוג Intent שתואמים לשאילתה נתונה.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
project

string

חובה. הפרויקט שנבדק, מצוין באמצעות מזהה הפרויקט. פורמט: פרויקטים/{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)

אובייקטים מסוג 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

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