Method: projects.matchIntents

يبحث عن الأغراض التي تتطابق مع طلب بحث معيّن.

طلب 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

مطلوب. اسم آخر غرض مطابق.
params

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

مطلوب. تمثل المَعلمات المحدَّدة كجزء من مطابقة النية. هذه خريطة لاسم المَعلمة المحدّدة بقيمة المَعلمة المحدّدة من إدخال المستخدم. ستظهر هنا جميع المَعلمات المحدّدة في الغرض المطابق والمحدد.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
query

string

اختياريّ. الإدخال المكتوب أو المنطوق من المستخدم النهائي الذي يطابق هذا الهدف ستتم تعبئة هذا الحقل عند مطابقة هدف، استنادًا إلى إدخال المستخدم.