Method: projects.matchIntents

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

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

الأهداف مطابقة، مرتّبة من الأكثر صلة إلى الأقل صلة. يتم عرض أول 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

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