للعثور على الأغراض التي تتطابق مع طلب بحث معيّن.
طلب 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[] |
الأهداف مطابقة، مرتّبة من الأكثر صلة إلى الأقل صلة. يتم عرض أول 50 تطابقًا فقط. |
النيّة بالشراء
يمثل هدفًا.
تمثيل JSON | |
---|---|
{
"name": string,
"params": {
string: {
object ( |
الحقول | |
---|---|
name |
مطلوبة. اسم آخر هدف مطابق. |
params |
مطلوبة. تمثّل المَعلمات التي تم تحديدها كجزء من مطابقة الهدف. هذه خريطة لاسم المَعلمة المحدّدة بقيمة المَعلمة المحدّدة من البيانات التي أدخلها المستخدم. ستُعرَض هنا جميع المَعلمات المحدّدة في الغرض المطابق والمحدّدة. عنصر يحتوي على قائمة من أزواج |
query |
اختياريّ. الإدخال المكتوب أو الشفهي من المستخدم النهائي الذي طابق هذا الهدف. وستتم تعبئة هذه البيانات عند مطابقة هدف، استنادًا إلى البيانات التي أدخلها المستخدم. |