הפונקציה מוצאת את האובייקטים מסוג Intent שתואמים לשאילתה נתונה.
בקשת HTTP
POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
project |
חובה. הפרויקט שנבדק, מצוין באמצעות מזהה הפרויקט. פורמט: פרויקטים/{project} |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON | |
---|---|
{ "query": string, "locale": string } |
שדות | |
---|---|
query |
חובה. שאילתת משתמש כטקסט פשוט. |
locale |
חובה. הלוקאל שישמש להערכת השאילתה, למשל 'en'. הפורמט צריך להיות תואם ל-BCP 47: https://tools.ietf.org/html/bcp47. רשימת השפות הנתמכות זמינה בכתובת https://developers.google.com/assistant/console/languages-locales |
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
תשובה על מציאת כוונות תואמות.
ייצוג JSON | |
---|---|
{
"matchedIntents": [
{
object ( |
שדות | |
---|---|
matchedIntents[] |
אובייקטים מסוג Intent תואמים, מסודרים מהנמוך לרלוונטי. רק 50 ההתאמות הראשונות מוחזרות. |
כוונת רכישה
מייצג כוונה.
ייצוג JSON | |
---|---|
{
"name": string,
"params": {
string: {
object ( |
שדות | |
---|---|
name |
חובה. השם של אובייקט ה-Intent האחרון התואם. |
params |
חובה. מייצג פרמטרים שזוהו במסגרת התאמת Intent. זוהי מפה של שם הפרמטר שזוהה לערך של הפרמטר שזוהה בקלט של המשתמש. כל הפרמטרים שהוגדרו ב-Intent המותאם ושזוהו יוצגו כאן. אובייקט שמכיל רשימה של |
query |
אפשרות. קלט מוקלד או מדובר ממשתמש הקצה שתאם לכוונה הזו. השדה הזה יאוכלס כשיש התאמה ל-Intent, על סמך הקלט של המשתמש. |