- StaticPromptCandidate
- Seçici
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- Varyant
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt
- CollectionItem
- Öneri
- StaticCanvasPrompt
İstem adaylarının listesini temsil eder. Bu istemlerden biri, kullanıcıya yanıtta gösterilecek istem olarak seçilir. Bu mesaj yerelleştirilebilir.
JSON gösterimi | |
---|---|
{
"candidates": [
{
object ( |
Alanlar | |
---|---|
candidates[] |
Müşteriye gönderilecek aday istemlerinin listesi. Her istemin ne zaman kullanılabileceğini belirleyen bir seçici vardır. Bir istekle eşleşen ilk seçici gönderilir ve geri kalanlar yoksayılır. |
StaticPromptCandidate
Statik bir istem adayını temsil eder.
JSON gösterimi | |
---|---|
{ "selector": { object ( |
Alanlar | |
---|---|
selector |
İsteğe bağlı. Bu istemin bir istekle eşleşip eşleşmediğine ilişkin ölçütler. Seçici boşsa bu istem her zaman tetiklenir. |
promptResponse |
Seçiciyle ilişkili istem yanıtı. |
Seçici
Bir istemin istekle eşleşip eşleşmediğine ilişkin ölçütleri tanımlar.
JSON gösterimi | |
---|---|
{
"surfaceCapabilities": {
object ( |
Alanlar | |
---|---|
surfaceCapabilities |
Gerekli yüzey özellikleri grubu. |
SurfaceCapabilities
Kullanıcının Action'a istekte bulunmak için kullandığı yüzeyi temsil eder.
JSON gösterimi | |
---|---|
{
"capabilities": [
enum ( |
Alanlar | |
---|---|
capabilities[] |
Zorunlu. Yüzeyin İşlem için istekte bulunan özellikleri. |
StaticPromptResponse
Kullanıcıya gönderilecek yapılandırılmış yanıtları (ör. metin, konuşma, kart, tuval verileri, öneri çipi) temsil eder.
JSON gösterimi | |
---|---|
{ "firstSimple": { object ( |
Alanlar | |
---|---|
firstSimple |
İsteğe bağlı. İlk sesli ve yalnızca metin yanıt. |
content |
İsteğe bağlı. Kullanıcıya gösterilecek kart, liste veya medya gibi bir içerik. |
lastSimple |
İsteğe bağlı. Son sesli ve yalnızca metin yanıt. |
suggestions[] |
İsteğe bağlı. Kullanıcıya gösterilecek öneriler. Bunlar, her zaman yanıtın sonunda gösterilir. "Ekle" ise içeren istemdeki alanın "true" değeri Bu alanda tanımlanan başlıklar, önceden tanımlanmış öneri istemlerinde tanımlanan başlıklara eklenir ve yinelenen değerler kaldırılır. |
link |
İsteğe bağlı. İlişkili uygulama veya siteye bağlantı verebilecek ek bir öneri çipi. Çip, "Aç |
override |
İsteğe bağlı. Bu iletilerin önceden tanımlanmış iletilerle birleştirilme şekli. "true" (doğru) önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneri bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "yanlış" bu istemde tanımlanan iletileri önceki yanıtlarda tanımlanan iletilere ekler. Bu alanın "false" olarak ayarlanması Basit istemler, Öneriler istemi ve Canvas istemindeki (İçerik isteminin bir parçası) bazı alanlara ekleme özelliğini de etkinleştirir. İstemde tanımlanırsa İçerik ve Bağlantı iletilerinin üzerine her zaman yazılır. Varsayılan değer "false"tur. |
canvas |
Etkileşimli tuval deneyimi için kullanılacak yanıt. |
StaticSimplePrompt
Kullanıcıya gönderilmesi için basit bir istemi temsil eder.
JSON gösterimi | |
---|---|
{
"variants": [
{
object ( |
Alanlar | |
---|---|
variants[] |
Olası varyantların listesi. |
Varyant
Basit istemin parçası olan bir varyantı temsil eder.
JSON gösterimi | |
---|---|
{ "speech": string, "text": string } |
Alanlar | |
---|---|
speech |
İsteğe bağlı. Kullanıcıya söylenecek konuşmayı temsil eder. SSML veya metin okuma olabilir. "Ekle" ise içeren istemdeki alanın "true" değeri bu alanda tanımlanan konuşma, önceki Basit istemin konuşmasına eklenir. |
text |
İsteğe bağlı. Sohbet balonunda gösterilecek metin. Belirtilmezse yukarıdaki konuşma alanının görüntülemesi kullanılır. Uzunluk sınırı 640 karakterdir. "Ekle" ise içeren istemdeki alanın "true" değeri bu alanda tanımlanan metin, önceki Basit istemin metnine eklenir. |
StaticContentPrompt
StaticPrompt'un Content (İçerik) bölümü için yer tutucu.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birleştirme alanı content . Bir istemde yalnızca bir içerik türü bulunabilir. content şunlardan yalnızca biri olabilir: |
||
card |
Temel kart. |
|
image |
Bir resim. |
|
table |
Tablo kartı. |
|
media |
Oynatılacak bir grup medyayı gösteren yanıt. |
|
list |
Seçebileceğiniz seçeneklerin listesini sunan bir kart. |
|
collection |
Seçebileceğiniz seçeneklerin listesini sunan bir kart. |
StaticCardPrompt
Bazı bilgileri görüntülemek için kullanılan temel kart, ör. bir resim ve/veya metin.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Kartın genel başlığı. |
subtitle |
İsteğe bağlı. Kartın alt başlığı. |
text |
Zorunlu. Resim mevcut değilse kartın gövde metni. Biçimlendirme için sınırlı bir Markdown söz dizimi grubunu destekler. |
image |
İsteğe bağlı. Kart için hero resim. Yükseklik 192 dp olarak sabitlendi. |
imageFill |
İsteğe bağlı. Resim arka planının nasıl doldurulacağı. |
button |
İsteğe bağlı. Kartta gösterilecek tıklanabilir bir düğme. |
StaticImagePrompt
Kartta bir resim gösteriliyor.
JSON gösterimi | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
Alanlar | |
---|---|
url |
Zorunlu. Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve animasyonsuz) olabilir. Örneğin, |
alt |
Zorunlu. Erişilebilirlik için kullanılacak resmin metin açıklaması, ör. Ekran okuyucular. |
height |
İsteğe bağlı. Resmin piksel cinsinden yüksekliği. |
width |
İsteğe bağlı. Resmin piksel cinsinden genişliği. |
StaticLinkPrompt
Öneri çipi olarak gösterilecek ve kullanıcı tarafından açılabilecek bir bağlantıyı tanımlar.
JSON gösterimi | |
---|---|
{
"name": string,
"open": {
object ( |
Alanlar | |
---|---|
name |
Bağlantının adı |
open |
Kullanıcının bağlantıyı açtığı andaki davranışı tanımlar. |
OpenUrl
Kullanıcının bağlantıyı açtığı andaki davranışı tanımlar.
JSON gösterimi | |
---|---|
{
"url": string,
"hint": enum ( |
Alanlar | |
---|---|
url |
Şunlardan herhangi biri olabilecek URL alanı: - Uygulamaya bağlı bir uygulamayı veya web sayfasını açmak için http/https urls |
hint |
URL türüyle ilgili bir ipucunu gösterir. |
StaticTablePrompt
Bir metin tablosunu gösteren tablo kartı.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Tablonun genel başlığı. Altyazı ayarlanmışsa ayarlanmalıdır. |
subtitle |
İsteğe bağlı. Tablonun alt başlığı. |
image |
İsteğe bağlı. Tabloyla ilişkilendirilen resim. |
columns[] |
İsteğe bağlı. Başlıklar ve sütunların hizalaması. |
rows[] |
İsteğe bağlı. Tablonun satır verileri. İlk 3 satırın gösterileceği garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzeyde hangi satırların gösterileceğini görmek için lütfen simülasyon aracıyla test edin. WEB_BROWSER özelliğini destekleyen yüzeylerde, kullanıcıyı daha fazla veri içeren bir web sayfasına yönlendirebilirsiniz. |
button |
İsteğe bağlı. Düğme. |
TableColumn
Tablodaki bir sütunu açıklar.
JSON gösterimi | |
---|---|
{
"header": string,
"align": enum ( |
Alanlar | |
---|---|
header |
Sütunun başlık metni. |
align |
İçerik sütunuyla yatay hizalama. Belirtilmemişse içerik ön kenarla hizalanır. |
TableRow
Tablodaki bir satırı açıklar.
JSON gösterimi | |
---|---|
{
"cells": [
{
object ( |
Alanlar | |
---|---|
cells[] |
Bu satırdaki hücreler. İlk 3 hücrenin gösterileceği garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi hücrelerin gösterileceğini görmek üzere lütfen simülasyon aracıyla test yapın. |
divider |
Her satırdan sonra bir ayırıcı olması gerekip gerekmediğini belirtir. |
TableCell
Bir satırdaki bir hücreyi açıklar.
JSON gösterimi | |
---|---|
{ "text": string } |
Alanlar | |
---|---|
text |
Hücrenin metin içeriği. |
StaticMediaPrompt
Medya hakkında ad, açıklama, URL vb. bilgiler içerir. Sonraki kimlik: 9
JSON gösterimi | |
---|---|
{ "mediaType": enum ( |
Alanlar | |
---|---|
mediaType |
Bu yanıtın medya türü. |
startOffset |
İlk medya nesnesinin başlangıç ofseti. En fazla dokuz kesirli basamağa sahip, " |
optionalMediaControls[] |
Bu medya yanıtı oturumunun destekleyebileceği isteğe bağlı medya kontrolü türleri. Ayarlanırsa belirli bir medya etkinliği gerçekleştiğinde 3. tarafa istek gönderilir. Ayarlanmazsa 3p yine de TAMAMLANDI ve BAŞARISIZ olmak üzere iki varsayılan kontrol türünü işlemelidir. |
mediaObjects[] |
Medya nesnelerinin listesi. |
MediaObject
Tek bir medya nesnesini temsil eder.
JSON gösterimi | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
Alanlar | |
---|---|
name |
Bu medya nesnesinin adı. |
description |
Bu medya nesnesinin açıklaması. |
url |
Medya içeriğini gösteren URL. |
image |
Medya kartıyla gösterilecek resim. |
MediaImage
MediaPrompt içinde gösterilecek resim.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birleştirme alanı image . Yalnızca bir MediaImage türüne izin verilir. image şunlardan yalnızca biri olabilir: |
||
large |
Albümün kapağı gibi büyük bir resim. |
|
icon |
Başlığın sağında küçük bir resim simgesi görüntülenir. 36x36 dp olarak yeniden boyutlandırıldı. |
StaticListPrompt
Seçebileceğiniz seçeneklerin listesini sunan bir kart.
JSON gösterimi | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Listenin başlığı. |
subtitle |
İsteğe bağlı. Listenin alt başlığı. |
items[] |
Zorunlu. Liste öğeleri. |
ListItem
Listedeki bir öğe.
JSON gösterimi | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili türdeki giriş anahtarıyla eşleşen NLU anahtarı. Öğeye dokunulduğunda, bu anahtar seçim seçeneği parametresi olarak geri yayınlanır. |
title |
Zorunlu. Öğenin başlığı. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, öğe grubu içinde benzersiz olmalıdır. |
description |
İsteğe bağlı. Öğenin gövde metni. |
image |
İsteğe bağlı. Öğe resmi. |
StaticCollectionPrompt
Aralarından seçim yapabileceğiniz bir dizi seçenek sunan bir kart.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Koleksiyonun başlığı. |
subtitle |
İsteğe bağlı. Koleksiyonun alt başlığı. |
items[] |
Zorunlu. Koleksiyon öğeleri'ne dokunun. |
imageFill |
İsteğe bağlı. Resim görüntüleme seçeneğinin türü. |
CollectionItem
Koleksiyondaki bir öğe.
JSON gösterimi | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili Türdeki giriş anahtarı adıyla eşleşen NLU anahtarı. Öğeye dokunulduğunda, bu anahtar seçim seçeneği parametresi olarak geri yayınlanır. |
title |
Zorunlu. Öğenin başlığı. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, öğe grubu içinde benzersiz olmalıdır. |
description |
İsteğe bağlı. Öğenin gövde metni. |
image |
İsteğe bağlı. Öğe resmi. |
Öneri
Kolaylık sağlamak amacıyla kullanıcıya gösterilen bir kullanıcı arayüzü öğesi olan öneri çipini temsil eder.
JSON gösterimi | |
---|---|
{ "title": string } |
Alanlar | |
---|---|
title |
Zorunlu. Öneri çipinde gösterilen metin. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, öneri çipi grubu içinde benzersiz olmalıdır. Maksimum 25 karakter |
StaticCanvasPrompt
Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. Bu, "firstSimple" ile birlikte kullanılabilir. kullanıcıyla konuşmak için istemdeki alana girin.
JSON gösterimi | |
---|---|
{ "url": string, "data": [ value ], "suppressMic": boolean } |
Alanlar | |
---|---|
url |
Zorunlu. Yüklenecek web görünümünün URL'si. |
data[] |
İsteğe bağlı. Tam sayfa deneyim web sayfasına etkinlik olarak aktarılacak JSON verileri. "Geçersiz kıl" içeren istemdeki alanın "false" olması Bu Canvas isteminde tanımlanan veri değerleri, önceki Canvas istemlerinde tanımlanan veri değerlerinden sonra eklenecek. |
suppressMic |
İsteğe bağlı. Doğru değeri, bu etkileyici yanıt kullanıcıya sunulduktan sonra giriş yakalamak için mikrofonun açılmayacağı anlamına gelir. |