Method: projects.matchIntents

Belirli bir sorguyla eşleşen amaçları bulur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
project

string

Zorunlu. Proje Kimliği ile belirtilen, test edilmekte olan proje. Biçim: projeler/{project}

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi
{
  "query": string,
  "locale": string
}
Alanlar
query

string

Zorunlu. Düz metin olarak kullanıcı sorgusu.

locale

string

Zorunlu. Sorguyu değerlendirmek için kullanılacak yerel ayar (ör. "en"). Biçim, BCP 47'ye uygun olmalıdır: https://tools.ietf.org/html/bcp47 Desteklenen dillerin listesini https://developers.google.com/assistant/console/languages-locales sayfasında bulabilirsiniz.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Eşleşen amaçları bulma yanıtı.

JSON gösterimi
{
  "matchedIntents": [
    {
      object (Intent)
    }
  ]
}
Alanlar
matchedIntents[]

object (Intent)

Eşleşen amaçlar, alaka düzeyi en yüksekten en az alakalıya doğru sıralanır. Yalnızca ilk 50 eşleşme döndürülür.

Amaç

Bir amacı temsil eder.

JSON gösterimi
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
Alanlar
name

string

Zorunlu. Son eşleşen amacın adı.

params

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

Zorunlu. Amaç eşleştirmenin bir parçası olarak tanımlanan parametreleri temsil eder. Burada, tanımlanan parametre adı ile kullanıcı girişinden tanımlanan parametre değeri karşılaştırılır. Eşleşen amaçta tanımlanan ve tanımlanan tüm parametreler burada gösterilir.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

query

string

İsteğe bağlı. Bu amaçla eşleşen son kullanıcının yazdığı veya sözlü girişi. Bu alan, bir amaç eşleştirildiğinde kullanıcı girişine göre doldurulur.